全部產品
Search
文件中心

HTTPDNS:常用資料結構介面

更新時間:Sep 27, 2025

前言

本文檔介紹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的雲端解析。

ILogger

日誌介面。

log

日誌方法。

介面定義

void log(String msg)

引入版本

1.3.2

所屬介面

ILogger

參數說明

參數

類型

是否必填

說明

msg

String

日誌。

Region

枚舉類型。

引入版本

2.4.2

DEFAULT

中國內地,預設值。

HK

中國香港。

SG

新加坡。

DE

德國。

US

美國。