すべてのプロダクト
Search
ドキュメントセンター

HTTPDNS:カスタム解析インターフェイス (非推奨)

最終更新日:Nov 09, 2025

はじめに

基本的な解析シナリオが要件を満たさない場合、このドキュメントのすべての API でカスタム解析を実行するには、カスタム解析関数を記述する必要があります。

カスタム解析のグローバルパラメーターを設定することで、各カスタムドメイン名解析リクエストの共通パラメーターを設定できます。

カスタム同期非ブロッキング解析インターフェイス

カスタム同期非ブロッキングインターフェイスを使用してドメイン名を解析しても、現在のスレッドはブロックされません。ただし、空の結果が返される場合があります。

このインターフェイスはキャッシュのみをクエリして結果を返します。キャッシュに結果が含まれていないか、キャッシュされた結果の有効期限が切れている場合、ワーカースレッドがドメイン名を解決します。その後、後続の呼び出しのために、キャッシュは新しい結果で更新されます。

getIpsByHostAsync

同期、非ブロッキング方式で IPv4 アドレスのカスタム解析を実行します。

インターフェイス定義

HTTPDNSResult getIpsByHostAsync(String host, Map<String,String> params, String cacheKey)

クラス

HttpDnsService

導入バージョン

1.3.0

非推奨バージョン

2.3.2

代替インターフェイス

HTTPDNSResult getHttpDnsResultForHostSyncNonBlocking(String host, RequestIpType requestIpType, Map<String, String> params, String cacheKey)

パラメーター

パラメーター

必須

説明

host

String

はい

解析するドメイン名。

params

Map<String, String>

はい

ドメイン名解決のための追加パラメーター。これらは、サーバー上のカスタム解析関数における event.parameters パラメーターに対応します。

cacheKey

String

はい

ドメイン名のローカルキャッシュキー。追加パラメーターの変更によりサーバーからの再解析が必要な場合は、cacheKey を変更します。

戻り値

説明

HTTPDNSResult

解析結果。

getHttpDnsResultForHostAsync

同期、非ブロッキング方式で IPv4 アドレスのカスタム解析を実行します。

インターフェイス定義

HTTPDNSResult getHttpDnsResultForHostAsync(String host, Map<String, String> params, String cacheKey);

クラス

HttpDnsService

導入バージョン

2.0.2

非推奨バージョン

2.4.0

代替インターフェイス

HTTPDNSResult getHttpDnsResultForHostSyncNonBlocking(String host, RequestIpType requestIpType, Map<String, String> params, String cacheKey)

パラメーター

パラメーター

必須

説明

host

String

はい

解析するドメイン名。

params

Map<String, String>

はい

ドメイン名解決のための追加パラメーター。これらは、サーバー上のカスタム解析関数における event.parameters パラメーターに対応します。

cacheKey

String

はい

ドメイン名のローカルキャッシュキー。追加パラメーターの変更によりサーバーからの再解析が必要な場合は、cacheKey を変更します。

戻り値

説明

HTTPDNSResult

解析結果。

getIpsByHostAsync

同期、非ブロッキング方式で、指定されたタイプの IP アドレスのカスタム解析を実行します。

インターフェイス定義

HTTPDNSResult getIpsByHostAsync(String host, RequestIpType requestIpType, Map<String,String> params, String cacheKey)

クラス

HttpDnsService

導入バージョン

2.0.2

非推奨バージョン

2.4.0

代替インターフェイス

HTTPDNSResult getHttpDnsResultForHostSyncNonBlocking(String host, RequestIpType requestIpType, Map params, String cacheKey)

パラメーター

パラメーター

必須

説明

host

String

はい

解析するドメイン名。

requestIpType

RequestIpType

はい

解析する IP タイプ。RequestIpType.both を使用します。

params

Map<String, String>

はい

ドメイン名解決のための追加パラメーター。これらは、サーバー上のカスタム解析関数における event.parameters パラメーターに対応します。

cacheKey

String

はい

ドメイン名のローカルキャッシュキー。追加パラメーターの変更によりサーバーからの再解析が必要な場合は、cacheKey を変更します。

戻り値

説明

HTTPDNSResult

解析結果。

getHttpDnsResultForHostAsync

インターフェイス定義

HTTPDNSResult getHttpDnsResultForHostAsync(String host, RequestIpType type, Map<String, String> params, String cacheKey)

クラス

HttpDnsService

導入バージョン

2.0.2

非推奨バージョン

2.4.0

代替インターフェイス

HTTPDNSResult getHttpDnsResultForHostSyncNonBlocking(String host, RequestIpType requestIpType, Map params, String cacheKey)

パラメーター

パラメーター

必須

説明

host

String

はい

解析するドメイン名。

requestIpType

RequestIpType

はい

解析する IP タイプ。RequestIpType.both を使用します。

params

Map<String, String>

はい

ドメイン名解決のための追加パラメーター。これらは、サーバー上のカスタム解析関数における event.parameters パラメーターに対応します。

cacheKey

String

はい

ドメイン名のローカルキャッシュキー。追加パラメーターの変更によりサーバーからの再解析が必要な場合は、cacheKey を変更します。

戻り値

説明

HTTPDNSResult

解析結果。