Alibaba Cloud DNS:Android 開発者向け SDK ガイド

1. 概要

Alibaba Cloud パブリック DNS SDK は、モバイル開発者に Domain Name System ( DNS ) 解決サービスを提供するために Alibaba Cloud によって開発されました。

この SDK を使用すると、モバイル開発者は Android アプリから Alibaba Cloud パブリック DNS に簡単にアクセスできます。 これにより、DNS 解決エラーを防ぎ、低コストで DNS クエリの正確なスケジューリングを実現します。 デモプロジェクトのソースコードは、SDK を Android アプリに統合する方法と、Android アプリで Alibaba Cloud パブリック DNS を使用する方法の例を提供します。

この SDK は、Alibaba Cloud パブリック DNS の DoH 用 JSON API をカプセル化しています。 この SDK は、Android アプリが DNS 解決を実行するための Java 関数インターフェイスを提供します。 この SDK は、time to live ( TTL ) と least recently used ( LRU ) ポリシーに基づいて、DNS 結果を効果的にキャッシュするためにも使用できます。 この SDK は、Alibaba Cloud パブリック DNS の機能に基づいて、次の利点を提供します。

• 使いやすさ

  Alibaba Cloud パブリック DNS を使用するには、SDK をアプリに統合するだけで済みます。 これにより、より簡単で便利な方法で解決サービスを使用できます。

• 遅延のない DNS 解決

  SDK は LRU キャッシングアルゴリズムを実装しているため、DNS 解決で取得した IP アドレスはオンプレミスサーバーにキャッシュされます。 また、SDK はキャッシュされたデータを自動的に更新し、TTL に基づいて期限切れのデータを削除します。 これにより、キャッシュされたデータは有効なままであり、遅延なく DNS 解決を実行できます。

2. SDK の統合

• Alibaba Cloud DNS コンソールでアプリを登録し、アプリの [アカウント ID] を取得します。

• 次に、プロジェクトディレクトリの AndroidManifest.xml ファイルで、認証用の [アクセスキー ID] パラメータと [アクセスキー シークレット] パラメータを指定します。

• SDK をアプリプロジェクトに統合します。

2.1 build.gradle ファイルに Maven リポジトリを追加する

build.gradle ファイルに次のコードを追加します。

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

参照するファイル情報を追加します。

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

2.2 SDK AAR パッケージをプロジェクトに統合する

Alibaba Cloud DNS をクリックして、Alibaba Cloud DNS コンソールで Alibaba Cloud パブリック DNS の SDK AAR パッケージ alidns_android_sdk.aar を取得します。 パッケージをプロジェクトの libs ディレクトリに解凍して SDK をインストールします。 その後、SDK を使用できます。

2.3 SDK の初期化

Alibaba Cloud DNS コンソールでアプリを登録し、アプリの [アカウント ID] を取得してから、認証用の [アクセスキー ID] と [アクセスキー シークレット] を取得する必要があります。 SDK をアプリプロジェクトに統合した後、SDK を初期化できます。 SDK を初期化する方法の詳細については、アプリの次のサンプルコードを参照してください。

public class DnsCacheApplication extends Application{

    private String Account ID = "Your Account ID"; // Alibaba Cloud DNS コンソールで SDK にアクセスするために使用するアカウント ID を指定します。
    private String AccessKey ID = "Your AccessKey ID"; // Alibaba Cloud DNS コンソールで SDK にアクセスするために使用するアクセスキー ID を指定します。
    private String AccessKey Secret = "Your AccessKey Secret"; // Alibaba Cloud DNS コンソールで SDK にアクセスするために使用するアクセスキー シークレットを指定します。

