Alibaba Cloud DNS:Android SDK development guide

概要

Android SDK は、モバイル解決 HTTPDNS の DoH JSON API の Java ラッパーです。Android アプリがドメイン名を解決するための Java インターフェイスを提供し、Time-to-Live (TTL) と Least Recently Used (LRU) ポリシーを使用する効率的なローカルキャッシュを備えています。モバイル解決 HTTPDNS を Android アプリに統合することで、ドメイン名前解決のエラーを修正し、正確で低コストのスケジューリングを可能にします。

主な利点：

• シンプルな使用方法

  最小限のコードで モバイル解決 HTTPDNS サービスにアクセスできます。

• ゼロレイテンシー

  LRU キャッシュは解決済みの IP をローカルに保存し、TTL の有効期限が切れる前にエントリを事前に更新することで、ゼロレイテンシーの解決を可能にします。

実装リファレンスとして、alidns_android_demo サンプルプロジェクトをダウンロードしてご参照ください。

SDK の統合

SDK の追加

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

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

SDK の初期化

コンソールからアカウント ID を取得し、キーを作成して AccessKey ID と AccessKey Secret を取得します。次に、この Application クラスの例に示すように SDK を初期化します。

public class DnsCacheApplication extends Application{

    private String accountId = "ご利用のアカウント ID"; // コンソールから取得したアカウント ID を設定します。
    private String accessKeyId = "ご利用の AccessKey ID"; // コンソールから取得した AccessKey ID を設定します。
    private String accessKeySecret = "ご利用の AccessKey Secret"; // コンソールから取得した AccessKey Secret を設定します。

    @Override
    public void onCreate() {
       super.onCreate();
       // SDK アクセスのためにアカウント ID、AccessKey ID、AccessKey Secret を設定します。
       DNSResolver.Init(this, accountId, accessKeyId, accessKeySecret); 
       // 注意：キープアライブ対象のドメインを設定すると、TTL の 75% が経過した時点で自動的に名前解決がトリガーされます。
       // これにより、これらのドメインの名前解決は常にキャッシュにヒットします。ただし、CDN を使用している場合、
       // TTL が短くなる可能性があり、リクエストが頻繁になりコストが増加する可能性があります。このメソッドは注意して使用してください。
       DNSResolver.setKeepAliveDomains(new String[]{"your-domain-to-keep-alive-1","your-domain-to-keep-alive-2",...});       
       // 指定されたドメインの事前解決を実行して IPv4 アドレスを取得します。プレースホルダードメインを解決したいドメインに置き換えてください。
       DNSResolver.getInstance().preLoadDomains(DNSResolver.QTYPE_IPV4,new String[]{"your-domain-to-preload-1","your-domain-to-preload-2",...}); 
    }
}

AndroidManifest.xml に次の権限を宣言します。

<!--必須の権限-->
   <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"/>

SDK の認証

バージョン 2.0 以降、SDK は不正使用を防ぐために認証を必要とします。モバイル解決 HTTPDNS を有効にするには、コンソールでキーを作成して AccessKey ID と AccessKey Secret を取得する必要があります。SDK の初期化中に認証パラメーターを設定する必要があります。HTTPDNS は認証されていないリクエストを拒否し、これにより名前解決が失敗し、サービスに影響を与えます。モバイル解決 HTTPDNS

認証パラメーターは次のように設定できます。

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

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; // ... をローカルの NDK インストールパスに置き換えてください。

android.useDeprecatedNdk = true;

