HTTPDNS：Android SDK接入流程

//初始化配置，調用即可，不必處理傳回值。
InitConfig config = InitConfig.Builder()
    /*
     （可選）設定應用安裝後首次網域名稱解析訪問的HTTPDNS服務叢集，後續解析請求會依據用戶端網路就近訪問，需明確選取目的地區域，可選Region為Region.SG、Region.HK、Region.US、Region.DE。
     */
    .setRegion(Region.SG)
    /*
     （必填）傳入應用 Context，用於網路變化事件感知等，通常傳 ApplicationContext 即可。
    */
    .setContext(context)
    /*
     （可選）配置與服務端互動的加簽秘鑰，可防止請求被篡改，預設不開啟，建議開啟。
    */
    .setSecretKey(secretKey)
    /*
     (可選) 配置SDK與服務端互動的傳輸層協議，開啟後可獲得更高的鏈路安全性，同時需關注 HTTP 與 HTTPS 在計費邏輯上的差異，預設HTTP協議，建議開啟。
    */
    .setEnableHttps(enableHttps)
    /*
     （可選）設定網域名稱解析逾時時間，毫秒，最大5000ms，預設2000ms。
    */
    .setTimeoutMillis(2 * 1000)
    /*
     （可選）配置是否啟用本機快取，用於最佳化啟動後的網域名稱解析環節耗時，進而提升首屏載入速度，預設不啟用，建議開啟並設定緩衝時間為1天。
     */
    .setEnableCacheIp(true, 24 * 60 * 60 * 1000)
    /*
     （可選）設定是否允許使用到期緩衝，若啟用“複用到期IP”選項，介面可立即返回上次的到期IP以減少阻塞並提升請求效能，同時SDK會在後台非同步重新整理最新解析，預設開啟。
    */
    .setEnableExpiredIp(true)
    /*
     （可選）設定對解析結果的IP列表進行嗅探排序，設定嗅探的網域名稱和探測連接埠的列表，對延遲敏感的請求，建議配置
    */
    .setIPRankingList(ipRankingItemJson.toIPRankingList())
    /*
     （可選） 配置介面來自訂緩衝的ttl時間，以改變的權威DNS預設緩衝TTL
    */
    .configCacheTtlChanger(ttlChanger)
    /*
      (可選) 部分網域名稱的IP是相對穩定的，這部分網域名稱的緩衝在網路變化等情境下可以不用頻繁重新整理，可以通過該介面顯式告訴SDK
    */
    .configHostWithFixedIp(hostListWithFixedIp)
    /*
      （可選）配置不使用HTTPDNS解析的網域名稱篩選條件，對於列表中的網域名稱，HTTPDNS立即返回空
    */
    .setNotUseHttpDnsFilter(notUseHttpDnsFilter)
    .build()

HttpDns.init(accountID, config);

//初始化配置，調用即可，不必處理傳回值。
InitConfig config = new InitConfig.Builder()
    /*
     （可選）設定應用安裝後首次網域名稱解析訪問的HTTPDNS服務叢集，後續解析請求會依據用戶端網路就近訪問，若業務不希望首次訪問到預設叢集，可在此明確選取目的地區域（如 Region.SG、Region.HK），中國站預設中國大陸，國際站預設新加坡叢集。
     */
    .setRegion(Region.SG)
    /*
     （必填）傳入應用 Context，用於網路變化事件感知等，通常傳 ApplicationContext 即可。
    */
    .setContext(context)
    /*
     （可選）配置與服務端互動的加簽秘鑰，可防止請求被篡改，預設不開啟，建議開啟。
    */
    .setSecretKey(secretKey)
    /*
     (可選) 配置SDK與服務端互動的傳輸層協議，開啟後可獲得更高的鏈路安全性，同時需關注 HTTP 與 HTTPS 在計費邏輯上的差異，預設HTTP協議，建議開啟。
    */
    .setEnableHttps(enableHttps)
    /*
     （可選）設定網域名稱解析逾時時間，毫秒，最大5000ms，預設2000ms。
    */
    .setTimeoutMillis(2 * 1000)
    /*
     （可選）配置是否啟用本機快取，用於最佳化啟動後的網域名稱解析環節耗時，進而提升首屏載入速度，預設不啟用，建議開啟並設定緩衝時間為1天。
     */
    .setEnableCacheIp(true, 24 * 60 * 60 * 1000)
    /*
     （可選）設定是否允許使用到期緩衝，若啟用“複用到期IP”選項，介面可立即返回上次的到期IP以減少阻塞並提升請求效能，同時SDK會在後台非同步重新整理最新解析，預設開啟。
    */
    .setEnableExpiredIp(true)
    /*
     （可選）設定對解析結果的IP列表進行嗅探排序，設定嗅探的網域名稱和探測連接埠的列表，對延遲敏感的業務，建議配置
    */
    .setIPRankingList(ipRankingItemJson.toIPRankingList())
    /*
     （可選） 配置介面來自訂緩衝的ttl時間，以改變的權威DNS預設緩衝TTL
    */
    .configCacheTtlChanger(ttlChanger)
    /*
      (可選) 部分網域名稱的IP是相對穩定的，這部分網域名稱的緩衝在網路變化等情境下可以不用頻繁重新整理，可以通過該介面顯式告訴SDK
    */
    .configHostWithFixedIp(hostListWithFixedIp)
    /*
      （可選）配置不使用HTTPDNS解析的網域名稱篩選條件，對於列表中的網域名稱，HTTPDNS立即返回空
    */
    .setNotUseHttpDnsFilter(notUseHttpDnsFilter)
    .build()

