はじめに
基本的な解析シナリオが要件を満たさない場合、このドキュメントのすべての API でカスタム解析を実行するには、カスタム解析関数を記述する必要があります。
カスタム解析のグローバルパラメーターを設定することで、各カスタムドメイン名解析リクエストの共通パラメーターを設定できます。
カスタム同期非ブロッキング解析インターフェイス
カスタム同期非ブロッキングインターフェイスを使用してドメイン名を解析しても、現在のスレッドはブロックされません。ただし、空の結果が返される場合があります。
このインターフェイスはキャッシュのみをクエリして結果を返します。キャッシュに結果が含まれていないか、キャッシュされた結果の有効期限が切れている場合、ワーカースレッドがドメイン名を解決します。その後、後続の呼び出しのために、キャッシュは新しい結果で更新されます。
getIpsByHostAsync
同期、非ブロッキング方式で IPv4 アドレスのカスタム解析を実行します。
インターフェイス定義
HTTPDNSResult getIpsByHostAsync(String host, Map<String,String> params, String cacheKey)
クラス
HttpDnsService
導入バージョン
1.3.0
非推奨バージョン
2.3.2
代替インターフェイス
パラメーター
パラメーター | 型 | 必須 | 説明 |
host | String | はい | 解析するドメイン名。 |
params | Map<String, String> | はい | ドメイン名解決のための追加パラメーター。これらは、サーバー上のカスタム解析関数における event.parameters パラメーターに対応します。 |
cacheKey | String | はい | ドメイン名のローカルキャッシュキー。追加パラメーターの変更によりサーバーからの再解析が必要な場合は、cacheKey を変更します。 |
戻り値
型 | 説明 |
解析結果。 |
getHttpDnsResultForHostAsync
同期、非ブロッキング方式で IPv4 アドレスのカスタム解析を実行します。
インターフェイス定義
HTTPDNSResult getHttpDnsResultForHostAsync(String host, Map<String, String> params, String cacheKey);
クラス
HttpDnsService
導入バージョン
2.0.2
非推奨バージョン
2.4.0
代替インターフェイス
パラメーター
パラメーター | 型 | 必須 | 説明 |
host | String | はい | 解析するドメイン名。 |
params | Map<String, String> | はい | ドメイン名解決のための追加パラメーター。これらは、サーバー上のカスタム解析関数における event.parameters パラメーターに対応します。 |
cacheKey | String | はい | ドメイン名のローカルキャッシュキー。追加パラメーターの変更によりサーバーからの再解析が必要な場合は、cacheKey を変更します。 |
戻り値
型 | 説明 |
解析結果。 |
getIpsByHostAsync
同期、非ブロッキング方式で、指定されたタイプの IP アドレスのカスタム解析を実行します。
インターフェイス定義
HTTPDNSResult getIpsByHostAsync(String host, RequestIpType requestIpType, Map<String,String> params, String cacheKey)
クラス
HttpDnsService
導入バージョン
2.0.2
非推奨バージョン
2.4.0
代替インターフェイス
パラメーター
パラメーター | 型 | 必須 | 説明 |
host | String | はい | 解析するドメイン名。 |
requestIpType | RequestIpType | はい | 解析する IP タイプ。RequestIpType.both を使用します。 |
params | Map<String, String> | はい | ドメイン名解決のための追加パラメーター。これらは、サーバー上のカスタム解析関数における event.parameters パラメーターに対応します。 |
cacheKey | String | はい | ドメイン名のローカルキャッシュキー。追加パラメーターの変更によりサーバーからの再解析が必要な場合は、cacheKey を変更します。 |
戻り値
型 | 説明 |
解析結果。 |
getHttpDnsResultForHostAsync
インターフェイス定義
HTTPDNSResult getHttpDnsResultForHostAsync(String host, RequestIpType type, Map<String, String> params, String cacheKey)
クラス
HttpDnsService
導入バージョン
2.0.2
非推奨バージョン
2.4.0
代替インターフェイス
パラメーター
パラメーター | 型 | 必須 | 説明 |
host | String | はい | 解析するドメイン名。 |
requestIpType | RequestIpType | はい | 解析する IP タイプ。RequestIpType.both を使用します。 |
params | Map<String, String> | はい | ドメイン名解決のための追加パラメーター。これらは、サーバー上のカスタム解析関数における event.parameters パラメーターに対応します。 |
cacheKey | String | はい | ドメイン名のローカルキャッシュキー。追加パラメーターの変更によりサーバーからの再解析が必要な場合は、cacheKey を変更します。 |
戻り値
型 | 説明 |
解析結果。 |