SDK は、名前解決リクエストに HTTP と HTTPS をサポートしています。デフォルト：HTTPS (セキュリティ上推奨)。HTTPS リクエストは HTTP レートの 5 倍で課金されることに注意してください。ビジネス要件に基づいて選択してください。モバイル解決 HTTPDNS

  /**
   * 自動検出されたネットワーク環境 (IPv4 のみ、IPv6 のみ、またはデュアルスタック) に基づいてドメイン名の名前解決を事前にロードします。
   * デュアルスタックネットワーク環境では、IPv4 と IPv6 の両方の名前解決結果が事前にロードされます。このメソッドは、アプリ起動時の SDK 初期化中に呼び出すことができます。
   * このメソッドは、名前解決結果をキャッシュに事前に保存して、後続のドメイン名の名前解決のレイテンシーを削減します。
   *
   * @param domains 事前にロードするドメイン名。
   */
   public void preLoadDomains(final String[] domains)

    /**
     * 指定されたレコードタイプ (IPv4 または IPv6) のドメイン名の名前解決を事前にロードします。
     * このメソッドは、アプリ起動時の SDK 初期化中に呼び出すことができます。このメソッドは、名前解決結果をキャッシュに事前に保存して、後の名前解決のレイテンシーを削減します。
     *
     * @param qType 事前にロードするレコードタイプ (IPv4 や IPv6 など)。
     * @param domains 事前にロードするドメイン名。
     */
    public void preLoadDomains(String qType, final String[] domains)
   /**
   * 自動検出されたネットワーク環境 (IPv4 のみ、IPv6 のみ、またはデュアルスタック) に基づいてドメイン名の名前解決データを取得します。
   * キャッシュに期限切れでない名前解決結果が存在する場合、キャッシュからの結果が返されます。
   * キャッシュが空またはキャッシュされた結果が期限切れの場合、同期ネットワークリクエストがサーバーに送信され、再帰的な名前解決結果が取得されます。その後、結果が返され、キャッシュに保存されます。
   *
   * @param host 解決したいドメイン名。
   * @return 現在のネットワーク環境に基づいた最適な IP アドレス配列。
   */
    public String[] getIpsByHost(String host)

