HTTPDNS Android常用数据结构接口 - HTTPDNS

前言

本文档介绍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的云端解析。

HttpDnsLogger

日志接口。

`log`

日志方法。

接口定义

void log(int level, String msg)

引入版本

2.6.9

所属接口

HttpDnsLogger

参数说明

参数	类型	是否必填	说明
level	int	是	日志级别。取值：Log.DEBUG、Log.INFO、Log.WARN、Log.ERROR。
msg	String	是	日志。

Region

枚举类型。

引入版本

2.4.2

`DEFAULT`

中国内地，默认值。

`HK`

中国香港。

`SG`

新加坡。

`DE`

德国。

`US`

美国。