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

HTTPDNS:共通のデータ構造の操作

最終更新日:Jun 04, 2026

背景情報

このトピックでは、HTTPDNS SDK for Android で一般的に使用されるデータ構造と API 操作について説明します。

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

ドメイン名の解決結果が期限切れかどうかを確認します。期限切れは、解決結果が取得された時刻と、ドメイン名に設定された Time to Live (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

API

CacheTtlChanger

パラメーター

パラメーター

データ型

必須

説明

host

String

はい

ドメイン名。

type

RequestIpType

はい

IP アドレスのタイプ。

ttl

int

はい

元の TTL。

戻り値

データ型

説明

int

カスタマイズ後の TTL 値。TTL をカスタマイズする必要がない場合は、元の TTL 値を返します。

NotUseHttpDnsFilter

特定のドメイン名を HTTPDNS の名前解決から除外するためのインターフェイスです。

notUseHttpDns

指定されたドメイン名を HTTPDNS による名前解決から除外するかどうかを判定します。

操作の定義

boolean notUseHttpDns(String host)

対応バージョン

2.4.0

API

NotUseHttpDnsFilter

パラメーター

パラメーター

データ型

必須

説明

host

String

はい

ドメイン名。

戻り値

データ型

説明

boolean

  • true:現在のドメイン名を HTTPDNS の解決対象から除外します。

  • false:現在のドメイン名を HTTPDNS の解決対象とします。

HttpDnsLogger

ロギング用のインターフェイスです。

log

ロギングメソッドです。

操作の定義

void log(int level, String msg)

対応バージョン

2.6.9

インターフェイス

HttpDnsLogger

パラメーター

パラメーター

データ型

必須

説明

level

int

はい

ログレベル。有効な値:Log.DEBUGLog.INFOLog.WARNLog.ERROR

msg

String

はい

ログメッセージ。

Region

列挙型です。

対応バージョン

2.4.2

DEFAULT

中国本土リージョン。これがデフォルト値です。

HK

中国 (香港)。

SG

シンガポール。

DE

ドイツ。

US

米国。