HttpDns.init(accountID, config);

val httpdns = HttpDns.getService(accountID)

HttpDnsService httpdns = HttpDns.getService(accountID);

val hostList = arrayListOf<String>()
hostList.add("www.aliyun.com")
httpdns.setPreResolveHosts(hostList)

ArrayList<String> hostList = new ArrayList<>();
hostList.add("www.aliyun.com");
httpdns.setPreResolveHosts(hostList);

val httpDnsResult = httpdns.getHttpDnsResultForHostSyncNonBlocking("www.aliyun.com", RequestIpType.auto)

HTTPDNSResult httpDnsResult = httpdns.getHttpDnsResultForHostSyncNonBlocking("www.aliyun.com", RequestIpType.auto);

object : Dns {
    @Throws(UnknownHostException::class)
    override fun lookup(host: String): List<InetAddress> {
        val httpdnsResult: HTTPDNSResult = HttpDns.getService(accountID)
            .getHttpDnsResultForHostSyncNonBlocking(host, RequestIpType.auto)
        val inetAddresses: MutableList<InetAddress> = ArrayList()
        var address: InetAddress
        try {
            if (httpdnsResult.ips != null) {
                //處理IPv4地址
                for (ipv4 in httpdnsResult.ips) {
                    address = InetAddress.getByName(ipv4)
                    inetAddresses.add(address)
                }
            }
            if (httpdnsResult.ipv6s != null) {
                //處理IPv6地址
                for (ipv6 in httpdnsResult.ipv6s) {
                    address = InetAddress.getByName(ipv6)
                    inetAddresses.add(address)
                }
            }
        } catch (e: UnknownHostException) {
        }
        return if (!inetAddresses.isEmpty()) {
            inetAddresses
            // 重要：配置降級LocalDNS
        } else Dns.SYSTEM.lookup(host)
    }
}

new Dns() {
    @Override
    public List<InetAddress> lookup(String host) throws UnknownHostException {
        HTTPDNSResult httpdnsResult = HttpDns.getService(accountID).getHttpDnsResultForHostSync(host, RequestIpType.auto);
        List<InetAddress> inetAddresses = new ArrayList<>();
        InetAddress address;
        try {
            if (httpdnsResult.getIps() != null) {
                //處理IPv4地址
                for (String ipv4 : httpdnsResult.getIps()) {
                    address = InetAddress.getByName(ipv4);
                    inetAddresses.add(address);
                }
            }

            if (httpdnsResult.getIpv6s() != null) {
                //處理IPv6地址
                for (String ipv6 : httpdnsResult.getIpv6s()) {
                    address = InetAddress.getByName(ipv6);
                    inetAddresses.add(address);
                }
            }
        } catch (UnknownHostException e) {

        }

        if (!inetAddresses.isEmpty()) {
            return inetAddresses;
        }

        return Dns.SYSTEM.lookup(host);
    }
};