HTTPDNS:Panduan integrasi Android SDK

// Inisialisasi konfigurasi. Panggil metode ini tanpa menangani nilai kembali.
InitConfig config = InitConfig.Builder()
    /*
     (Opsional) Tentukan kluster layanan HTTPDNS untuk permintaan resolusi nama domain pertama setelah aplikasi diinstal. Permintaan berikutnya akan diarahkan ke kluster terdekat berdasarkan jaringan klien. Anda harus secara eksplisit memilih wilayah target. Nilai yang valid: Region.SG, Region.HK, Region.US, dan Region.DE.
     */
    .setRegion(Region.SG)
    /*
     (Wajib) Berikan konteks aplikasi. Ini digunakan untuk tujuan seperti mendeteksi perubahan jaringan. Biasanya Anda dapat memberikan ApplicationContext.
    */
    .setContext(context)
    /*
     (Opsional) Konfigurasi kunci rahasia untuk menandatangani permintaan ke server. Ini mencegah permintaan dimanipulasi. Fitur ini dinonaktifkan secara default. Aktifkan untuk keamanan yang lebih baik.
    */
    .setSecretKey(secretKey)
    /*
     (Opsional) Konfigurasi protokol lapisan transport untuk komunikasi antara SDK dan server. Mengaktifkan HTTPS memberikan keamanan tautan yang lebih tinggi. Perhatikan perbedaan penagihan antara HTTP dan HTTPS. Protokol default adalah HTTP. Aktifkan HTTPS untuk keamanan yang lebih baik.
    */
    .setEnableHttps(enableHttps)
    /*
     (Opsional) Atur periode timeout untuk resolusi nama domain. Satuan: milidetik. Nilai maksimum adalah 5000 ms. Nilai default adalah 2000 ms.
    */
    .setTimeoutMillis(2 * 1000)
    /*
     (Opsional) Tentukan apakah akan mengaktifkan cache lokal. Ini mengoptimalkan waktu yang dibutuhkan untuk resolusi nama domain setelah startup dan meningkatkan kecepatan pemuatan layar pertama. Fitur ini dinonaktifkan secara default. Kami merekomendasikan agar Anda mengaktifkannya dan mengatur durasi cache menjadi 1 hari.
     */
    .setEnableCacheIp(true, 24 * 60 * 60 * 1000)
    /*
     (Opsional) Tentukan apakah akan mengizinkan penggunaan cache yang telah kedaluwarsa. Jika Anda mengaktifkan opsi ini, API dapat langsung mengembalikan alamat IP kedaluwarsa terakhir untuk mengurangi pemblokiran dan meningkatkan performa permintaan. SDK secara asinkron memperbarui hasil resolusi terbaru di latar belakang. Fitur ini diaktifkan secara default.
    */
    .setEnableExpiredIp(true)
    /*
     (Opsional) Aktifkan sniffing dan pengurutan untuk daftar alamat IP dalam hasil resolusi. Tetapkan daftar nama domain dan port untuk deteksi. Kami merekomendasikan Anda mengonfigurasi ini untuk permintaan yang sensitif terhadap latensi.
    */
    .setIPRankingList(ipRankingItemJson.toIPRankingList())
    /*
     (Opsional) Konfigurasi antarmuka untuk menyesuaikan TTL cache. Ini mengubah TTL cache default dari DNS otoritatif.
    */
    .configCacheTtlChanger(ttlChanger)
    /*
      (Opsional) Alamat IP beberapa nama domain relatif stabil. Cache untuk nama domain ini tidak perlu sering diperbarui saat jaringan berubah. Anda dapat menggunakan antarmuka ini untuk secara eksplisit memberi tahu SDK.
    */
    .configHostWithFixedIp(hostListWithFixedIp)
    /*
      (Opsional) Konfigurasi kondisi filter untuk nama domain yang tidak menggunakan HTTPDNS untuk resolusi. Untuk nama domain dalam daftar, HTTPDNS langsung mengembalikan null.
    */
    .setNotUseHttpDnsFilter(notUseHttpDnsFilter)
    .build()

HttpDns.init(accountID, config);

