Alibaba Cloud DNS:Android SDK

Ikhtisar

Android SDK merupakan wrapper Java untuk HTTPDNS DoH JSON API. SDK ini menyediakan antarmuka Java bagi aplikasi Android untuk melakukan resolusi nama domain dan mencakup cache lokal yang efisien menggunakan kebijakan Time-to-Live (TTL) dan Least Recently Used (LRU). Anda dapat dengan mudah mengintegrasikan HTTPDNS ke dalam aplikasi Android guna memperbaiki error resolusi domain serta mengaktifkan penjadwalan yang akurat dan berbiaya rendah.

SDK ini menawarkan keunggulan berikut:

• Mudah digunakan

  Integrasikan SDK yang disediakan untuk mengakses layanan HTTPDNS. Metode integrasinya sederhana dan memberikan pengalaman resolusi yang simpel dan nyaman.

• Latensi nol

  SDK menerapkan cache LRU yang menyimpan alamat IP hasil resolusi secara lokal. SDK ini secara proaktif merefresh entri cache berbasis TTL yang telah kedaluwarsa agar data cache tetap mutakhir dan efektif, sehingga memungkinkan resolusi dengan latensi nol.

Untuk panduan implementasi, lihat kode sumber proyek contoh alidns_android_demo.

Integrasi SDK

Tambahkan SDK

allprojects {
  repositories {
    maven {
      url 'https://maven.aliyun.com/repository/public/'
    }
    mavenLocal()
    mavenCentral()
  }
}

dependencies {
     implementation 'com.alibaba.pdns:alidns-android-sdk:2.3.2'
     implementation 'com.google.code.gson:gson:2.8.5'
}

Inisialisasi SDK

Pertama, temukan Account ID Anda di Konsol dan buat kunci untuk mendapatkan AccessKey ID dan AccessKey Secret Anda. Setelah mengintegrasikan SDK, lakukan inisialisasi. Untuk detailnya, lihat contoh kelas Application berikut.

public class DnsCacheApplication extends Application{

    private String accountId = "Your Account ID"; // Setel Account ID Anda dari Konsol.
    private String accessKeyId = "Your AccessKey ID"; // Setel AccessKey ID Anda dari Konsol.
    private String accessKeySecret = "Your AccessKey Secret"; // Setel AccessKey Secret Anda dari Konsol.

    @Override
    public void onCreate() {
       super.onCreate();
       // Setel Account ID, AccessKey ID, dan AccessKey Secret untuk akses SDK.
       DNSResolver.Init(this, accountId, accessKeyId, accessKeySecret); 
       // Catatan: Jika Anda mengonfigurasi domain untuk keep-alive, resolusi akan dipicu secara otomatis saat 75% TTL berlalu. 
       // Hal ini memastikan bahwa resolusi untuk domain tersebut selalu mengenai cache. Namun, jika Anda menggunakan CDN, 
       // TTL bisa sangat singkat, sehingga menyebabkan permintaan yang sering dan meningkatkan biaya. Gunakan metode ini dengan hati-hati.
       DNSResolver.setKeepAliveDomains(new String[]{"your-domain-to-keep-alive-1","your-domain-to-keep-alive-2",...});       
       // Lakukan pre-resolusi untuk domain tertentu guna mendapatkan alamat IPv4. Ganti placeholder domain dengan domain yang ingin Anda resolusi.
       DNSResolver.getInstance().preLoadDomains(DNSResolver.QTYPE_IPV4,new String[]{"your-domain-to-preload-1","your-domain-to-preload-2",...}); 
    }
}

Selain itu, proyek Android Anda harus mendeklarasikan izin akses berikut di AndroidManifest.xml:

<!--Izin yang diperlukan-->
   <uses-permission android:name="android.permission.INTERNET"/>
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
   <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>

Otentikasi SDK

Mulai versi 2.0, SDK mendukung fitur otentikasi untuk mengamankan identitas Anda dan mencegah penggunaan tidak sah. Untuk mengaktifkan HTTPDNS, buat kunci di Konsol untuk mendapatkan AccessKey ID dan AccessKey Secret. Anda harus menyetel parameter otentikasi selama inisialisasi SDK. HTTPDNS menolak permintaan tanpa otentikasi, yang menyebabkan kegagalan resolusi dan berdampak pada layanan Anda.HTTPDNS

Anda dapat menyetel parameter otentikasi sebagai berikut:

DNSResolver.Init(this, accountId, accessKeyId, accessKeySecret);

Permasalahan integrasi SDK

<application
        android:name=".DnsCacheApplication"
        android:icon="@mipmap/ic_launcher"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme"
        android:usesCleartextTraffic="true">

<uses-library android:name="org.apache.http.legacy" android:required="false"/>

ndk.dir=...\\ndk\\21.4.7075529; // Ganti ... dengan path instalasi NDK lokal.

android.useDeprecatedNdk = true;

