HTTPDNS:Java SDK 統合ガイド

1.1. サービスの有効化

HTTPDNS を有効化するには、「クイックスタート」をご参照ください。

1.2. 設定の取得

EMAS コンソールの開発者向け設定ページから AccountId、SecretKey、AESSecretKey を取得します。この情報は SDK の初期化に必要です。詳細については、「開発者向け設定」をご参照ください。

2.1. リポジトリアドレスの設定

SDK は Alibaba Cloud Maven リポジトリに公開されています。リポジトリアドレスを追加してください。

repositories {
    maven { 
      url 'https://maven.aliyun.com/nexus/content/repositories/releases/' 
    }
}

<repositories>
    <repository>
        <id>aliyun</id>
        <url>https://maven.aliyun.com/nexus/content/repositories/releases/</url>
    </repository>
</repositories>

2.2. SDK 依存関係の追加

dependencies {
    implementation 'com.aliyun.ams:alicloud-java-httpdns:1.0.0'
}

<dependency>
    <groupId>com.aliyun.ams</groupId>
    <artifactId>alicloud-java-httpdns</artifactId>
    <version>1.0.0</version>
</dependency>

3.1. 設定の初期化

アプリケーションの起動後、SDK を初期化して HTTPDNS 機能を有効にします。初期化には、AccountId、SecretKey、機能トグルなどの設定が含まれます。以下のコードは一例です。

import com.alibaba.sdk.java.httpdns.HttpDnsClient;
import com.alibaba.sdk.java.httpdns.InitConfig;
import com.alibaba.sdk.java.httpdns.RequestIpType;

// 設定を作成
InitConfig config = new InitConfig.Builder()
    .setSecretKey("your-secret-key")           // 署名キー
    .setEnableHttps(true)                      // HTTPS を使用した名前解決
    .setTimeoutMillis(2000)                    // タイムアウト期間 (ミリ秒)
    .setEnableExpiredIp(true)                  // 期限切れ IP の使用を許可
    .enableMemoryCache(true)                   // メモリキャッシュを有効化 (デフォルトで有効)
    .build();

// 初期化
HttpDnsClient.init("your-account-id", config);

// クライアントインスタンスを取得
HttpDnsClient client = HttpDnsClient.getClient("your-account-id");

import com.alibaba.sdk.java.httpdns.log.HttpDnsLog;
import com.alibaba.sdk.java.httpdns.ILogger;

// ログ出力を有効化
HttpDnsLog.enable(true);

// カスタムロギングインターフェイスを設定
HttpDnsLog.setLogger(new ILogger() {
    @Override
    public void log(String msg) {
        System.out.println("[HTTPDNS] " + msg);
    }
});

String sessionId = client.getSessionId();
System.out.println("SessionId = " + sessionId);

3.2. ドメイン名の名前解決

List<String> hosts = Arrays.asList("www.aliyun.com", "www.example.com");
client.setPreResolveHosts(hosts, RequestIpType.both);

HTTPDNSResult result = client.getHttpDnsResultForHostSyncNonBlocking(
    "www.aliyun.com", 
    RequestIpType.both
);

if (result != null && result.getIps() != null) {
    String[] ipv4List = result.getIps();
}

if (result != null && result.getIpv6s() != null) {
    String[] ipv6List = result.getIpv6s();
}