    @Override
    public void onCreate() {
       super.onCreate();
       DNSResolver.Init(this, Account ID, AccessKey ID, AccessKey Secret); // Alibaba Cloud DNS コンソールで SDK にアクセスするために使用するアカウント ID、アクセスキー ID、およびアクセスキー シークレットを指定します。
       //注: キャッシュ保持機能を有効にするドメイン名を指定します。 キャッシュ保持機能が有効になると、TTL 期間の 75% が経過すると、ドメイン名が自動的に解決されます。 これにより、ドメイン名に対する DNS リクエストは、解決中に常にキャッシュされた DNS 結果と一致します。 Alibaba Cloud Content Delivery Network ( CDN ) にドメイン名を追加すると、TTL の短縮によって DNS リクエスト数が増加し、課金が増える可能性があります。 このコマンドを実行する際は注意してください。
       DNSResolver.setKeepAliveDomains(new String[]{"キャッシュ保持機能を有効にするドメイン名 1","キャッシュ保持機能を有効にするドメイン名 2",...});
       DNSResolver.getInstance().preLoadDomains(DNSResolver.QTYPE_IPV4,new String[]{"DNS 結果をプリロードするドメイン名 1","DNS 結果をプリロードするドメイン名 2",...}); // 事前に解決し、Alibaba Cloud パブリック DNS を使用して解決する IPv4 ドメイン名を指定します。
    }
}

Android プロジェクトで SDK を使用する場合、次のアクセス許可が構成されていることを確認してください。

<!--必要な権限-->
   <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"/>

2.4 SDK 認証

SDK 2.0 以降を使用して認証を有効にし、許可されていない第三者によるユーザー ID の盗難を防ぐことができます。 Alibaba Cloud DNS コンソールで [アクセスキー ID] と [アクセスキー シークレット] を作成して認証を有効にする方法の詳細については、「サービス認証」をご参照ください。 SDK の初期化時に認証用のパラメータを指定しないと、Alibaba Cloud パブリック DNS は認証が無効になっているドメイン名に対する DNS リクエストを拒否します。 これにより、DNS 解決に失敗し、ビジネスに影響が出ます。 したがって、SDK を初期化するときは、認証用のパラメータを指定する必要があります。

ビジネス要件に基づいて認証用のパラメータを指定するには、次のコマンドを実行します。

DNSResolver.Init(this, Account ID, AccessKey ID, AccessKey Secret);

3. SDK ベースのアクセスに関する一般的な問題

1. Android 9.0 を実行しているデバイスが HTTP リクエストを送信すると、「クリアテキスト HTTP トラフィックは許可されていません」というエラーメッセージが返されます。

• 原因: デフォルトでは、Android 9.0 ( Android SDK プラットフォームの API レベル 28 ) 以降の Android デバイスでは、プレーンテキストネットワークアクセスが無効になっています。

• 解決策

Android アプリの AndroidManifest.xml ファイルの <application> セクションに次の構成を追加します。

android:usesCleartextTraffic="true"

<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">

2. Android 9.0 を実行しているデバイスを使用すると、「クラス BasicHttpParams が見つかりません」というエラーメッセージが返されます。

• 原因: Apache HttpClient はサポートされなくなりました。

Google は、Android 6.0 以降、Apache HttpClient のサポートを削除しました。 Android 9.0 以降では、org.apache.http.legacy が bootclasspath から削除されています。

この変更は、taskVersion が Android 9.0 より前のほとんどのアプリには影響しません。 ただし、taskVersion の値が Android 9.0 より大きいアプリを使用する場合、Apache HTTP インターフェイスが引き続き使用されているか、参照されている lib パッケージが Apache HTTP インターフェイスを使用していると、「クラス BasicHttpParams が見つかりません」というエラーメッセージが返されます。

• 解決策

Android アプリの AndroidManifest.xml ファイルの <application> セクションに次の構成を追加します。

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

3. SDK はバージョン 2.1.9 から Java Native Interface ( JNI ) を使用し始めます。 したがって、アプリプロジェクトの開発環境で Native Development Kit ( NDK ) を構成する必要があります。

• アプリプロジェクトのルートディレクトリにある local.properties ファイルに NDK のインストールディレクトリを追加します。

ndk.dir=...\\ndk\\21.4.7075529 ... NDK のローカルディレクトリ。

• アプリプロジェクトのルートディレクトリにある gradle.properties ファイルに次の構成を追加します。

android.useDeprecatedNdk = true

アプリプロジェクト用に NDK を構成済みの場合は、この手順をスキップしてください。 SDK をより効果的に使用するには、アプリをコンパイルするときに、Java Development Kit ( JDK ) のバージョンを 1.8 に、NDK のバージョンを 21.4.7075529 に設定することをお勧めします。