SDK memungkinkan Anda memilih protokol (HTTP atau HTTPS) untuk permintaan resolusi DNS. Kami merekomendasikan protokol HTTPS default untuk keamanan yang lebih baik. Perhatikan bahwa HTTPDNS menagih berdasarkan permintaan resolusi, dan permintaan HTTPS ditagih lima kali lipat dari permintaan HTTP. Pilih protokol sesuai kebutuhan bisnis Anda.HTTPDNS

  /**
   * Pre-load resolusi nama domain berdasarkan lingkungan jaringan yang terdeteksi secara otomatis (IPv4-only, IPv6-only, atau dual-stack).
   * Di lingkungan jaringan dual-stack, hasil resolusi IPv4 dan IPv6 keduanya di-pre-load. Anda dapat memanggil metode ini selama inisialisasi SDK saat startup aplikasi.
   * Metode ini menyimpan hasil resolusi di cache untuk mengurangi latensi resolusi nama domain berikutnya.
   *
   * @param domains Nama domain yang akan di-pre-load.
   */
   public void preLoadDomains(final String[] domains)

    /**
     * Pre-load resolusi domain untuk tipe catatan tertentu (IPv4 atau IPv6). 
     * Anda dapat memanggil metode ini selama inisialisasi SDK saat startup aplikasi. Metode ini menyimpan hasil resolusi di cache untuk mengurangi latensi resolusi berikutnya.
     *
     * @param qType Tipe catatan yang akan di-pre-load, seperti IPv4 atau IPv6.
     * @param domains Nama domain yang akan di-pre-load.
     */
    public void preLoadDomains(String qType, final String[] domains)
   /**
   * Mendapatkan data resolusi untuk nama domain berdasarkan lingkungan jaringan yang terdeteksi secara otomatis (IPv4-only, IPv6-only, atau dual-stack).
   * Jika hasil resolusi yang belum kedaluwarsa ada di cache, hasil dari cache dikembalikan.
   * Jika cache kosong atau hasil cache telah kedaluwarsa, permintaan jaringan sinkron dikirim ke server untuk mendapatkan hasil resolusi rekursif. Hasil tersebut kemudian dikembalikan dan disimpan di cache.
   *
   * @param host Nama domain yang ingin Anda resolusi.
   * @return Array alamat IP optimal berdasarkan lingkungan jaringan saat ini.
   */
    public String[] getIpsByHost(String host)

