HTTPDNS:Android SDK 統合ガイド

// 設定を初期化します。このメソッドを呼び出し、戻り値は処理しません。
InitConfig config = InitConfig.Builder()
    /*
     (任意) アプリケーションのインストール後、最初のドメイン名解決リクエストに使用する HTTPDNS サービスクラスターを指定します。後続のリクエストは、クライアントのネットワークに基づいて最寄りのクラスターにルーティングされます。ターゲットリージョンを明示的に選択する必要があります。有効な値：Region.SG、Region.HK、Region.US、Region.DE。
     */
    .setRegion(Region.SG)
    /*
     (必須) アプリケーションコンテキストを渡します。これは、ネットワークの変更検出などの目的で使用されます。通常は ApplicationContext を渡すことができます。
    */
    .setContext(context)
    /*
     (任意) サーバーへのリクエストに署名するためのシークレットキーを設定します。これにより、リクエストの改ざんを防ぎます。この機能はデフォルトで無効になっています。セキュリティを向上させるために有効化してください。
    */
    .setSecretKey(secretKey)
    /*
     (任意) SDK とサーバー間の通信に使用するトランスポート層プロトコルを設定します。HTTPS を有効にすると、リンクのセキュリティが向上します。HTTP と HTTPS の課金の違いにご注意ください。デフォルトのプロトコルは HTTP です。セキュリティを向上させるために HTTPS を有効化してください。
    */
    .setEnableHttps(enableHttps)
    /*
     (任意) ドメイン名解決のタイムアウト期間を設定します。単位：ミリ秒。最大値は 5000 ms です。デフォルト値は 2000 ms です。
    */
    .setTimeoutMillis(2 * 1000)
    /*
     (任意) ローカルキャッシュを有効にするかどうかを指定します。これにより、起動後のドメイン名解決にかかる時間が最適化され、最初の画面の読み込み速度が向上します。この機能はデフォルトで無効になっています。有効にして、キャッシュ期間を 1 日に設定することを推奨します。
     */
    .setEnableCacheIp(true, 24 * 60 * 60 * 1000)
    /*
     (任意) 期限切れのキャッシュの使用を許可するかどうかを指定します。このオプションを有効にすると、API は最後に期限切れになった IP アドレスを即座に返し、ブロッキングを減らしてリクエストのパフォーマンスを向上させることができます。SDK はバックグラウンドで最新の解決結果を非同期に更新します。この機能はデフォルトで有効になっています。
    */
    .setEnableExpiredIp(true)
    /*
     (任意) 解決結果の IP アドレスリストのスニッフィングとソートを有効にします。検出用のドメイン名とポートのリストを設定します。遅延の影響を受けやすいリクエストに対して、この設定を推奨します。
    */
    .setIPRankingList(ipRankingItemJson.toIPRankingList())
    /*
     (任意) キャッシュ TTL をカスタマイズするためのインターフェイスを設定します。これにより、権威 DNS のデフォルトのキャッシュ TTL が変更されます。
    */
    .configCacheTtlChanger(ttlChanger)
    /*
      (任意) 一部のドメイン名の IP アドレスは比較的安定しています。これらのドメイン名のキャッシュは、ネットワークが変更されても頻繁に更新する必要はありません。このインターフェイスを使用して、SDK に明示的に通知できます。
    */
    .configHostWithFixedIp(hostListWithFixedIp)
    /*
      (任意) HTTPDNS を使用して解決しないドメイン名のフィルター条件を設定します。リスト内のドメイン名に対して、HTTPDNS は即座に null を返します。
    */
    .setNotUseHttpDnsFilter(notUseHttpDnsFilter)
    .build()

HttpDns.init(accountID, config);

// 設定を初期化します。このメソッドを呼び出し、戻り値は処理しません。
InitConfig config = new InitConfig.Builder()
    /*
     (任意) アプリケーションのインストール後、最初のドメイン名解決リクエストに使用する HTTPDNS サービスクラスターを指定します。後続のリクエストは、クライアントのネットワークに基づいて最寄りのクラスターにルーティングされます。最初のリクエストをデフォルトのクラスターに送信したくない場合は、Region.SG や Region.HK などのターゲットリージョンを明示的に選択します。デフォルトのクラスターは、Alibaba Cloud 中国サイトでは中国本土、Alibaba Cloud 国際サイトではシンガポールです。
     */
    .setRegion(Region.SG)
    /*
     (必須) アプリケーションコンテキストを渡します。これは、ネットワークの変更検出などの目的で使用されます。通常は ApplicationContext を渡すことができます。
    */
    .setContext(context)
    /*
     (任意) サーバーへのリクエストに署名するためのシークレットキーを設定します。これにより、リクエストの改ざんを防ぎます。この機能はデフォルトで無効になっています。セキュリティを向上させるために有効化してください。
    */
    .setSecretKey(secretKey)
    /*
     (任意) SDK とサーバー間の通信に使用するトランスポート層プロトコルを設定します。HTTPS を有効にすると、リンクのセキュリティが向上します。HTTP と HTTPS の課金の違いにご注意ください。デフォルトのプロトコルは HTTP です。セキュリティを向上させるために HTTPS を有効化してください。
    */
    .setEnableHttps(enableHttps)
    /*
     (任意) ドメイン名解決のタイムアウト期間を設定します。単位：ミリ秒。最大値は 5000 ms です。デフォルト値は 2000 ms です。
    */
    .setTimeoutMillis(2 * 1000)
    /*
     (任意) ローカルキャッシュを有効にするかどうかを指定します。これにより、起動後のドメイン名解決にかかる時間が最適化され、最初の画面の読み込み速度が向上します。この機能はデフォルトで無効になっています。有効にして、キャッシュ期間を 1 日に設定することを推奨します。
     */
    .setEnableCacheIp(true, 24 * 60 * 60 * 1000)
    /*
     (任意) 期限切れのキャッシュの使用を許可するかどうかを指定します。このオプションを有効にすると、API は最後に期限切れになった IP アドレスを即座に返し、ブロッキングを減らしてリクエストのパフォーマンスを向上させることができます。SDK はバックグラウンドで最新の解決結果を非同期に更新します。この機能はデフォルトで有効になっています。
    */
    .setEnableExpiredIp(true)
    /*
     (任意) 解決結果の IP アドレスリストのスニッフィングとソートを有効にします。検出用のドメイン名とポートのリストを設定します。遅延の影響を受けやすいサービスに対して、この設定を推奨します。
    */
    .setIPRankingList(ipRankingItemJson.toIPRankingList())
    /*
     (任意) キャッシュ TTL をカスタマイズするためのインターフェイスを設定します。これにより、権威 DNS のデフォルトのキャッシュ TTL が変更されます。
    */
    .configCacheTtlChanger(ttlChanger)
    /*
      (任意) 一部のドメイン名の IP アドレスは比較的安定しています。これらのドメイン名のキャッシュは、ネットワークが変更されても頻繁に更新する必要はありません。このインターフェイスを使用して、SDK に明示的に通知できます。
    */
    .configHostWithFixedIp(hostListWithFixedIp)
    /*
      (任意) HTTPDNS を使用して解決しないドメイン名のフィルター条件を設定します。リスト内のドメイン名に対して、HTTPDNS は即座に null を返します。
    */
    .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
            // 重要: Local DNS へのフォールバックを設定
        } 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);
    }
};