全部產品
Search
文件中心

HTTPDNS:自訂解析介面(已淘汰)

更新時間:Sep 27, 2025

前言

本文檔所有介面,需結合編寫自訂解析函數,用於基礎解析情境不滿足需求時,進行自訂解析使用。

每個自訂網域名解析的請求都需要攜帶的通用參數可以通過設定自訂解析全域參數來配置。

自訂解析同步非阻塞解析介面

使用自訂同步非阻塞介面解析網域名稱,不會阻塞當前線程,但可能會返回空結果。

該介面僅查詢快取,返回緩衝查詢的解析結果。若緩衝中沒有解析結果或者緩衝中的解析結果已經TTL到期,則會在背景工作執行緒中進行網域名稱解析,解析成功後更新緩衝,供下次調用網域名稱解析使用。

getIpsByHostAsync

使用同步非阻塞方式,自訂解析IPv4地址。

介面定義

HTTPDNSResult getIpsByHostAsync(String host, Map<String,String> params, String cacheKey)

所屬類

HttpDnsService

引入版本

1.3.0

廢棄版本

2.3.2

替代介面

HTTPDNSResult getHttpDnsResultForHostSyncNonBlocking(String host, RequestIpType requestIpType, Map<String, String> params, String cacheKey)

參數說明

參數

類型

是否必填

說明

host

String

是

待解析網域名稱。

params

Map<String, String>

是

解析網域名稱攜帶的額外參數,對應服務端自訂解析函數中的event.parameters參數。

cacheKey

String

是

網域名稱對應的本機快取key,如果額外參數變更導致需要重新去服務端解析,則需要變更cacheKey。

返回說明

類型

說明

HTTPDNSResult

解析結果。

getHttpDnsResultForHostAsync

使用同步非阻塞方式,自訂解析IPv4地址。

介面定義

HTTPDNSResult getHttpDnsResultForHostAsync(String host, Map<String, String> params, String cacheKey);

所屬類

HttpDnsService

引入版本

2.0.2

廢棄版本

2.4.0

替代介面

HTTPDNSResult getHttpDnsResultForHostSyncNonBlocking(String host, RequestIpType requestIpType, Map<String, String> params, String cacheKey)

參數說明

參數

類型

是否必填

說明

host

String

是

待解析網域名稱。

params

Map<String, String>

是

解析網域名稱攜帶的額外參數,對應服務端自訂解析函數中的event.parameters參數。

cacheKey

String

是

網域名稱對應的本機快取key,如果額外參數變更導致需要重新去服務端解析,則需要變更cacheKey。

返回說明

類型

說明

HTTPDNSResult

解析結果。

getIpsByHostAsync

使用同步非阻塞方式,自訂解析指定IP類型的IP地址。

介面說明

HTTPDNSResult getIpsByHostAsync(String host, RequestIpType requestIpType, Map<String,String> params, String cacheKey)

所屬類

HttpDnsService

引入版本

2.0.2

廢棄版本

2.4.0

替代介面

HTTPDNSResult getHttpDnsResultForHostSyncNonBlocking(String host, RequestIpType requestIpType, Map params, String cacheKey)

參數說明

參數

類型

是否必填

說明

host

String

是

待解析網域名稱。

requestIpType

RequestIpType

是

待解析的IP類型。推薦使用RequestIpType.both

params

Map<String, String>

是

解析網域名稱攜帶的額外參數,對應服務端自訂解析函數中的event.parameters參數。

cacheKey

String

是

網域名稱對應的本機快取key,如果額外參數變更導致需要重新去服務端解析,則需要變更cacheKey。

返回說明

類型

說明

HTTPDNSResult

解析結果。

getHttpDnsResultForHostAsync

介面說明

HTTPDNSResult getHttpDnsResultForHostAsync(String host, RequestIpType type, Map<String, String> params, String cacheKey)

所屬類

HttpDnsService

引入版本

2.0.2

廢棄版本

2.4.0

替代介面

HTTPDNSResult getHttpDnsResultForHostSyncNonBlocking(String host, RequestIpType requestIpType, Map params, String cacheKey)

參數說明

參數

類型

是否必填

說明

host

String

是

待解析網域名稱。

requestIpType

RequestIpType

是

待解析的IP類型。推薦使用RequestIpType.both

params

Map<String, String>

是

解析網域名稱攜帶的額外參數,對應服務端自訂解析函數中的event.parameters參數。

cacheKey

String

是

網域名稱對應的本機快取key,如果額外參數變更導致需要重新去服務端解析,則需要變更cacheKey。

返回說明

類型

說明

HTTPDNSResult

解析結果。