/**
    * Mendapatkan array catatan IPv4 yang sesuai dengan hostname.
    * Jika hasil resolusi yang belum kedaluwarsa ada di cache, hasil dari cache dikembalikan.
    * Jika cache kosong atau hasil cache telah kedaluwarsa, permintaan jaringan sinkron dikirim ke server untuk mendapatkan hasil resolusi rekursif. Hasil tersebut kemudian dikembalikan dan disimpan di cache.
    *
    * @param hostName Hostname, seperti www.example.com.
    * @return Array alamat IPv4 yang sesuai dengan hostname.
    */
  public  String[] getIPsV4ByHost(String hostName) 

   /**
    * Mendapatkan array catatan IPv6 yang sesuai dengan hostname.
    * @param hostName Hostname, seperti www.example.com.
    * @return Array alamat IPv6 yang sesuai dengan hostname.
    */
  public String[] getIPsV6ByHost(String hostName) 

  

  /**
   * Mendapatkan array alamat IP untuk nama domain yang telah diresolusi dari cache berdasarkan lingkungan jaringan yang terdeteksi secara otomatis (IPv4-only, IPv6-only, atau dual-stack).
   * Jika cache kosong, metode ini mengembalikan null dan memulai kueri asinkron. Hasil kueri kemudian disimpan di cache.
   * Jika hasil resolusi ada di cache dan Anda mengizinkan pengembalian hasil kedaluwarsa, alamat IP kedaluwarsa dikembalikan, dan cache diperbarui secara asinkron.
   * Jika Anda tidak mengizinkan pengembalian hasil kedaluwarsa dan hasil cache telah kedaluwarsa, metode ini mengembalikan null lalu memperbarui cache secara asinkron.
   *
   * @param host Host yang akan dikueri, seperti www.example.com.
   * @param isAllowExp Menentukan apakah akan mengembalikan data resolusi domain yang kedaluwarsa.
   * @return Array alamat IP yang di-cache untuk host yang telah diresolusi.
   */
   public String[] getIpsByHostFromCache(String host, boolean isAllowExp)
   
    /**
     * Mendapatkan array alamat IP tipe catatan IPv4 untuk nama domain yang telah diresolusi dari cache.
     * Jika cache kosong, metode ini mengembalikan null dan memulai kueri asinkron. Hasil kueri kemudian disimpan di cache.
     * Jika hasil resolusi ada di cache dan Anda mengizinkan pengembalian hasil kedaluwarsa, alamat IP kedaluwarsa dikembalikan, dan cache diperbarui secara asinkron.
     * Jika Anda tidak mengizinkan pengembalian hasil kedaluwarsa dan hasil cache telah kedaluwarsa, metode ini mengembalikan null lalu memperbarui cache secara asinkron.
     *
     * @param host Host yang akan dikueri, seperti www.example.com.
     * @param isAllowExp Menentukan apakah akan mengembalikan data resolusi domain yang kedaluwarsa.
     * @return Array alamat IP tipe catatan IPv4 dari cache setelah host diresolusi.
     */
    public String[] getIpv4ByHostFromCache(String host , boolean isAllowExp)

    /**
     * Mendapatkan array alamat IP tipe catatan IPv6 untuk nama domain yang telah diresolusi dari cache.
     * Jika cache kosong, metode ini mengembalikan null dan memulai kueri asinkron. Hasil kueri kemudian disimpan di cache.
     * Jika hasil resolusi ada di cache dan Anda mengizinkan pengembalian hasil kedaluwarsa, alamat IP kedaluwarsa dikembalikan, dan cache diperbarui secara asinkron.
     * Jika Anda tidak mengizinkan pengembalian hasil kedaluwarsa dan hasil cache telah kedaluwarsa, metode ini mengembalikan null lalu memperbarui cache secara asinkron.
     *
     * @param host Host yang akan dikueri, seperti www.example.com.
     * @param isAllowExp Menentukan apakah akan mengembalikan data resolusi domain yang kedaluwarsa.
     * @return Array alamat IP tipe catatan IPv6 dari cache setelah host diresolusi.
     */
    public String[] getIpv6ByHostFromCache(String host , boolean isAllowExp)

  /**
  * Mendapatkan array objek DomainInfo untuk catatan IPv4 yang sesuai dengan URL.
  * Jika hasil resolusi yang belum kedaluwarsa ada di cache, hasil dari cache dikembalikan.
  * Jika cache kosong atau hasil cache telah kedaluwarsa, permintaan jaringan sinkron dikirim ke server untuk mendapatkan hasil resolusi rekursif. Hasil tersebut kemudian dikembalikan dan disimpan di cache.
  *
  * @param url URL, seperti http://www.example.com.
  * @return Array objek DomainInfo tipe IPv4 yang sesuai dengan URL.
  */
  public DomainInfo[] getIPsV4DInfoByUrl(String url) 

  Catatan: URL dalam objek DomainInfo adalah URL yang host-nya secara otomatis diganti dengan alamat IP. Anda tidak perlu mengganti host di URL secara manual.

  /**
   * Mendapatkan array objek DomainInfo untuk catatan IPv6 yang sesuai dengan URL.
   * Jika hasil resolusi yang belum kedaluwarsa ada di cache, hasil dari cache dikembalikan.
   * Jika cache kosong atau hasil cache telah kedaluwarsa, permintaan jaringan sinkron dikirim ke server untuk mendapatkan hasil resolusi rekursif. Hasil tersebut kemudian dikembalikan dan disimpan di cache.
   * 
   * @param url URL, seperti http://m.example.com.
   * @return Array objek DomainInfo tipe IPv6 yang sesuai dengan URL.
   */
   public DomainInfo[] getIPsV6DInfoByUrl(String url) 

  /**
    * Mendapatkan objek DomainInfo untuk catatan IPv4 yang sesuai dengan URL tertentu.
    * Jika hasil resolusi yang belum kedaluwarsa ada di cache, hasil dari cache dikembalikan.
    * Jika cache kosong atau hasil cache telah kedaluwarsa, permintaan jaringan sinkron dikirim ke server untuk mendapatkan hasil resolusi rekursif. Hasil tersebut kemudian dikembalikan dan disimpan di cache.
    *
    * @param url URL, seperti http://m.example.com.
    * @return Objek DomainInfo acak dari kumpulan objek DomainInfo tipe IPv4 yang sesuai dengan URL.
    */
    public DomainInfo getIPV4DInfoByUrl(String url) 


  /**
    * Mendapatkan objek DomainInfo untuk catatan IPv6 yang sesuai dengan URL tertentu.
    * Jika hasil resolusi yang belum kedaluwarsa ada di cache, hasil dari cache dikembalikan.
    * Jika cache kosong atau hasil cache telah kedaluwarsa, permintaan jaringan sinkron dikirim ke server untuk mendapatkan hasil resolusi rekursif. Hasil tersebut kemudian dikembalikan dan disimpan di cache.
    *
    * @param url URL, seperti http://www.example.com.
    * @return Objek DomainInfo acak dari kumpulan objek DomainInfo tipe IPv6 yang sesuai dengan URL.
    */
   public DomainInfo getIPV6DInfoByUrl(String url) 

   Catatan: Objek DomainInfo yang dikembalikan membungkus properti berikut.

  /**
   * ID auto-increment untuk domain akses.
    */
    public String id = null;

   /**
    * URL yang dapat digunakan langsung. Host di URL diganti dengan alamat IP.
    */
     public String url = null;

    /**
    * Nama layanan tujuan yang akan disetel di Header HTTP.
    */
    public String host = "";

   /**
    * Body konten yang dikembalikan.
    */
   public String data = null;

   /**
    * Waktu permintaan dimulai.
    */
   public String startTime = null;

   /**
    * Waktu permintaan berakhir. Jika permintaan timeout, nilai ini null.
    */
   public String stopTime = null; 

   /**
   * Kode status yang dikembalikan oleh server, seperti 200, 404, atau 500. 
   */
   public String code = null;

  /**
    * Mendapatkan catatan IPv4 yang sesuai dengan hostname.
    * Jika hasil resolusi yang belum kedaluwarsa ada di cache, hasil dari cache dikembalikan.
     * Jika cache kosong atau hasil cache telah kedaluwarsa, permintaan jaringan sinkron dikirim ke server untuk mendapatkan hasil resolusi rekursif. Hasil tersebut kemudian dikembalikan dan disimpan di cache.
  
    * @param hostName Hostname, seperti www.example.com.
    * @return Alamat IPv4 acak dari kumpulan alamat IPv4 yang sesuai dengan hostname. Jika pengujian kecepatan IP diaktifkan, alamat IPv4 optimal dikembalikan.
    */
  public String getIPV4ByHost(String hostName) 

   /**
    * Mendapatkan catatan IPv6 yang sesuai dengan hostname.
    * Jika hasil resolusi yang belum kedaluwarsa ada di cache, hasil dari cache dikembalikan.
    * Jika cache kosong atau hasil cache telah kedaluwarsa, permintaan jaringan sinkron dikirim ke server untuk mendapatkan hasil resolusi rekursif. Hasil tersebut kemudian dikembalikan dan disimpan di cache.
  
    * @param hostName Hostname, seperti www.example.com.
    * @return Alamat IPv6 acak dari kumpulan alamat IPv6 yang sesuai dengan hostname. Jika pengujian kecepatan IP diaktifkan, alamat IPv6 optimal dikembalikan.
    */
   public String getIPV6ByHost(String hostName) 
      

    /**
     * Mendapatkan statistik tentang permintaan HTTPDNS yang berhasil dan gagal.
     *
     * @return String array JSON dari statistik resolusi untuk semua nama domain.
     */
    public String getRequestReportInfo()
    
     /**
     * Menyetel nama domain untuk cache keep-alive. Resolusi nama domain yang dikonfigurasi secara otomatis dipicu saat 75% TTL berlalu. Hal ini memastikan bahwa permintaan resolusi untuk nama domain yang dikonfigurasi selalu mengenai cache dan meningkatkan efisiensi resolusi SDK.
     * Kami menyarankan agar Anda tidak mengonfigurasi terlalu banyak nama domain untuk fitur ini. Batas saat ini adalah 10 nama domain. Fitur ini dikonfigurasi secara independen dari fitur pre-resolusi.
     *
     * @param persistentCacheDomains
     */
    public synchronized static void setKeepAliveDomains(String[] persistentCacheDomains) {
    
     /**
     * Menghapus cache untuk nama domain tertentu. Jika hostname null, cache untuk semua nama domain dihapus.
     *
     * @param domains Array nama domain yang cachenya ingin Anda hapus.
     */
    public void clearHostCache(String[] domains){

URL: Alamat akses yang diteruskan, misalnya, http://www.example.com.

 String hostname = "www.taobao.com";
 String url = "http://www.taobao.com";

1. Dapatkan data IP optimal untuk lingkungan jaringan saat ini

String[] ip = DNSResolver.getInstance().getIpsByHost(hostname); // Mendapatkan IP resolusi domain optimal untuk jaringan saat ini.

2. Pre-load resolusi domain berdasarkan lingkungan jaringan saat ini

DNSResolver.getInstance().preLoadDomains(domains); // Menyetel nama domain untuk pre-resolusi. Ganti placeholder domain dengan domain yang ingin Anda resolusi oleh HTTPDNS.

3. Baca data resolusi domain dari cache berdasarkan lingkungan jaringan saat ini

String[] ip = DNSResolver.getInstance().getIpsByHostFromCache(hostname,true); // Mendapatkan data resolusi domain dari cache untuk lingkungan jaringan saat ini.

4. Dapatkan alamat IPv4

String IPV4 = DNSResolver.getInstance().getIPV4ByHost(hostname); // Mendapatkan alamat IPv4 yang telah diresolusi.

5. Dapatkan alamat IPv6

String IPV6 =  DNSResolver.getInstance().getIPV6ByHost(hostname); // Mendapatkan alamat IPv6 yang telah diresolusi.

6. Dapatkan alamat IPv4 yang telah diresolusi dari cache

String[] IPV4 =  DNSResolver.getInstance().getIpv4ByHostFromCache(hostname , true); // Mendapatkan alamat IPv4 yang telah diresolusi dari cache.

7. Dapatkan alamat IPv6 yang telah diresolusi dari cache

String[] IPV6 =  DNSResolver.getInstance().getIpv6ByHostFromCache(hostname , true); // Mendapatkan alamat IPv6 yang telah diresolusi dari cache.

8. Dapatkan objek DomainInfo yang sesuai dengan URL

DomainInfo dinfo = DNSResolver.getInstance().getIPV4DInfoByUrl(url); // Mendapatkan URL yang telah diganti.

9. Hapus hasil resolusi domain tertentu dari cache

DNSResolver.getInstance().clearHostCache(hostName); // Menghapus cache untuk domain tertentu. Jika hostName disetel ke null, cache untuk semua domain dihapus.

10. Dapatkan statistik tentang permintaan HTTPDNS yang berhasil dan gagal

String reportInfo = DNSResolver.getInstance().getRequestReportInfo(); // Mendapatkan statistik tentang permintaan yang berhasil dan gagal.

Tabel berikut menjelaskan bidang dalam array string JSON statistik resolusi domain.

 [
      {
         "avgRtt":"1",                         // Waktu resolusi domain rata-rata, dalam milidetik (ms).
         "degradeLocalDnsCount": 0,            // Jumlah fallback ke DNS lokal.                       
         "domainName":"www.example.com",       // Nama domain yang diresolusi.
         "hitDnsCacheCount": 1,                // Jumlah hit cache.
         "httpabnormalCount": 0,               // Jumlah permintaan rekursif yang gagal.
         "isp": "China Mobile",                // Nama ISP.
         "localDnsResolveErrCount": 0,         // Jumlah kegagalan resolusi DNS lokal.
         "maxRtt": 8.0,                        // Waktu resolusi domain maksimum, dalam milidetik (ms).          
         "nonetworkCount": 0,                  // Jumlah kali jaringan tidak tersedia.
         "permissionErrCount": 0,              // Jumlah kegagalan otentikasi pengguna.
         "queryType": 1,                       // Tipe IP. 1 menunjukkan IPv4, dan 28 menunjukkan IPv6.
         "recursiveReqCount": 1,               // Jumlah kueri rekursif.
         "reqParameterErrCount": 0,            // Jumlah kesalahan format parameter permintaan.
         "reqPathErrCount": 0,                 // Jumlah kesalahan URL.
         "reqServerErrCount": 0,               // Jumlah kesalahan sisi server DNS.
         "reqTimeoutCount": 0,                 // Jumlah kesalahan timeout layanan DNS.
         "resolveSuccessCount": 1,             // Jumlah resolusi yang berhasil.
         "timeoutCount": 0,                    // Jumlah kesalahan timeout jaringan.
         "utfNetWorkErroNum": 0                // Jumlah kesalahan timeout pelaporan data.
      }
         ......
 ]

Contoh

public class MainActivity extends AppCompatActivity {
   private Button button;
   private TextView tvInfo;
   private TextView tvResult;
   private String hostUrl = "http://www.taobao.com"; // Ganti ini dengan hostUrl yang ingin Anda resolusi.
   private String hostName = "www.taobao.com"; // Ganti ini dengan hostName yang ingin Anda resolusi.
   private static final String TAG = "PDnsDemo";
   private static ExecutorService pool = Executors.newSingleThreadExecutor();
   private static final String PDNS_RESULT = "pdns_result";
   private static final int SHOW_CONSOLE_TEXT = 10000;
   private Handler mHandler;

   @Override
   protected void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       setContentView(R.layout.demo_activity_main);
       init();
       initHandler();
   }

 private void init() {
       tvInfo = findViewById(R.id.tv_respons_info);
       tvResult = findViewById(R.id.tv_respons);
       button = findViewById(R.id.btn_onclik);
       button.setOnClickListener(new View.OnClickListener() {
           public void onClick(View view) {
               new Thread(new Runnable() {
                      @Override
                      public void  run() {
                      // Panggil metode getIPV4ByHost di SDK HTTPDNS untuk mendapatkan alamat IP yang diresolusi dari nama domain target.
                      String ip = DNSResolver.getInstance().getIPV4ByHost(hostName);
                      if(ip != null){
                         tvInfo.setText("Alamat IP yang diresolusi untuk domain tersebut adalah: "+ ip);
                      }
                      // Panggil metode getIPV4DInfoByUrl di SDK HTTPDNS untuk mendapatkan URL dari objek DomainInfo yang diresolusi. 
                      // Host di URL ini diganti dengan alamat IP.
                      DomainInfo dinfo = DNSResolver.getInstance().getIPV4DInfoByUrl(hostUrl);
                      if (dinfo != null) {
                           showResponse(dinfo);
                      }
                   }
               }).start();
           }
       });
   }

   private void initHandler() {
       mHandler = new Handler() {
           @Override
           public void handleMessage(Message msg) {
               switch (msg.what)  {
                   case SHOW_CONSOLE_TEXT:
                       tvResult.setText(msg.getData().getString(PDNS_RESULT) + "\n");
                       break;
               }
           }
       };
   }

   private void showResponse(final DomainInfo dinfo) {
                // Mengirim permintaan jaringan.
               String requestUrl = dinfo.url;
               HttpURLConnection conn = null;
               try {
                   URL url = new URL(requestUrl);
                   conn = (HttpURLConnection) url.openConnection();
                   // Saat Anda menggunakan alamat IP untuk akses, Anda harus menyetel bidang Host di Header permintaan HTTP ke nama domain asli.
                   conn.setRequestProperty("Host", url.getHost()); // Menyetel bidang Host di Header permintaan HTTP.
                   DataInputStream dis = new DataInputStream(conn.getInputStream());
                   int len;
                   byte[] buff = new byte[4096];
                   StringBuilder response = new StringBuilder();
                   while ((len = dis.read(buff)) != -1) {
                       response.append(new String(buff, 0, len));
                   }
                   Log.d(TAG, "Respons: " + response.toString());
                   dis.close();
                   sendMessage(response.toString());
               } catch (IOException e) {
                   e.printStackTrace();
               }finally {
                   if (conn != null) {
                       conn.disconnect();
                   }
               }
           }

   private void sendMessage(String message) {
       if (mHandler != null) {
               Message msg = mHandler.obtainMessage();
               Bundle bundle = new Bundle();
               bundle.putString(PDNS_RESULT, message);
               msg.setData(bundle);
               msg.what = SHOW_CONSOLE_TEXT;
               mHandler.sendMessage(msg);
       }
   }
}

public class DnsCacheApplication extends Application {
    
    private String accountId = "Your Account ID"; // Setel Account ID Anda dari Konsol.
    private String accessKeyId = "Your AccessKey ID"; // Setel AccessKey ID Anda dari Konsol.
    private String accessKeySecret = "Your AccessKey Secret"; // Setel AccessKey Secret Anda dari Konsol.

    @Override
    public void onCreate() {
       super.onCreate();
       // Setel Account ID, AccessKey ID, dan AccessKey Secret untuk akses SDK.
       DNSResolver.Init(this, accountId, accessKeyId, accessKeySecret); 
       // Menyetel nama domain untuk cache keep-alive. Resolusi nama domain yang dikonfigurasi secara otomatis dipicu saat 75% TTL-nya berlalu untuk memastikan permintaan resolusi untuk nama domain tersebut selalu mengenai cache.
       DNSResolver.setKeepAliveDomains(new String[]{"your-domain-1","your-domain-2",...}); 
       // Pre-load domain tertentu ke alamat IPv4. Ganti placeholder domain dengan domain yang ingin Anda resolusi.
       DNSResolver.getInstance().preLoadDomains(DNSResolver.QTYPE_IPV4,new String[]{"your-domain-to-preload-1","your-domain-to-preload-2",...}); 
    }
}

Praktik terbaik

Untuk kinerja optimal, gunakan pre-resolusi dan izinkan respons kedaluwarsa.

Dalam skenario dengan persyaratan tinggi terhadap kinerja jaringan, Anda dapat menggabungkan pre-resolusi dengan strategi mengizinkan respons kedaluwarsa untuk secara signifikan meningkatkan kecepatan resolusi DNS dan bahkan mencapai resolusi "latensi nol".

Berkat cache bawaan SDK, permintaan resolusi berikutnya untuk domain yang telah di-pre-load dapat langsung mengenai cache. Hal ini menghindari round-trip jaringan dan sangat meningkatkan pengalaman pengguna.

1. Pre-resolusi

Aktifkan caching dan pre-resolve domain kunci. Kami menyarankan Anda melakukan operasi ini saat aplikasi dimulai.

Pada metode onCreate() Application, lakukan pra-resolusi nama-nama domain yang digunakan oleh aplikasi Anda dan cache hasilnya di memori lokal.

1. Skenario IPv4-only

//********Untuk skenario IPv4-only*******
public class DnsCacheApplication extends Application{
    private String accountId = "Your Account ID"; // Setel Account ID Anda dari Konsol.
    private String accessKeyId = "Your AccessKey ID"; // Setel AccessKey ID Anda dari Konsol.
    private String accessKeySecret = "Your AccessKey Secret"; // Setel AccessKey Secret Anda dari Konsol.

    @Override
    public void onCreate() {
       super.onCreate();
       // Setel Account ID, AccessKey ID, dan AccessKey Secret untuk akses SDK.
       DNSResolver.Init(this, accountId, accessKeyId, accessKeySecret); 
       DNSResolver.setEnableCache(true); // Aktifkan caching. Nilai default: true. 
       // Tipe catatan IPv4 untuk pre-resolusi.    
       // Pre-load domain tertentu ke alamat IPv4. Ganti placeholder domain dengan domain yang ingin Anda resolusi oleh HTTPDNS.
       DNSResolver.getInstance().preLoadDomains(DNSResolver.QTYPE_IPV4,new String[]{"your-domain-to-preload-1","your-domain-to-preload-2",...}); 
    }
}

2. Dukungan IPv6

//********Untuk skenario yang memerlukan dukungan IPv6*******
public class DnsCacheApplication extends Application{
    private String accountId = "Your Account ID"; // Setel Account ID Anda dari Konsol.
    private String accessKeyId = "Your AccessKey ID"; // Setel AccessKey ID Anda dari Konsol.
    private String accessKeySecret = "Your AccessKey Secret"; // Setel AccessKey Secret Anda dari Konsol.

    @Override
    public void onCreate() {
       super.onCreate();
       // Setel Account ID, AccessKey ID, dan AccessKey Secret untuk akses SDK.
       DNSResolver.Init(this, accountId, accessKeyId, accessKeySecret); 
       DNSResolver.setEnableCache(true); // Aktifkan caching. Nilai default: true.
       DNSResolver.setEnableIPv6(true); // Menentukan apakah akan meresolusi nama domain melalui jaringan IPv6. Nilai default: false.  
       DNSResolver.setEnableSpeedTest(true); // Menentukan apakah akan mengaktifkan pengujian kecepatan IP. Nilai default: false.
       // Tipe catatan IPv4 dan IPv6 untuk pre-resolusi.  
       // Pre-load domain tertentu ke alamat IPv4 dan IPv6. Ganti placeholder domain dengan domain yang ingin Anda resolusi oleh HTTPDNS.
       DNSResolver.getInstance().preLoadDomains(DNSResolver.QTYPE_IPV4_IPV6,new String[]{"your-domain-to-preload-1","your-domain-to-preload-2",...}); 
    }
}

2. Izinkan respons kedaluwarsa

Utamakan penggunaan cache untuk resolusi dan izinkan pengembalian alamat IP kedaluwarsa. Sebelum memulai permintaan jaringan, dapatkan alamat IP dari cache dan izinkan penggunaan catatan cache kedaluwarsa namun masih ada. Dengan cara ini, meskipun TTL telah berakhir, hasil tetap dapat dikembalikan segera selama cache belum dihapus. Hal ini membantu mencapai resolusi "tanpa tunggu".

1. Skenario IPv4-only

    //********Untuk skenario IPv4-only*******
    @Override
    public List<InetAddress> lookup(@NonNull String hostname) throws UnknownHostException {
        // Utamakan mendapatkan alamat IP dari cache. Parameter kedua, jika true, mengizinkan pengembalian catatan kedaluwarsa namun masih dapat digunakan.
        String[] IPArray = mDNSResolver.getIpv4ByHostFromCache(hostname,true);
        if (IPArray == null || IPArray.length == 0){
            // Jika cache tidak terkena, mulai resolusi asinkron.
            IPArray = mDNSResolver.getIPsV4ByHost(hostname);
        }
        if (IPArray != null && IPArray.length > 0) {
            List<InetAddress> inetAddresses = new ArrayList<>();
            InetAddress address;
            for (String ip : IPArray) {
                address = InetAddress.getByName(ip);
                inetAddresses.add(address);
            }
            if (!inetAddresses.isEmpty()) {
                return inetAddresses;
            }
        }
        return okhttp3.Dns.SYSTEM.lookup(hostname);
    }

2. Dukungan IPv6

    //********Untuk skenario yang memerlukan dukungan IPv6*******
    @Override
    public List<InetAddress> lookup(@NonNull String hostname) throws UnknownHostException {
        // Utamakan mendapatkan alamat IP dari cache. Parameter kedua, jika true, mengizinkan pengembalian catatan kedaluwarsa namun masih dapat digunakan.
        String[] IPArray = mDNSResolver.getIpsByHostFromCache(hostname,true);
        if (IPArray == null || IPArray.length == 0){
            // Jika cache tidak terkena, mulai resolusi asinkron.
            IPArray = mDNSResolver.getIpsByHost(hostname);
        }
        if (IPArray != null && IPArray.length > 0) {
            List<InetAddress> inetAddresses = new ArrayList<>();
            InetAddress address;
            for (String ip : IPArray) {
                address = InetAddress.getByName(ip);
                inetAddresses.add(address);
            }
            if (!inetAddresses.isEmpty()) {
                return inetAddresses;
            }
        }
        return okhttp3.Dns.SYSTEM.lookup(hostname);
    }

Catatan

1. Setelah mendapatkan alamat IP nama domain menggunakan HTTPDNS, klien dapat menggunakan alamat IP ini untuk mengirim permintaan layanan. Anda harus mengubah bidang Host di Header permintaan HTTP ke nama domain asli.

2. Untuk memastikan layanan Anda berjalan sesuai harapan, jika alamat IP yang dikembalikan oleh SDK HTTPDNS untuk resolusi nama domain kosong, Anda harus menggunakan URL permintaan nama domain asli untuk melakukan permintaan fallback. Kode berikut memberikan contohnya:

   String ip = DNSResolver.getInstance().getIPV4ByHost("your-domain");
   if (ip != null) {
   	// Ganti host di URL dengan alamat IP untuk membuat permintaan API.
   }else {
   	// Gunakan URL permintaan nama domain asli untuk melakukan permintaan fallback. 
       // Dalam hal ini, gunakan URL asli yang berisi nama domain untuk membuat permintaan jaringan.
   }

3. Untuk membantu Anda memulai dengan SDK HTTPDNS, kami menyediakan program demo yang dapat Anda unduh dan gunakan sebagai referensi. Klik di sini untuk mengunduh program demo.

4. Setelah mengintegrasikan SDK, periksa halaman Analisis Trafik di Konsol untuk memverifikasi bahwa integrasi berhasil. Jika tidak ada trafik yang dihasilkan, periksa apakah parameter Account ID, AccessKey ID, dan AccessKey Secret telah disetel dengan benar.

DNS On-premises

Mulai v2.3.0, SDK Android HTTPDNS menambahkan dukungan untuk penyebaran DNS on-premises.

Mode DNS on-premises cocok untuk skenario dengan persyaratan tinggi terhadap kepatuhan data dan kebijakan resolusi kustom, seperti keuangan, pemerintahan, dan perusahaan Internet besar. SDK mendukung empat mode penyebaran khas: hanya DNS cloud publik, hanya DNS on-premises, dan hybrid primary-standby (DNS cloud publik dan DNS on-premises saling menjadi fallback). Hal ini memungkinkan adaptasi fleksibel terhadap arsitektur layanan yang berbeda.

Kemampuan inti

• Dukungan penyebaran on-premises: Mendukung konfigurasi endpoint layanan DNS on-premises menggunakan alamat IPv4/IPv6 atau nama domain host.

• Otentikasi dua arah: Mekanisme ini menandatangani permintaan dengan accessKeyId dan accessKeySecret khusus pelanggan untuk memastikan komunikasi aman.

• Pemutusan sirkuit dan pemeriksaan kesehatan: Jika node DNS on-premises gagal 3 kali berturut-turut atau lebih, pemutusan sirkuit dipicu secara otomatis. Setelah itu, ketersediaannya diperiksa setiap menit menggunakan healthCheckDomain yang ditentukan. Node tersebut diaktifkan kembali secara otomatis setelah pulih.

• Kontrol validasi sertifikat: Mulai versi 2.3.1.beta, Anda dapat menonaktifkan validasi sertifikat TLS untuk pengujian DNS on-premises. Versi beta hanya untuk pengujian dan tidak boleh digunakan di produksi. Unduh versi beta

• Fallback cerdas: Jika DNS primer (DNS cloud publik atau DNS on-premises) gagal meresolusi nama domain dan jumlah kegagalannya mencapai ambang batas yang ditentukan, sistem secara otomatis beralih ke DNS standby untuk memastikan ketersediaan tinggi untuk resolusi.

• Kompatibilitas API mulus: Baik Anda menggunakan DNS cloud publik maupun DNS on-premises, cara memanggil API resolusi tetap sama. Anda tidak perlu memodifikasi logika bisnis Anda.

Konfigurasi

DNSResolver.Init(this, accountID, accessKeyId, accessKeySecret);

DNSResolver.InitFusionDNS(this,new String[]{"1.1.X.X","2.2.X.X"},null,null,"443", "check.example.com", "your_fusion_ak", "your_fusion_sk");
// Opsional: Nonaktifkan validasi sertifikat (hanya untuk lingkungan pengujian, memerlukan versi SDK beta, misalnya 2.3.1.beta).
// DNSResolver.setEnableCertificateValidation(false);

// Primer: DNS cloud publik
DNSResolver.Init(this, accountID, accessKeyId, accessKeySecret);
    
// Standby: DNS on-premises
DNSResolver.InitFusionDNS(this,new String[]{"1.1.X.X","2.2.X.X"},null,null,"443", "check.example.com", "your_fusion_ak", "your_fusion_sk");
// Opsional: Nonaktifkan validasi sertifikat (hanya untuk lingkungan pengujian, memerlukan versi SDK beta, misalnya 2.3.1.beta).
// DNSResolver.setEnableCertificateValidation(false);

// Primer: DNS on-premises
DNSResolver.InitFusionDNS(this,new String[]{"1.1.X.X","2.2.X.X"},null,null,"443", "check.example.com", "your_fusion_ak", "your_fusion_sk");
// Opsional: Nonaktifkan validasi sertifikat (hanya untuk lingkungan pengujian, memerlukan versi SDK beta, misalnya 2.3.1.beta).
// DNSResolver.setEnableCertificateValidation(false);

// Standby: DNS cloud publik
DNSResolver.Init(this, accountID, accessKeyId, accessKeySecret);

API Baru

Untuk mendukung penyebaran on-premises dan pemulihan bencana ketersediaan tinggi untuk DNS on-premises, SDK menambahkan tiga antarmuka inti berikut. Gunakan antarmuka ini untuk mengonfigurasi layanan DNS on-premises, mengontrol kebijakan keamanan, dan menerapkan fallback primer-standby otomatis.

    /** Untuk DNS on-premises yang digunakan dalam penyebaran on-premises. Anda tidak perlu memanggil metode ini jika hanya menggunakan DNS publik.
     *
     * Menyetel alamat dan informasi otentikasi untuk server DNS on-premises.
     * Pelanggan menggunakan antarmuka ini untuk meneruskan alamat dan kredensial otentikasi server DNS privat.
     * SDK menggunakan informasi ini untuk memulai permintaan.
     * @param ctx Konteks.
     * @param serverIpv4Arr Array alamat IPv4 (bisa null).
     * @param serverIpv6Arr Array alamat IPv6 (bisa null).
     * @param serverHostArr Array nama domain host (bisa null).
     * @param port Port layanan, seperti "443". Jika null, port default "443" digunakan.
     * @param healthCheckDomain Nama domain yang digunakan untuk pemeriksaan kesehatan setelah pemutusan sirkuit dipicu. Saat layanan resolusi gagal berturut-turut lebih dari tiga kali, pemutusan sirkuit dipicu, dan alamat IP layanan tersebut memasuki status healthCheck. Permintaan berikutnya tidak akan dikirim ke layanan ini. 
     *                          Timer berjalan setiap menit untuk memanggil API resolusi menggunakan healthCheckDomain ini guna memeriksa apakah layanan resolusi tersedia. Jika probe berhasil, layanan kembali ke status alive, dan permintaan berikutnya dapat dikirim ke layanan ini.
     * @param accessKeyId accessKeyId privat pelanggan, yang digunakan untuk otentikasi.
     * @param accessKeySecret accessKeySecret privat pelanggan, yang digunakan untuk otentikasi.
     */
    public static void InitFusionDNS(Context ctx,String[] serverIpv4Arr, String[] serverIpv6Arr, String[] serverHostArr, String port, String healthCheckDomain, String accessKeyId, String accessKeySecret)

    /** Untuk DNS on-premises yang digunakan dalam penyebaran on-premises. Anda tidak perlu memanggil metode ini jika hanya menggunakan DNS publik.
     *
     * Menentukan apakah akan mengaktifkan validasi sertifikat untuk DNS on-premises. Nilai default: true. Jika server tidak dikonfigurasi dengan sertifikat domain atau sertifikat IP, Anda dapat menyetel parameter ini ke false untuk pengujian. Di lingkungan produksi, kami sangat menyarankan Anda menyetel parameter ini ke true. Jika tidak, risiko keamanan mungkin timbul.
     * @param enable Setel parameter ini ke true untuk mengaktifkan validasi sertifikat (default), atau false untuk menonaktifkannya.
     */
    public static void setEnableCertificateValidation(boolean enable)

    /** Jika Anda mengonfigurasi DNS cloud publik dan DNS on-premises, Anda dapat menentukan jumlah kali kegagalan resolusi DNS pada DNS primer sebelum sistem secara otomatis fallback ke DNS standby. Jika Anda hanya mengonfigurasi satu jenis DNS, Anda tidak perlu memanggil metode ini.
     *
     * Menentukan jumlah kali kegagalan resolusi DNS pada DNS primer sebelum sistem secara otomatis fallback ke DNS standby. Jika Anda hanya mengonfigurasi satu jenis DNS, Anda tidak perlu memanggil metode ini.
     * @param fallbackThreshold Ambang batas kegagalan. Default: 4 jika DNS primer adalah DNS cloud publik, atau 2 jika DNS primer adalah DNS on-premises.
     * Rentang valid: [0, 4]. Nilai 0 menunjukkan fallback segera.
     */
     public static void setFallbackThreshold(int fallbackThreshold)