本文中含有需要您注意的重要提示信息，忽略該信息可能對您的業務造成影響，請務必仔細閱讀。
前言
本文檔介紹HTTPDNS SDK內常用的數據結構及接口的定義。
HTTPDNSResult
域名解析返回的解析結果的數據類。
getHost
獲取對應域名。
接口定義
String getHost()
所屬類
HTTPDNSResult
返回說明
類型 | 說明 |
String | 域名。 |
getIps
獲取解析的IPv4地址。
接口定義
String[] getIps()
所屬類
HTTPDNSResult
返回說明
類型 | 說明 |
String [] | 域名解析的IPv4地址。 |
getIpv6s
獲取解析的IPv6地址。
接口定義
String[] getIpv6s()
所屬類
HTTPDNSResult
返回說明
類型 | 說明 |
String [] | 域名解析的IPv6地址。 |
getExtras
獲取解析的額外參數，只有自定義解析會有這部分數據。
接口定義
Map<String, String> getExtras()
所屬類
HTTPDNSResult
返回說明
類型 | 說明 |
Map<String, String> | 域名解析，后端返回的額外參數。 |
isExpired
解析結果是否已經過期，是否過期是根據解析結果獲取時間和域名配置的TTL來計算。
接口定義
boolean isExpired()
所屬類
HTTPDNSResult
返回說明
類型 | 說明 |
boolean |
|
HttpDnsCallback
異步域名解析接口和自定義域名解析接口中的回調接口。
onHttpDnsCompleted
解析結束后的回調函數，成功/失敗都會回調該函數。
接口定義
void onHttpDnsCompleted(HTTPDNSResult result)
所屬接口
HttpDnsCallback
參數說明
參數 | 類型 | 是否必填 | 說明 |
result | HTTPDNSResult | 是 |
CacheTtlChanger
自定義域名解析結果TTL的接口。
changeCacheTtl
自定義TTL。
接口定義
int changeCacheTtl(String host, RequestIpType type, int ttl)
所屬接口
CacheTtlChanger
參數說明
參數 | 類型 | 是否必填 | 說明 |
host | String | 是 | 域名 |
type | RequestIpType | 是 | IP類型。 |
ttl | int | 是 | 原始的ttl。 |
返回說明
類型 | 說明 |
int | 自定義后的ttl，如果不需要自定義，請返回原始的ttl。 |
NotUseHttpDnsFilter
不使用HTTPDNS解析的域名過濾接口。
2.4.0版本新增的接口。
notUseHttpDns
配置不使用HttpDns解析的域名。
接口定義
boolean notUseHttpDns(String host)
所屬接口
NotUseHttpDnsFilter
參數說明
參數 | 類型 | 是否必填 | 說明 |
host | String | 是 | 域名 |
返回說明
類型 | 說明 |
boolean |
|
DegradationFilter
不使用HTTPDNS解析的域名過濾接口。
2.4.0版本廢棄了該接口，請使用NotUseHttpDnsFilter
shouldDegradeHttpDNS
配置不使用HttpDns解析的域名。
接口定義
boolean shouldDegradeHttpDNS(String host)
所屬接口
DegradationFilter
參數說明
參數 | 類型 | 是否必填 | 說明 |
host | String | 是 | 域名 |
返回說明
類型 | 說明 |
boolean |
|
ILogger
日志接口。
log
日志方法。
接口定義
void log(String msg)
所屬接口
ILogger
參數說明
參數 | 類型 | 是否必填 | 說明 |
msg | String | 是 | 日志。 |
Region
枚舉類型。
DEFAULT
中國內地，默認值。
HK
中國香港。
SG
新加坡。
DE
德國。
US
美國。