SDK は、HTTP または HTTPS 経由の DNS 解決をサポートしています。 HTTP または HTTPS 経由で DNS 解決を実行するかどうかを指定できます。 デフォルトでは、SDK は HTTPS 経由で DNS 解決を実行します。これは、HTTPS の方がセキュリティが高いためです。 Alibaba Cloud パブリック DNS は、HTTP 経由の DNS 解決回数に基づいて課金されます。 HTTPS 経由の DNS 解決 1 回は、HTTP 経由の DNS 解決 5 回に相当します。 ビジネス要件に基づいて適切なプロトコルを選択できます。

  /**
   * 現在のネットワーク環境でサポートされている IP アドレスタイプを自動的に検出して、ドメイン名の DNS 結果をプリロードします。 ネットワーク環境は、IPv4 のみ、IPv6 のみ、または IPv4/IPv6 デュアルスタックです。
   * IPv4/IPv6 デュアルスタックネットワーク環境でサポートされている IP アドレスタイプを自動的に検出して、ドメイン名の DNS 結果を取得します。 アプリを起動した後、
   * この操作を呼び出して DNS 結果をキャッシュできます。 これにより、後続の DNS 解決が高速化されます。
   *
   * @param domains DNS 結果がプリロードされるドメイン名。
   */
   public void preLoadDomains(final String[] domains)

    /**
     * DNS 結果をプリロードする IPv6 または IPv4 ドメイン名を指定します。
     * アプリを起動した後、この操作を呼び出して DNS 結果をキャッシュできます。 これにより、後続の DNS 解決が高速化されます。
     *
     * @param qType プリロードする IP アドレスタイプ ( IPv4 または IPv6 など )。
     * @param domains プリロードされる解決済みドメイン名。
     */
    public void preLoadDomains(String qType, final String[] domains)
   /**
   * 現在のネットワーク環境でサポートされている IP アドレスタイプを自動的に検出して、ドメイン名の DNS 結果を取得します。 ネットワーク環境は、IPv4 のみ、IPv6 のみ、または IPv4/IPv6 デュアルスタックです。
   * DNS 結果がキャッシュに存在し、期限切れになっていない場合は、キャッシュされた DNS 結果が返されます。
   * キャッシュされたデータが存在しないか、キャッシュされたデータが期限切れになっている場合は、再帰 DNS リクエストが DNS サーバーに送信され、DNS 結果が取得されます。その後、DNS 結果がクライアントに返され、キャッシュされます。
   *
   * @param host 解決するドメイン名。
   * @return 現在のネットワーク環境に基づいて最適な IP アドレスの配列を取得します。
   */
    public String[] getIpsByHost(String host)

