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`

美國。