// Inisialisasi konfigurasi. Panggil metode ini tanpa menangani nilai kembali.
InitConfig config = new InitConfig.Builder()
    /*
     (Opsional) Tentukan kluster layanan HTTPDNS untuk permintaan resolusi nama domain pertama setelah aplikasi diinstal. Permintaan berikutnya akan diarahkan ke kluster terdekat berdasarkan jaringan klien. Jika Anda tidak ingin permintaan pertama diarahkan ke kluster default, pilih secara eksplisit wilayah target, seperti Region.SG atau Region.HK. Kluster default adalah daratan Tiongkok untuk Alibaba Cloud China Website dan Singapura untuk Alibaba Cloud International Website.
     */
    .setRegion(Region.SG)
    /*
     (Wajib) Berikan konteks aplikasi. Ini digunakan untuk tujuan seperti mendeteksi perubahan jaringan. Biasanya Anda dapat memberikan ApplicationContext.
    */
    .setContext(context)
    /*
     (Opsional) Konfigurasi kunci rahasia untuk menandatangani permintaan ke server. Ini mencegah permintaan dimanipulasi. Fitur ini dinonaktifkan secara default. Aktifkan untuk keamanan yang lebih baik.
    */
    .setSecretKey(secretKey)
    /*
     (Opsional) Konfigurasi protokol lapisan transport untuk komunikasi antara SDK dan server. Mengaktifkan HTTPS memberikan keamanan tautan yang lebih tinggi. Perhatikan perbedaan penagihan antara HTTP dan HTTPS. Protokol default adalah HTTP. Aktifkan HTTPS untuk keamanan yang lebih baik.
    */
    .setEnableHttps(enableHttps)
    /*
     (Opsional) Atur periode timeout untuk resolusi nama domain. Satuan: milidetik. Nilai maksimum adalah 5000 ms. Nilai default adalah 2000 ms.
    */
    .setTimeoutMillis(2 * 1000)
    /*
     (Opsional) Tentukan apakah akan mengaktifkan cache lokal. Ini mengoptimalkan waktu yang dibutuhkan untuk resolusi nama domain setelah startup dan meningkatkan kecepatan pemuatan layar pertama. Fitur ini dinonaktifkan secara default. Kami merekomendasikan agar Anda mengaktifkannya dan mengatur durasi cache menjadi 1 hari.
     */
    .setEnableCacheIp(true, 24 * 60 * 60 * 1000)
    /*
     (Opsional) Tentukan apakah akan mengizinkan penggunaan cache yang telah kedaluwarsa. Jika Anda mengaktifkan opsi ini, API dapat langsung mengembalikan alamat IP kedaluwarsa terakhir untuk mengurangi pemblokiran dan meningkatkan performa permintaan. SDK secara asinkron memperbarui hasil resolusi terbaru di latar belakang. Fitur ini diaktifkan secara default.
    */
    .setEnableExpiredIp(true)
    /*
     (Opsional) Aktifkan sniffing dan pengurutan untuk daftar alamat IP dalam hasil resolusi. Tetapkan daftar nama domain dan port untuk deteksi. Kami merekomendasikan Anda mengonfigurasi ini untuk layanan yang sensitif terhadap latensi.
    */
    .setIPRankingList(ipRankingItemJson.toIPRankingList())
    /*
     (Opsional) Konfigurasi antarmuka untuk menyesuaikan TTL cache. Ini mengubah TTL cache default dari DNS otoritatif.
    */
    .configCacheTtlChanger(ttlChanger)
    /*
      (Opsional) Alamat IP beberapa nama domain relatif stabil. Cache untuk nama domain ini tidak perlu sering diperbarui saat jaringan berubah. Anda dapat menggunakan antarmuka ini untuk secara eksplisit memberi tahu SDK.
    */
    .configHostWithFixedIp(hostListWithFixedIp)
    /*
      (Opsional) Konfigurasi kondisi filter untuk nama domain yang tidak menggunakan HTTPDNS untuk resolusi. Untuk nama domain dalam daftar, HTTPDNS langsung mengembalikan 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) {
                // Proses alamat IPv4
                for (ipv4 in httpdnsResult.ips) {
                    address = InetAddress.getByName(ipv4)
                    inetAddresses.add(address)
                }
            }
            if (httpdnsResult.ipv6s != null) {
                // Proses alamat IPv6
                for (ipv6 in httpdnsResult.ipv6s) {
                    address = InetAddress.getByName(ipv6)
                    inetAddresses.add(address)
                }
            }
        } catch (e: UnknownHostException) {
        }
        return if (!inetAddresses.isEmpty()) {
            inetAddresses
            // Penting: Konfigurasikan fallback ke 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) {
                // Proses alamat IPv4
                for (String ipv4 : httpdnsResult.getIps()) {
                    address = InetAddress.getByName(ipv4);
                    inetAddresses.add(address);
                }
            }

            if (httpdnsResult.getIpv6s() != null) {
                // Proses alamat 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);
    }
};