/**
    * 特定のホスト名に対応する IPv4 レコードの配列を取得します。
    * DNS 結果がキャッシュに存在し、期限切れになっていない場合は、キャッシュされた DNS 結果が返されます。
    * キャッシュされたデータが存在しないか、キャッシュされたデータが期限切れになっている場合は、再帰 DNS リクエストが DNS サーバーに送信され、DNS 結果が取得されます。その後、DNS 結果がクライアントに返され、キャッシュされます。
    *
    * @param hostName 例: www.taobao.com
    * @return ホスト名に対応する IPv4 アドレスの配列が返されます。
    */
  public  String[] getIPsV4ByHost(String hostName) 

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

  

  /**
   * 現在のネットワーク環境でサポートされている IP アドレスタイプを自動的に検出して、ドメイン名が解決された後にキャッシュから IP アドレスの配列を取得します。 ネットワーク環境は、IPv4 のみ、IPv6 のみ、または IPv4/IPv6 デュアルスタックです。
   * キャッシュに IP アドレス配列が存在しない場合は、null が返されます。 その後、非同期クエリがトリガーされ、クエリ結果がキャッシュに保存されます。
   * キャッシュされた DNS 結果が期限切れになった場合、許可されている場合は、期限切れの DNS 結果が最初にクライアントに返されます。 その後、キャッシュされた DNS 結果が非同期に更新されます。
   * キャッシュ内の期限切れの DNS 結果を返すことが許可されていない場合は、最初に null が返されます。 その後、キャッシュされた DNS 結果が非同期に更新されます。
   *
   * @param host クエリするドメイン名 ( www.taobao.com など )。
   * @param isAllowExp ドメイン名が期限切れになった場合に DNS 結果を返すかどうかを指定します。
   * @return ドメイン名が解決された後にキャッシュから IP アドレスの配列を取得します。
   */
   public String[] getIpsByHostFromCache(String host, boolean isAllowExp)
   
    /**
     * ドメイン名が解決された後にキャッシュから IPv4 レコードタイプの IP アドレス配列を取得します。
     * キャッシュに IP アドレス配列が存在しない場合は、null が返されます。 その後、非同期クエリがトリガーされ、クエリ結果がキャッシュに保存されます。
     * キャッシュされた DNS 結果が期限切れになった場合、許可されている場合は、期限切れの DNS 結果が最初にクライアントに返されます。 その後、キャッシュされた DNS 結果が非同期に更新されます。
     * キャッシュ内の期限切れの DNS 結果を返すことが許可されていない場合は、最初に null が返されます。 その後、キャッシュされた DNS 結果が非同期に更新されます。
     *
     * @param host クエリするドメイン名 ( www.taobao.com など )。
     * @param isAllowExp ドメイン名が期限切れになった場合に DNS 結果を返すかどうかを指定します。
     * @return ドメイン名が解決された後にキャッシュ内の IPv4 レコードタイプの IP アドレス配列が返されます。
     */
    private String[] getIpv4ByHostFromCache(String host , boolean isAllowExp)

    /**
     * ドメイン名が解決された後にキャッシュから IPv6 レコードタイプの IP アドレス配列を取得します。
     * キャッシュに IP アドレス配列が存在しない場合は、null が返されます。 その後、非同期クエリがトリガーされ、クエリ結果がキャッシュに保存されます。
     * キャッシュされた DNS 結果が期限切れになった場合、許可されている場合は、期限切れの DNS 結果が最初にクライアントに返されます。 その後、キャッシュされた DNS 結果が非同期に更新されます。
     * キャッシュ内の期限切れの DNS 結果を返すことが許可されていない場合は、最初に null が返されます。 その後、キャッシュされた DNS 結果が非同期に更新されます。
     *
     * @param host クエリするドメイン名 ( www.taobao.com など )。
     * @param isAllowExp ドメイン名が期限切れになった場合に DNS 結果を返すかどうかを指定します。
     * @return ドメイン名が解決された後にキャッシュ内の IPv6 レコードタイプの IP アドレス配列が返されます。
     */
    private String[] getIpv6ByHostFromCache(String host , boolean isAllowExp)

  /**
  * 特定の URL に対応する IPv4 レコードの DomainInfo オブジェクト配列を取得します。
  * DNS 結果がキャッシュに存在し、期限切れになっていない場合は、キャッシュされた DNS 結果が返されます。
  * キャッシュされたデータが存在しないか、キャッシュされたデータが期限切れになっている場合は、再帰 DNS リクエストが DNS サーバーに送信され、DNS 結果が取得されます。その後、DNS 結果がクライアントに返され、キャッシュされます。
  *
  * @param url 例: http://www.taobao.com
  * @return URL に対応する IPv4 レコードの DomainInfo オブジェクト配列が返されます。
  */
  public DomainInfo[] getIPsV4DInfoByUrl(String url) 

  注: DomainInfo オブジェクト配列の URL は、host フィールドが特定の IP アドレスに自動的に置き換えられた URL です。 URL の host フィールドを手動で置き換える必要はありません。

  /**
   * 特定の URL に対応する IPv6 レコードの DomainInfo オブジェクト配列を取得します。
   * DNS 結果がキャッシュに存在し、期限切れになっていない場合は、キャッシュされた DNS 結果が返されます。
   * キャッシュされたデータが存在しないか、キャッシュされたデータが期限切れになっている場合は、再帰 DNS リクエストが DNS サーバーに送信され、DNS 結果が取得されます。その後、DNS 結果がクライアントに返され、キャッシュされます。
   * 
   * @param url 例: http://m.taobao.com
   * @return URL に対応する IPv6 レコードの DomainInfo オブジェクト配列が返されます。
   */
   public DomainInfo[] getIPsV6DInfoByUrl(String url) 

  /**
    * 特定の URL に対応する IPv4 レコードの DomainInfo オブジェクトを取得します。
    * DNS 結果がキャッシュに存在し、期限切れになっていない場合は、キャッシュされた DNS 結果が返されます。
    * キャッシュされたデータが存在しないか、キャッシュされたデータが期限切れになっている場合は、再帰 DNS リクエストが DNS サーバーに送信され、DNS 結果が取得されます。その後、DNS 結果がクライアントに返され、キャッシュされます。
    *
    * @param url 例: http://m.taobao.com
    * @return URL に対応する IPv4 レコードの DomainInfo オブジェクトが返されます。
    */
    public DomainInfo getIPV4DInfoByUrl(String url) 


  /**
    * 特定の URL に対応する IPv6 レコードの DomainInfo オブジェクトを取得します。
    * DNS 結果がキャッシュに存在し、期限切れになっていない場合は、キャッシュされた DNS 結果が返されます。
    * キャッシュされたデータが存在しないか、キャッシュされたデータが期限切れになっている場合は、再帰 DNS リクエストが DNS サーバーに送信され、DNS 結果が取得されます。その後、DNS 結果がクライアントに返され、キャッシュされます。
    *
    * @param url 例: http://www.taobao.com
    * @return URL に対応する IPv6 レコードの DomainInfo オブジェクトが返されます。
    */
   public DomainInfo getIPV6DInfoByUrl(String url) 

   注: 返される DomainInfo オブジェクトは、次の属性をカプセル化します。

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

   /**
    * host フィールドが IP アドレスに置き換えられた使用可能な URL。
    */
     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 レコードを取得します。
    * DNS 結果がキャッシュに存在し、期限切れになっていない場合は、キャッシュされた DNS 結果が返されます。
     * キャッシュされたデータが存在しないか、キャッシュされたデータが期限切れになっている場合は、再帰 DNS リクエストが DNS サーバーに送信され、DNS 結果が取得されます。その後、DNS 結果がクライアントに返され、キャッシュされます。
  
    * @param hostName 例: www.taobao.com
    * @ return ホスト名に対応する IPv4 アドレスのセットからランダムな IPv4 アドレスが返されます。 IP アドレスの接続速度テストが有効になっている場合は、最適な IPv4 アドレスが返されます。
    */
  public String getIPV4ByHost(String hostName) 

   /**
    * 特定のホスト名に対応する IPv6 レコードを取得します。
    * DNS 結果がキャッシュに存在し、期限切れになっていない場合は、キャッシュされた DNS 結果が返されます。
    * キャッシュされたデータが存在しないか、キャッシュされたデータが期限切れになっている場合は、再帰 DNS リクエストが DNS サーバーに送信され、DNS 結果が取得されます。その後、DNS 結果がクライアントに返され、キャッシュされます。
  
    * @param hostName 例: www.taobao.com
    * @return ホスト名に対応する IPv6 アドレスのセットからランダムな IPv6 アドレスが返されます。 IP アドレスの接続速度テストが有効になっている場合は、最適な IPv6 アドレスが返されます。
    */
   public String getIPV6ByHost(String hostName) 
      

    /**
     * Alibaba Cloud パブリック DNS のクエリ成功とクエリ失敗の統計情報を取得します。
     *
     * @return すべてのドメイン名の解決統計情報の JSON 配列文字列が返されます。
     */
    public String getRequestReportInfo()
    
     /**
     * キャッシュ保持機能を有効にするドメイン名を指定します。 キャッシュ保持機能が有効になると、TTL 期間の 75% が経過すると、ドメイン名が自動的に解決されます。 これにより、解決中にドメイン名に対する DNS リクエストが常にキャッシュされた DNS 結果と一致するため、SDK の解決効率が向上します。
     最大 10 個のドメイン名に対してキャッシュ保持機能を有効にすることをお勧めします。 事前解決されたドメイン名を個別に指定する必要があります。
     *
     * @param persistentCacheDomains
     */
    public synchronized static void setKeepAliveDomains(String[] persistentCacheDomains) {
    
     /**
     * 指定されたドメイン名のキャッシュをクリアします。 hostName パラメータが null に設定されている場合、すべてのドメイン名のキャッシュがクリアされます。
     *
     * @param domains キャッシュがクリアされるドメイン名の配列を指定します。
     */
    public void clearHostCache(String[] domains){

URL: 受信したアクセスアドレス ( http://www.taobao.com など )。

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

7.1 現在のネットワーク環境に基づいて最適な IP アドレスを取得する

String[] ip = DNSResolver.getInstance().getIpsByHost(hostname); // ドメイン名が解決された後に、現在のネットワーク環境に基づいて最適な IP アドレスを取得します。

7.2 現在のネットワーク環境に基づいてドメイン名の DNS 結果をプリロードする

DNSResolver.getInstance().preLoadDomains(domains) // 事前に解決し、Alibaba Cloud パブリック DNS を使用して解決するドメイン名を指定します。

7.3 現在のネットワーク環境に基づいてキャッシュから DNS 結果を取得する

String[] ip = DNSResolver.getInstance().getIpsByHostFromCache(hostname,true);// ドメイン名が解決された後に、現在のネットワーク環境に基づいてキャッシュから IP アドレスを取得します。

7.4 IPv4 アドレスを取得する

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

7.5 IPv6 アドレスを取得する

String IPV6 =  DNSResolver.getInstance().getIPV6ByHost(hostname) // ドメイン名が解決された後に IPv6 アドレスを取得します。

7.6 ドメイン名が解決された後にキャッシュから IPv4 アドレスを取得する

String[] IPV4 =  DNSResolver.getInstance().getIpv4ByHostFromCache(hostname, true) // ドメイン名が解決された後にキャッシュから IPv4 アドレスを取得します。

7.7 ドメイン名が解決された後にキャッシュから IPv6 アドレスを取得する

String[] IPV6 =  DNSResolver.getInstance().getIpv6ByHostFromCache(hostname, true) // ドメイン名が解決された後にキャッシュから IPv6 アドレスを取得します。

7.8 特定の URL に対応する DomainInfo オブジェクトを取得する

DomainInfo dinfo = DNSResolver.getInstance().getIPV4DInfoByUrl(url); // ドメイン名が IP アドレスに置き換えられた URL を取得します。

7.9 指定されたドメイン名のキャッシュされた DNS 結果をクリアする

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

7.10 Alibaba Cloud パブリック DNS のクエリ成功とクエリ失敗の統計情報を取得する

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

次のセクションでは、すべてのドメイン名の解決統計情報の JSON 配列文字列のフィールドの意味を示します。

 [
      {
         "avgRtt":"1",                         // 平均 DNS 解決時間。 単位: ミリ秒。
         "degradeLocalDnsCount": 0,            // DNS 解決がローカル DNS サーバーにダウングレードされた回数。                       
         "domainName":"www.example.com",       // 解決するドメイン名。
         "hitDnsCacheCount": 1,                // キャッシュヒット数。
         "httpabnormalCount": 0,               // 再帰 DNS リクエストが失敗した回数。
         "isp": "China Mobile",                    // ISP の名前。
         "localDnsResolveErrCount": 0,         // ローカル DNS サーバーでの DNS 解決の失敗回数。
         "maxRtt": 8.0,                        // 最大 DNS 解決時間。 単位: ミリ秒。          
         "nonetworkCount": 0,                  // ネットワークが失敗した回数。
         "permissionErrCount": 0,              // 認証の失敗回数。
         "queryType": 1,                       // type パラメータの値が 1 の場合は IPv4 アドレスが使用されます。 type パラメータの値が 28 の場合は IPv6 アドレスが使用されます。
         "recursiveReqCount": 1,               // 再帰 DNS クエリの数。
         "reqParameterErrCount": 0,            // リクエストパラメータが無効なために返されたエラーの数。
         "reqPathErrCount": 0,                 // URL が無効なために返されたエラーの数。
         "reqServerErrCount": 0,               // DNS サーバーの障害のために返されたエラーの数。
         "reqTimeoutCount": 0,                 // DNS リクエストがタイムアウトしたためにレスポンスが返されなかった回数。
         "resolveSuccessCount": 1,             // DNS 解決の成功回数。
         "timeoutCount": 0,                    // ネットワークタイムアウトエラーの数。
         "utfNetWorkErroNum": 0                // データレポートがタイムアウトしたために返されたエラーの数。
      }
         ......
 ]

8. 例

public class MainActivity extends AppCompatActivity {
   private Button button;
   private TextView tvInfo;
   private TextView tvResult;
   private String hostUrl = "http://www.taobao.com"; // http://www.taobao.com を、解決するドメイン名に対応する URL に置き換えます。
   private String hostName = "www.taobao.com"; // www.taobao.com を、解決するドメイン名に置き換えます。
   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() {
                      // Alibaba Cloud パブリック DNS SDK の getIPV4ByHost メソッドを呼び出して、指定されたドメイン名から解決された IP アドレスを取得します。
                      String ip = DNSResolver.getInstance().getIPV4ByHost(hostName);
                      if(ip != null){
                         tvInfo.setText("ドメイン名から解決された IP アドレス: "+ ip);
                      }
                      // Alibaba Cloud パブリック DNS SDK の getIPV4DInfoByUrl メソッドを呼び出して、指定されたドメイン名が解決された後に DomainInfo オブジェクトの URL を取得します。 URL では、host フィールドが 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 Account ID = "Your Account ID"; // Alibaba Cloud DNS コンソールで SDK にアクセスするために使用するアカウント ID を指定します。
    private String AccessKey ID = "Your AccessKey ID"; // Alibaba Cloud DNS コンソールで SDK にアクセスするために使用するアクセスキー ID を指定します。
    private String AccessKey Secret = "Your AccessKey secret"; // Alibaba Cloud DNS コンソールで SDK にアクセスするために使用するアクセスキー シークレットを指定します。

    @Override
    public void onCreate() {
       super.onCreate();
       DNSResolver.Init(this, Account ID, AccessKey ID, AccessKey Secret); // Alibaba Cloud DNS コンソールで SDK にアクセスするために使用するアカウント ID、アクセスキー ID、およびアクセスキー シークレットを指定します。
       DNSResolver.setKeepAliveDomains(new String[]{"キャッシュ保持機能を有効にするドメイン名 1","キャッシュ保持機能を有効にするドメイン名 2",...}); // キャッシュ保持機能を有効にするドメイン名を指定します。 TTL 期間の 75% が経過すると、ドメイン名が自動的に解決されます。 これにより、解決中にドメイン名に対する DNS リクエストが常にキャッシュされた DNS 結果と一致します。
       DNSResolver.getInstance().preLoadDomains(DNSResolver.QTYPE_IPV4,new String[]{"DNS 結果をプリロードするドメイン名 1","DNS 結果をプリロードするドメイン名 2",...}); // 事前に解決し、Alibaba Cloud パブリック DNS を使用して解決する IPv4 ドメイン名を指定します。
    }
}

使用上の注意

1. Alibaba Cloud パブリック DNS を使用してドメイン名を IP アドレスに解決した後、その IP アドレスを使用してビジネスリクエストを送信できます。 HTTP リクエストヘッダーの Host フィールドを、解決されたドメイン名として指定する必要があります。

2. 通常のサービス実行を確保するために、Alibaba Cloud パブリック DNS SDK を使用してドメイン名がマッピングされている IP アドレスを取得しない場合は、元のドメイン名の URL を使用してリクエストを送信する必要があります。 次のセクションでは、サンプルコードを示します。

   String ip = DNSResolver.getInstance().getIPV4ByHost("ドメイン名");
   if (ip != null) {
   	// URL のホスト名を IP アドレスに置き換えてリクエストを送信します。
   }else {
   	// 元のドメイン名の URL を使用してリクエストを送信します。
   }

3. デモプロジェクトは、Alibaba Cloud パブリック DNS SDK の使用方法を学ぶのに役立ちます。 デモプロジェクトをダウンロードして参照できます。

4. アプリが Alibaba Cloud パブリック DNS SDK と統合されているかどうかを確認するには、Alibaba Cloud DNS コンソールの [再帰的解決 ( パブリック DNS )] ページの [トラフィック分析] タブでトラフィックを確認します。 トラフィックが生成されない場合は、[アカウント ID]、[アクセスキー ID]、および [アクセスキー シークレット] パラメータの値が有効かどうかを確認します。