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

HTTPDNS:共通データ構造インターフェース

最終更新日:Nov 09, 2025

はじめに

このドキュメントでは、HTTPDNS SDK 内の共通データ構造とインターフェース定義について説明します。

HTTPDNSResult

ドメイン名解決によって返される解決結果のデータクラスです。

getHost

対応するドメイン名を取得します。

インターフェース定義

String getHost()

導入バージョン

1.3.2

所属クラス

HTTPDNSResult

戻り値の説明

タイプ

説明

String

ドメイン名。

getIps

解決された IPv4 アドレスを取得します。

インターフェース定義

String[] getIps()

導入バージョン

1.3.2

所属クラス

HTTPDNSResult

戻り値の説明

タイプ

説明

String []

ドメイン名解決の IPv4 アドレス。

getIpv6s

解決された IPv6 アドレスを取得します。

インターフェース定義

String[] getIpv6s()

導入バージョン

2.0.2

所属クラス

HTTPDNSResult

戻り値の説明

タイプ

説明

String []

ドメイン名解決の IPv6 アドレス。

getExtras

解決の追加パラメーターを取得します。カスタム解決の場合のみ、このデータが存在します。

インターフェース定義

Map<String, String> getExtras()

導入バージョン

1.3.2

所属クラス

HTTPDNSResult

戻り値の説明

タイプ

説明

Map<String, String>

ドメイン名解決のためにバックエンドから返された追加パラメーター。

isExpired

解決結果が期限切れかどうかを判断します。期限切れは、解決結果が取得された時間と、ドメイン名に設定された TTL に基づいて計算されます。

インターフェース定義

boolean isExpired()

導入バージョン

2.0.2

カテゴリ

HTTPDNSResult

戻り値の説明

タイプ

説明

boolean

  • True: 期限切れ

  • false: 期限切れではない

HttpDnsCallback

非同期ドメイン名解決インターフェースとカスタムドメイン名解決インターフェースにおけるコールバックインターフェースです。

onHttpDnsCompleted

解決が完了した後のコールバック関数です。この関数は、解決が成功した場合でも失敗した場合でも呼び出されます。

インターフェース定義

void onHttpDnsCompleted(HTTPDNSResult result)

導入バージョン

2.4.0

関連インターフェイス

HttpDnsCallback

パラメーターの説明

パラメーター

タイプ

必須かどうか

説明

result

HTTPDNSResult

はい

HTTPDNSResult

CacheTtlChanger

ドメイン名解決結果の TTL をカスタマイズするためのインターフェースです。

changeCacheTtl

カスタム TTL。

インターフェイスの定義

int changeCacheTtl(String host, RequestIpType type, int ttl)

導入バージョン

2.3.0

所属インターフェース

CacheTtlChanger

パラメーターの説明

パラメーター

タイプ

必須かどうか

説明

host

String

はい

ドメイン名

type

RequestIpType

はい

IP アドレスのタイプ。

ttl

int

はい

元の TTL。

戻り値の説明

タイプ

説明

int

カスタマイズされた TTL。カスタマイズが不要な場合は、元の TTL を返してください。

NotUseHttpDnsFilter

HTTPDNS 解決を使用しないドメイン名フィルタリングインターフェースです。

notUseHttpDns

HTTPDNS を使用して解決されないドメイン名を設定します。

インターフェイスの定義

boolean notUseHttpDns(String host)

導入バージョン

2.4.0

所属インターフェース

NotUseHttpDnsFilter

パラメーターの説明

パラメーター

タイプ

必須かどうか

説明

host

String

はい

ドメイン名

戻り値の説明

タイプ

説明

boolean

  • true、現在のドメイン名をフィルタリングします。現在のドメイン名は httpdns のクラウド解決を使用しません。

  • false: 現在のドメイン名をフィルターしません。現在のドメイン名は HTTPDNS を使用して解決されます。

ILogger

ロギング操作。

log

ログメソッド。

操作定義

void log(String msg)

導入バージョン

1.3.2

関連インターフェイス

ILogger

パラメーターの説明

パラメーター

タイプ

必須かどうか

説明

msg

String

はい

ログ。

Region

値は列挙値です。

導入バージョン

2.4.2

DEFAULT

中国本土、デフォルト値。

HK

香港 (中国)。

SG

シンガポール。

DE

ドイツ。

US

米国。