前言
本文檔所有介面,需結合編寫自訂解析函數,用於基礎解析情境不滿足需求時,進行自訂解析使用。
每個自訂網域名解析的請求都需要攜帶的通用參數可以通過設定自訂解析全域參數來配置。
自訂解析同步非阻塞解析介面
使用自訂同步非阻塞介面解析網域名稱,不會阻塞當前線程,但可能會返回空結果。
該介面僅查詢快取,返回緩衝查詢的解析結果。若緩衝中沒有解析結果或者緩衝中的解析結果已經TTL到期,則會在背景工作執行緒中進行網域名稱解析,解析成功後更新緩衝,供下次調用網域名稱解析使用。
getIpsByHostAsync
使用同步非阻塞方式,自訂解析IPv4地址。
介面定義
HTTPDNSResult getIpsByHostAsync(String host, Map<String,String> params, String cacheKey)
所屬類
HttpDnsService
引入版本
1.3.0
廢棄版本
2.3.2
替代介面
參數說明
參數 | 類型 | 是否必填 | 說明 |
host | String | 是 | 待解析網域名稱。 |
params | Map<String, String> | 是 | 解析網域名稱攜帶的額外參數,對應服務端自訂解析函數中的event.parameters參數。 |
cacheKey | String | 是 | 網域名稱對應的本機快取key,如果額外參數變更導致需要重新去服務端解析,則需要變更cacheKey。 |
返回說明
類型 | 說明 |
解析結果。 |
getHttpDnsResultForHostAsync
使用同步非阻塞方式,自訂解析IPv4地址。
介面定義
HTTPDNSResult getHttpDnsResultForHostAsync(String host, Map<String, String> params, String cacheKey);
所屬類
HttpDnsService
引入版本
2.0.2
廢棄版本
2.4.0
替代介面
參數說明
參數 | 類型 | 是否必填 | 說明 |
host | String | 是 | 待解析網域名稱。 |
params | Map<String, String> | 是 | 解析網域名稱攜帶的額外參數,對應服務端自訂解析函數中的event.parameters參數。 |
cacheKey | String | 是 | 網域名稱對應的本機快取key,如果額外參數變更導致需要重新去服務端解析,則需要變更cacheKey。 |
返回說明
類型 | 說明 |
解析結果。 |
getIpsByHostAsync
使用同步非阻塞方式,自訂解析指定IP類型的IP地址。
介面說明
HTTPDNSResult getIpsByHostAsync(String host, RequestIpType requestIpType, Map<String,String> params, String cacheKey)
所屬類
HttpDnsService
引入版本
2.0.2
廢棄版本
2.4.0
替代介面
參數說明
參數 | 類型 | 是否必填 | 說明 |
host | String | 是 | 待解析網域名稱。 |
requestIpType | RequestIpType | 是 | 待解析的IP類型。推薦使用RequestIpType.both |
params | Map<String, String> | 是 | 解析網域名稱攜帶的額外參數,對應服務端自訂解析函數中的event.parameters參數。 |
cacheKey | String | 是 | 網域名稱對應的本機快取key,如果額外參數變更導致需要重新去服務端解析,則需要變更cacheKey。 |
返回說明
類型 | 說明 |
解析結果。 |
getHttpDnsResultForHostAsync
介面說明
HTTPDNSResult getHttpDnsResultForHostAsync(String host, RequestIpType type, Map<String, String> params, String cacheKey)
所屬類
HttpDnsService
引入版本
2.0.2
廢棄版本
2.4.0
替代介面
參數說明
參數 | 類型 | 是否必填 | 說明 |
host | String | 是 | 待解析網域名稱。 |
requestIpType | RequestIpType | 是 | 待解析的IP類型。推薦使用RequestIpType.both |
params | Map<String, String> | 是 | 解析網域名稱攜帶的額外參數,對應服務端自訂解析函數中的event.parameters參數。 |
cacheKey | String | 是 | 網域名稱對應的本機快取key,如果額外參數變更導致需要重新去服務端解析,則需要變更cacheKey。 |
返回說明
類型 | 說明 |
解析結果。 |