前言
本文档介绍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 |
|
HttpDnsCallback
异步域名解析接口和自定义域名解析接口中的回调接口。
onHttpDnsCompleted
解析结束后的回调函数，成功/失败都会回调该函数。
接口定义
void onHttpDnsCompleted(HTTPDNSResult result)
引入版本
2.4.0
所属接口
HttpDnsCallback
参数说明
参数 | 类型 | 是否必填 | 说明 |
result | 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 |
|
ILogger
日志接口。
log
日志方法。
接口定义
void log(String msg)
引入版本
1.3.2
所属接口
ILogger
参数说明
参数 | 类型 | 是否必填 | 说明 |
msg | String | 是 | 日志。 |
Region
枚举类型。
引入版本
2.4.2
DEFAULT
中国内地，默认值。
HK
中国香港。
SG
新加坡。
DE
德国。
US
美国。