/**
    * ホスト名に対応する IPv4 レコードの配列を取得します。
    * キャッシュに期限切れでない名前解決結果が存在する場合、キャッシュからの結果が返されます。
    * キャッシュが空またはキャッシュされた結果が期限切れの場合、同期ネットワークリクエストがサーバーに送信され、再帰的な名前解決結果が取得されます。その後、結果が返され、キャッシュに保存されます。
    *
    * @param hostName ホスト名 (例：www.example.com)。
    * @return ホスト名に対応する IPv4 アドレスの配列。
    */
  public  String[] getIPsV4ByHost(String hostName) 

   /**
    * ホスト名に対応する IPv6 レコードの配列を取得します。
    * @param hostName ホスト名 (例：www.example.com)。
    * @return ホスト名に対応する IPv6 アドレスの配列。
    */
  public String[] getIPsV6ByHost(String hostName) 

  

  /**
   * 自動検出されたネットワーク環境 (IPv4 のみ、IPv6 のみ、またはデュアルスタック) に基づいて、解決されたドメイン名の IP アドレス配列をキャッシュから取得します。
   * キャッシュが空の場合、このメソッドは null を返し、非同期クエリを開始します。クエリ結果はその後キャッシュに保存されます。
   * キャッシュに名前解決結果が存在し、期限切れの結果を返すことを許可している場合、期限切れの IP アドレスが返され、キャッシュは非同期で更新されます。
   * 期限切れの結果を返すことを許可せず、キャッシュされた結果が期限切れの場合、このメソッドは null を返し、その後非同期でキャッシュを更新します。
   *
   * @param host クエリするホスト (例：www.example.com)。
   * @param isAllowExp 期限切れのドメインの名前解決データを返すかどうかを指定します。
   * @return 解決されたホストのキャッシュされた IP アドレス配列。
   */
   public String[] getIpsByHostFromCache(String host, boolean isAllowExp)
   
    /**
     * 解決されたドメイン名の IPv4 レコードタイプの IP アドレス配列をキャッシュから取得します。
     * キャッシュが空の場合、このメソッドは null を返し、非同期クエリを開始します。クエリ結果はその後キャッシュに保存されます。
     * キャッシュに名前解決結果が存在し、期限切れの結果を返すことを許可している場合、期限切れの IP アドレスが返され、キャッシュは非同期で更新されます。
     * 期限切れの結果を返すことを許可せず、キャッシュされた結果が期限切れの場合、このメソッドは null を返し、その後非同期でキャッシュを更新します。
     *
     * @param host クエリするホスト (例：www.example.com)。
     * @param isAllowExp 期限切れのドメインの名前解決データを返すかどうかを指定します。
     * @return ホストが解決された後のキャッシュからの IPv4 レコードタイプの IP アドレス配列。
     */
    public String[] getIpv4ByHostFromCache(String host , boolean isAllowExp)

    /**
     * 解決されたドメイン名の IPv6 レコードタイプの IP アドレス配列をキャッシュから取得します。
     * キャッシュが空の場合、このメソッドは null を返し、非同期クエリを開始します。クエリ結果はその後キャッシュに保存されます。
     * キャッシュに名前解決結果が存在し、期限切れの結果を返すことを許可している場合、期限切れの IP アドレスが返され、キャッシュは非同期で更新されます。
     * 期限切れの結果を返すことを許可せず、キャッシュされた結果が期限切れの場合、このメソッドは null を返し、その後非同期でキャッシュを更新します。
     *
     * @param host クエリするホスト (例：www.example.com)。
     * @param isAllowExp 期限切れのドメインの名前解決データを返すかどうかを指定します。
     * @return ホストが解決された後のキャッシュからの IPv6 レコードタイプの IP アドレス配列。
     */
    public String[] getIpv6ByHostFromCache(String host , boolean isAllowExp)

  /**
  * URL に対応する IPv4 レコードの DomainInfo オブジェクトの配列を取得します。
  * キャッシュに期限切れでない名前解決結果が存在する場合、キャッシュからの結果が返されます。
  * キャッシュが空またはキャッシュされた結果が期限切れの場合、同期ネットワークリクエストがサーバーに送信され、再帰的な名前解決結果が取得されます。その後、結果が返され、キャッシュに保存されます。
  *
  * @param url URL (例：http://www.example.com)。
  * @return URL に対応する IPv4 タイプの DomainInfo オブジェクトの配列。
  */
  public DomainInfo[] getIPsV4DInfoByUrl(String url) 

  注意：DomainInfo オブジェクトの URL は、ホストが自動的に IP アドレスに置き換えられた URL です。URL 内のホストを手動で置き換える必要はありません。

  /**
   * URL に対応する IPv6 レコードの DomainInfo オブジェクトの配列を取得します。
   * キャッシュに期限切れでない名前解決結果が存在する場合、キャッシュからの結果が返されます。
   * キャッシュが空またはキャッシュされた結果が期限切れの場合、同期ネットワークリクエストがサーバーに送信され、再帰的な名前解決結果が取得されます。その後、結果が返され、キャッシュに保存されます。
   * 
   * @param url URL (例：http://m.example.com)。
   * @return URL に対応する IPv6 タイプの DomainInfo オブジェクトの配列。
   */
   public DomainInfo[] getIPsV6DInfoByUrl(String url) 

  /**
    * 特定の URL に対応する IPv4 レコードの DomainInfo オブジェクトを取得します。
    * キャッシュに期限切れでない名前解決結果が存在する場合、キャッシュからの結果が返されます。
    * キャッシュが空またはキャッシュされた結果が期限切れの場合、同期ネットワークリクエストがサーバーに送信され、再帰的な名前解決結果が取得されます。その後、結果が返され、キャッシュに保存されます。
    *
    * @param url URL (例：http://m.example.com)。
    * @return URL に対応する IPv4 タイプの DomainInfo オブジェクトのコレクションからランダムな DomainInfo オブジェクト。
    */
    public DomainInfo getIPV4DInfoByUrl(String url) 


  /**
    * 特定の URL に対応する IPv6 レコードの DomainInfo オブジェクトを取得します。
    * キャッシュに期限切れでない名前解決結果が存在する場合、キャッシュからの結果が返されます。
    * キャッシュが空またはキャッシュされた結果が期限切れの場合、同期ネットワークリクエストがサーバーに送信され、再帰的な名前解決結果が取得されます。その後、結果が返され、キャッシュに保存されます。
    *
    * @param url URL (例：http://www.example.com)。
    * @return URL に対応する IPv6 タイプの DomainInfo オブジェクトのコレクションからランダムな DomainInfo オブジェクト。
    */
   public DomainInfo getIPV6DInfoByUrl(String url) 

   注意：返される DomainInfo オブジェクトは、次のプロパティをカプセル化しています。

  /**
   * アクセスドメインの自動増分 ID。
    */
    public String id = null;

   /**
    * 直接使用できる URL。URL 内のホストは IP アドレスに置き換えられます。
    */
     public String url = null;

    /**
    * HTTP ヘッダーに設定される宛先サービスの名前。
    */
    public String host = "";

   /**
    * 返されるコンテンツ本文。
    */
   public String data = null;

   /**
    * リクエストが開始された時刻。
    */
   public String startTime = null;

   /**
    * リクエストが終了した時刻。リクエストがタイムアウトした場合、この値は null です。
    */
   public String stopTime = null; 

   /**
   * サーバーから返されたステータスコード (例：200、404、500)。
   */
   public String code = null;

  /**
    * ホスト名に対応する IPv4 レコードを取得します。
    * キャッシュに期限切れでない名前解決結果が存在する場合、キャッシュからの結果が返されます。
     * キャッシュが空またはキャッシュされた結果が期限切れの場合、同期ネットワークリクエストがサーバーに送信され、再帰的な名前解決結果が取得されます。その後、結果が返され、キャッシュに保存されます。
  
    * @param hostName ホスト名 (例：www.example.com)。
    * @return ホスト名に対応する IPv4 アドレスのセットからランダムな IPv4 アドレス。IP 速度測定が有効な場合、最適な IPv4 アドレスが返されます。
    */
  public String getIPV4ByHost(String hostName) 

   /**
    * ホスト名に対応する IPv6 レコードを取得します。
    * キャッシュに期限切れでない名前解決結果が存在する場合、キャッシュからの結果が返されます。
    * キャッシュが空またはキャッシュされた結果が期限切れの場合、同期ネットワークリクエストがサーバーに送信され、再帰的な名前解決結果が取得されます。その後、結果が返され、キャッシュに保存されます。
  
    * @param hostName ホスト名 (例：www.example.com)。
    * @return ホスト名に対応する IPv6 アドレスのセットからランダムな IPv6 アドレス。IP 速度測定が有効な場合、最適な IPv6 アドレスが返されます。
    */
   public String getIPV6ByHost(String hostName) 
      

    /**
     * 成功した HTTPDNS リクエストと失敗した HTTPDNS リクエストの統計を取得します。
     *
     * @return すべてのドメイン名の名前解決統計の JSON 配列文字列。
     */
    public String getRequestReportInfo()
    
     /**
     * キャッシュのキープアライブ用のドメイン名を設定します。設定されたドメイン名の名前解決は、TTL の 75% が経過すると自動的に開始されます。これにより、設定されたドメイン名の名前解決リクエストが常にキャッシュにヒットし、SDK の名前解決効率が向上します。
     * この機能には過剰な数のドメイン名を設定しないことを推奨します。現在の制限は 10 ドメイン名です。この機能は、事前解決機能とは独立して設定されます。
     *
     * @param persistentCacheDomains
     */
    public synchronized static void setKeepAliveDomains(String[] persistentCacheDomains) {
    
     /**
     * 指定されたドメイン名のキャッシュをクリアします。hostname が null の場合、すべてのドメイン名のキャッシュがクリアされます。
     *
     * @param domains キャッシュをクリアしたいドメイン名の配列。
     */
    public void clearHostCache(String[] domains){

URL：渡されるアクセスアドレス (例：http://www.example.com)。

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

1. 現在のネットワーク環境に最適な IP データを取得

String[] ip = DNSResolver.getInstance().getIpsByHost(hostname); // 現在のネットワークに最適なドメイン解決 IP を取得します。

2. 現在のネットワーク環境に基づいてドメイン解決を事前ロード

DNSResolver.getInstance().preLoadDomains(domains); // 事前解決用のドメイン名を設定します。プレースホルダードメインを HTTPDNS で解決したいドメインに置き換えてください。

3. 現在のネットワーク環境に基づいてキャッシュからドメイン解決データを読み取り

String[] ip = DNSResolver.getInstance().getIpsByHostFromCache(hostname,true); // 現在のネットワーク環境のキャッシュからドメイン解決データを取得します。

4. IPv4 アドレスを取得

String IPV4 = DNSResolver.getInstance().getIPV4ByHost(hostname); // 解決された IPv4 アドレスを取得します。

5. IPv6 アドレスを取得

String IPV6 =  DNSResolver.getInstance().getIPV6ByHost(hostname); // 解決された IPv6 アドレスを取得します。

6. キャッシュから解決済みの IPv4 アドレスを取得

String[] IPV4 =  DNSResolver.getInstance().getIpv4ByHostFromCache(hostname , true); // キャッシュから解決済みの IPv4 アドレスを取得します。

7. キャッシュから解決済みの IPv6 アドレスを取得

String[] IPV6 =  DNSResolver.getInstance().getIpv6ByHostFromCache(hostname , true); // キャッシュから解決済みの IPv6 アドレスを取得します。

8. URL に対応する DomainInfo オブジェクトを取得

DomainInfo dinfo = DNSResolver.getInstance().getIPV4DInfoByUrl(url); // 置き換えられた URL を取得します。

9. キャッシュから指定されたドメインの解決結果をクリア

DNSResolver.getInstance().clearHostCache(hostName); // 指定されたドメインのキャッシュをクリアします。hostName が null に設定されている場合、すべてのドメインのキャッシュがクリアされます。

10. 成功した HTTPDNS リクエストと失敗した HTTPDNS リクエストの統計を取得

String reportInfo = DNSResolver.getInstance().getRequestReportInfo(); // 成功したリクエストと失敗したリクエストの統計を取得します。

次の表は、ドメイン解決統計の JSON 文字列配列のフィールドについて説明しています。

 [
      {
         "avgRtt":"1",                         // 平均ドメイン解決時間 (ミリ秒単位)。
         "degradeLocalDnsCount": 0,            // ローカル DNS へのフォールバック数。                       
         "domainName":"www.example.com",       // 解決されたドメイン名。
         "hitDnsCacheCount": 1,                // キャッシュヒット数。
         "httpabnormalCount": 0,               // 失敗した再帰リクエスト数。
         "isp": "China Mobile",                // ISP 名。
         "localDnsResolveErrCount": 0,         // ローカル DNS 解決失敗数。
         "maxRtt": 8.0,                        // 最大ドメイン解決時間 (ミリ秒単位)。          
         "nonetworkCount": 0,                  // ネットワークが利用できない回数。
         "permissionErrCount": 0,              // ユーザー認証失敗数。
         "queryType": 1,                       // IP タイプ。1 は IPv4、28 は IPv6 を示します。
         "recursiveReqCount": 1,               // 再帰クエリ数。
         "reqParameterErrCount": 0,            // リクエストパラメーター形式エラー数。
         "reqPathErrCount": 0,                 // URL エラー数。
         "reqServerErrCount": 0,               // DNS サーバー側エラー数。
         "reqTimeoutCount": 0,                 // DNS サービスタイムアウトエラー数。
         "resolveSuccessCount": 1,             // 解決成功数。
         "timeoutCount": 0,                    // ネットワークタイムアウトエラー数。
         "utfNetWorkErroNum": 0                // データ報告タイムアウトエラー数。
      }
         ......
 ]

例

public class MainActivity extends AppCompatActivity {
   private Button button;
   private TextView tvInfo;
   private TextView tvResult;
   private String hostUrl = "http://www.taobao.com"; // 解決したい hostUrl に置き換えてください。
   private String hostName = "www.taobao.com"; // 解決したい hostName に置き換えてください。
   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() {
                      // HTTPDNS SDK の getIPV4ByHost メソッドを呼び出して、ターゲットドメイン名の解決済み IP アドレスを取得します。
                      String ip = DNSResolver.getInstance().getIPV4ByHost(hostName);
                      if(ip != null){
                         tvInfo.setText("ドメインの解決済み IP は： "+ ip);
                      }
                      // HTTPDNS SDK の getIPV4DInfoByUrl メソッドを呼び出して、解決済みの DomainInfo オブジェクトから URL を取得します。
                      // この URL のホストは 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) {
                // ネットワークリクエストを送信します。
               String requestUrl = dinfo.url;
               HttpURLConnection conn = null;
               try {
                   URL url = new URL(requestUrl);
                   conn = (HttpURLConnection) url.openConnection();
                   // IP アドレスを使用してアクセスする場合、HTTP リクエストヘッダーの Host フィールドを元のドメイン名に設定する必要があります。
                   conn.setRequestProperty("Host", url.getHost()); // HTTP リクエストヘッダーの Host フィールドを設定します。
                   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, "Response: " + 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 = "ご利用のアカウント ID"; // コンソールから取得したアカウント ID を設定します。
    private String accessKeyId = "ご利用の AccessKey ID"; // コンソールから取得した AccessKey ID を設定します。
    private String accessKeySecret = "ご利用の AccessKey Secret"; // コンソールから取得した AccessKey Secret を設定します。

    @Override
    public void onCreate() {
       super.onCreate();
       // SDK アクセスのためにアカウント ID、AccessKey ID、AccessKey Secret を設定します。
       DNSResolver.Init(this, accountId, accessKeyId, accessKeySecret); 
       // キャッシュのキープアライブ用のドメイン名を設定します。設定されたドメイン名の名前解決は、TTL の 75% が経過すると自動的に開始され、ドメイン名の名前解決リクエストが常にキャッシュにヒットするようにします。
       DNSResolver.setKeepAliveDomains(new String[]{"your-domain-1","your-domain-2",...}); 
       // 指定されたドメインを IPv4 アドレスに事前ロードします。プレースホルダードメインを解決したいドメインに置き換えてください。
       DNSResolver.getInstance().preLoadDomains(DNSResolver.QTYPE_IPV4,new String[]{"your-domain-to-preload-1","your-domain-to-preload-2",...}); 
    }
}

ベストプラクティス

事前解決と期限切れ応答のキャッシュを組み合わせて、最適なパフォーマンスを実現します。

事前解決は起動時に結果をキャッシュします。期限切れの応答を許可すると、TTL の有効期限が切れた後でもキャッシュされた IP がすぐに返され、ほぼゼロのレイテンシーでの名前解決が実現します。

事前ロードされたドメインは、後続のリクエストでローカルキャッシュにヒットし、ネットワークのラウンドトリップを排除します。

1. 事前解決

アプリケーション起動時にキャッシュを有効にし、主要なドメインを事前解決します。

Application の onCreate() メソッドで、ドメインを事前解決し、結果をローカルにキャッシュします。

1. IPv4 のみのシナリオ

//********IPv4 のみのシナリオの場合*******
public class DnsCacheApplication extends Application{
    private String accountId = "ご利用のアカウント ID"; // コンソールから取得したアカウント ID を設定します。
    private String accessKeyId = "ご利用の AccessKey ID"; // コンソールから取得した AccessKey ID を設定します。
    private String accessKeySecret = "ご利用の AccessKey Secret"; // コンソールから取得した AccessKey Secret を設定します。

    @Override
    public void onCreate() {
       super.onCreate();
       // SDK アクセスのためにアカウント ID、AccessKey ID、AccessKey Secret を設定します。
       DNSResolver.Init(this, accountId, accessKeyId, accessKeySecret); 
       DNSResolver.setEnableCache(true); // キャッシュを有効にします。デフォルト値：true。
       // 事前解決用の IPv4 レコードタイプ。    
       // 指定されたドメインを IPv4 アドレスに事前ロードします。プレースホルダードメインを HTTPDNS で解決したいドメインに置き換えてください。
       DNSResolver.getInstance().preLoadDomains(DNSResolver.QTYPE_IPV4,new String[]{"your-domain-to-preload-1","your-domain-to-preload-2",...}); 
    }
}

2. IPv6 サポート

//********IPv6 サポートが必要なシナリオの場合*******
public class DnsCacheApplication extends Application{
    private String accountId = "ご利用のアカウント ID"; // コンソールから取得したアカウント ID を設定します。
    private String accessKeyId = "ご利用の AccessKey ID"; // コンソールから取得した AccessKey ID を設定します。
    private String accessKeySecret = "ご利用の AccessKey Secret"; // コンソールから取得した AccessKey Secret を設定します。

    @Override
    public void onCreate() {
       super.onCreate();
       // SDK アクセスのためにアカウント ID、AccessKey ID、AccessKey Secret を設定します。
       DNSResolver.Init(this, accountId, accessKeyId, accessKeySecret); 
       DNSResolver.setEnableCache(true); // キャッシュを有効にします。デフォルト値：true。
       DNSResolver.setEnableIPv6(true); // IPv6 ネットワーク経由でドメイン名を解決するかどうかを指定します。デフォルト値：false。  
       DNSResolver.setEnableSpeedTest(true); // IP 速度測定を有効にするかどうかを指定します。デフォルト値：false。
       // 事前解決用の IPv4 および IPv6 レコードタイプ。  
       // 指定されたドメインを IPv4 および IPv6 アドレスに事前ロードします。プレースホルダードメインを HTTPDNS で解決したいドメインに置き換えてください。
       DNSResolver.getInstance().preLoadDomains(DNSResolver.QTYPE_IPV4_IPV6,new String[]{"your-domain-to-preload-1","your-domain-to-preload-2",...}); 
    }
}

2. 期限切れの応答を許可

ネットワークリクエストの前にキャッシュから IP を読み取り、期限切れのエントリがすぐに返されるようにします。キャッシュはバックグラウンドで非同期に更新されます。

1. IPv4 のみのシナリオ

    //********IPv4 のみのシナリオの場合*******
    @Override
    public List<InetAddress> lookup(@NonNull String hostname) throws UnknownHostException {
        // キャッシュから IP アドレスを取得することを優先します。2 番目のパラメーターが true の場合、期限切れでも使用可能なレコードを返すことができます。
        String[] IPArray = mDNSResolver.getIpv4ByHostFromCache(hostname,true);
        if (IPArray == null || IPArray.length == 0){
            // キャッシュにヒットしない場合、非同期解決を開始します。
            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. IPv6 サポート

    //********IPv6 サポートが必要なシナリオの場合*******
    @Override
    public List<InetAddress> lookup(@NonNull String hostname) throws UnknownHostException {
        // キャッシュから IP アドレスを取得することを優先します。2 番目のパラメーターが true の場合、期限切れでも使用可能なレコードを返すことができます。
        String[] IPArray = mDNSResolver.getIpsByHostFromCache(hostname,true);
        if (IPArray == null || IPArray.length == 0){
            // キャッシュにヒットしない場合、非同期解決を開始します。
            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);
    }

使用上の注意

1. モバイル解決 HTTPDNS から取得した IP アドレスを使用してリクエストを送信する場合、HTTP の Host ヘッダーを元のドメイン名に設定します。

2. モバイル解決 HTTPDNS SDK が空の IP を返した場合、元のドメイン名 URL にフォールバックします。

   String ip = DNSResolver.getInstance().getIPV4ByHost("your-domain");
   if (ip != null) {
   	// URL のホストを IP アドレスに置き換えて API リクエストを行います。
   }else {
   	// 元のドメイン名のリクエスト URL を使用してフォールバックリクエストを行います。
       // この場合、ドメイン名を含む元の URL を使用してネットワークリクエストを行います。
   }

3. モバイル解決 HTTPDNS SDK の統合リファレンスとして、デモプログラムをダウンロードしてください。

4. 統合後、コンソールのトラフィック分析ページで成功を確認します。トラフィックが表示されない場合は、アカウント ID、AccessKey ID、AccessKey Secret が正しく設定されていることを確認してください。

オンプレミス DNS

v2.3.0 以降、HTTPDNS Android SDK はオンプレミス DNS デプロイメントのサポートを追加します。

オンプレミス DNS は、データコンプライアンスとカスタム解決ポリシー (金融、政府、大企業) を必要とするシナリオに適しています。SDK は、パブリッククラウドのみ、オンプレミスのみ、および 2 つのプライマリ/スタンバイハイブリッドの 4 つのデプロイモードをサポートします。

コア機能

• オンプレミスデプロイメントのサポート：IPv4/IPv6 アドレスまたはホストドメイン名を使用してオンプレミス DNS サービスエンドポイントを設定することをサポートします。

• 双方向認証：このメカニズムは、顧客固有の accessKeyId と accessKeySecret でリクエストに署名し、安全な通信を保証します。

• サーキットブレーカーとヘルスチェック：オンプレミス DNS ノードが 3 回以上連続して失敗した場合、サーキットブレーカーが自動的にトリガーされます。その後、指定された healthCheckDomain を使用して 1 分ごとに可用性がチェックされます。ノードは回復後に自動的に再有効化されます。

• 証明書検証の制御：バージョン 2.3.1.beta 以降、オンプレミス DNS のテスト用に TLS 証明書検証を無効にできます。ベータ版はテスト専用であり、本番環境では使用しないでください。Android SDK リリースノート

• スマートフォールバック：プライマリ DNS (パブリッククラウド DNS またはオンプレミス DNS) がドメイン名の解決に失敗し、失敗回数が指定されたしきい値に達した場合、システムは自動的にスタンバイ DNS に切り替わり、解決の高可用性を確保します。

• シームレスな API 互換性：パブリッククラウド DNS またはオンプレミス DNS のどちらを使用する場合でも、解決 API の呼び出し方法は同じです。ビジネスロジックを変更する必要はありません。

構成

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");
// オプション: 証明書検証を無効にします (テスト環境のみ。2.3.1.beta などのベータ版 SDK が必要です)。
// DNSResolver.setEnableCertificateValidation(false);

// プライマリ：パブリッククラウド DNS
DNSResolver.Init(this, accountID, accessKeyId, accessKeySecret);
    
// スタンバイ：オンプレミス DNS
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");
// オプション：証明書検証を無効にする (テスト環境のみ、ベータ版 SDK バージョン (例：2.3.1.beta) が必要)。
// DNSResolver.setEnableCertificateValidation(false);

// プライマリ：オンプレミス DNS
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");
// オプション：証明書検証を無効にする (テスト環境のみ、ベータ版 SDK バージョン (例：2.3.1.beta) が必要)。
// DNSResolver.setEnableCertificateValidation(false);

// スタンバイ：パブリッククラウド DNS
DNSResolver.Init(this, accountID, accessKeyId, accessKeySecret);

新しい API

SDK は、オンプレミスデプロイメントと高可用性ディザスタリカバリのために 3 つのコア API を追加します。

    /** オンプレミスデプロイメントで使用されるオンプレミス DNS 用。パブリック DNS のみを使用する場合は、このメソッドを呼び出す必要はありません。
     *
     * オンプレミス DNS サーバーのアドレスと認証情報を設定します。
     * 顧客はこのインターフェイスを使用して、プライベート DNS サーバーのアドレスと認証情報を渡します。
     * SDK はこの情報を使用してリクエストを開始します。
     * @param ctx コンテキスト。
     * @param serverIpv4Arr IPv4 アドレスの配列 (nil の場合あり)。
     * @param serverIpv6Arr IPv6 アドレスの配列 (nil の場合あり)。
     * @param serverHostArr ホストドメイン名の配列 (nil の場合あり)。
     * @param port サービスポート (例："443")。nil の場合、デフォルトポート "443" が使用されます。
     * @param healthCheckDomain サーキットブレーカーがトリガーされた後のヘルスチェックに使用されるドメイン名。解決サービスが 3 回以上連続して失敗すると、サーキットブレーカーがトリガーされ、そのサービスの IP アドレスは healthCheck 状態になります。後続のリクエストはこのサービスに送信されません。
     *                          タイマーが 1 分ごとに実行され、この healthCheckDomain を使用して解決 API を呼び出し、解決サービスが利用可能かどうかをプローブします。プローブが成功すると、サービスは alive 状態に戻り、後続のリクエストはこのサービスに送信できます。
     * @param accessKeyId 顧客のプライベート accessKeyId。認証に使用されます。
     * @param accessKeySecret 顧客のプライベート accessKeySecret。認証に使用されます。
     */
    public static void InitFusionDNS(Context ctx,String[] serverIpv4Arr, String[] serverIpv6Arr, String[] serverHostArr, String port, String healthCheckDomain, String accessKeyId, String accessKeySecret)

    /** オンプレミスデプロイメントで使用されるオンプレミス DNS 用。パブリック DNS のみを使用する場合は、このメソッドを呼び出す必要はありません。
     *
     * オンプレミス DNS の証明書検証を有効にするかどうかを指定します。デフォルト値：true。サーバーにドメイン証明書または IP 証明書が設定されていない場合、テスト用にこのパラメーターを false に設定できます。本番環境では、セキュリティリスクが発生する可能性があるため、このパラメーターを true に設定することを強く推奨します。
     * @param enable このパラメーターを true に設定して証明書検証を有効にする (デフォルト)、または false に設定して無効にします。
     */
    public static void setEnableCertificateValidation(boolean enable)

    /** パブリッククラウド DNS とオンプレミス DNS の両方を設定する場合、プライマリ DNS での DNS 解決が何回失敗したらシステムが自動的にスタンバイ DNS にフォールバックするかを指定できます。1 種類の DNS のみを設定する場合は、このメソッドを呼び出す必要はありません。
     *
     * プライマリ DNS での DNS 解決が何回失敗したらシステムが自動的にスタンバイ DNS にフォールバックするかを指定します。1 種類の DNS のみを設定する場合は、このメソッドを呼び出す必要はありません。
     * @param fallbackThreshold 失敗しきい値。デフォルト：プライマリ DNS がパブリッククラウド DNS の場合は 4、プライマリ DNS がオンプレミス DNS の場合は 2。
     * 有効範囲：[0, 4]。値 0 は即時フォールバックを示します。
     */
     public static void setFallbackThreshold(int fallbackThreshold)