HTTPDNS:Node.js SDK との統合

3.1.1 ログ設定

アプリケーション開発中に HTTPDNS ログを出力するには、初期化中にロガーを設定します。次のコードは例です：

const client = createClient({
  ...,
  logger: console
});

3.2.1 同期非ブロッキング名前解決 (推奨)

同期非ブロッキング名前解決メソッドを使用します。このメソッドは、プログラムの実行をブロックすることなく、キャッシュされた結果を即座に返します。次のコードは例です：

function resolve() {
  const result = client.getHttpDnsResultForHostSyncNonBlocking('www.aliyun.com');
  if (result) {
    console.log('Resolution result:', result.ipv4);
    console.log('Domain name:', result.domain);
    console.log('IPv6:', result.ipv6);
  } else {
    console.log('Cache miss. Asynchronous resolution in progress...');
    // 非同期名前解決がバックグラウンドで開始されました。次回の呼び出しで結果が返されます。
  }
}

3.2.2 同期名前解決

名前解決の結果を確実に受け取るには、同期名前解決メソッドを使用します。このメソッドは、名前解決が完了するまで待機してから次に進みます。次のコードは例です：

async function resolve() {
  try {
    const result = await client.getHttpDnsResultForHostSync('www.aliyun.com');
    console.log('Domain name:', result.domain);
    console.log('IPv4:', result.ipv4);
    console.log('IPv6:', result.ipv6);
  } catch (error) {
    console.error('Resolution failed:', error);
  }
}

4.2.1 Axios の統合

エージェントを使用して Axios を統合します。主な手順は次のとおりです：

ステップ 1: カスタムルックアップ関数の作成

const dns = require('dns');

function createHTTPDNSLookup(httpdnsClient) {
  return (hostname, options, callback) => {
    // パラメーターを標準化します
    if (typeof options === 'function') {
      callback = options;
      options = {};
    }
  
    // コールバックが存在することを確認します
    if (typeof callback !== 'function') {
      throw new Error('callback must be a function');
    }
  
    // HTTPDNS を使用してドメイン名を解決します
    const result = httpdnsClient.getHttpDnsResultForHostSyncNonBlocking(hostname);
  
    if (result) {
      const hasIPv4 = result.ipv4 && result.ipv4.length > 0;
      const hasIPv6 = result.ipv6 && result.ipv6.length > 0;
  
      if (hasIPv4 || hasIPv6) {
        if (options && options.all) {
          // すべての IP アドレスを返します
          const addresses = [
            ...(hasIPv4 ? result.ipv4.map(ip => ({ address: ip, family: 4 })) : []),
            ...(hasIPv6 ? result.ipv6.map(ip => ({ address: ip, family: 6 })) : [])
          ];
          console.log(`[DNS Lookup] HTTPDNS resolved successfully: ${hostname} -> Returning all IP addresses (${addresses.length})`);
          callback(null, addresses);
        } else {
          // IPv4 を優先し、次に IPv6 を使用します
          if (hasIPv4) {
            console.log(`[DNS Lookup] HTTPDNS resolved successfully: ${hostname} -> ${result.ipv4[0]} (IPv4)`);
            callback(null, result.ipv4[0], 4);
          } else {
            console.log(`[DNS Lookup] HTTPDNS resolved successfully: ${hostname} -> ${result.ipv6[0]} (IPv6)`);
            callback(null, result.ipv6[0], 6);
          }
        }
        return;
      }
    }
  
    console.log(`[DNS Lookup] No available IP from HTTPDNS. Falling back to system DNS for: ${hostname}`);
    dns.lookup(hostname, options, callback);
  };
}

ステップ 2: カスタムエージェントの作成

const https = require('https');
const httpsAgent = new https.Agent({
  lookup: createHTTPDNSLookup(httpdnsClient),
  keepAlive: true,
  maxSockets: 10
});

ステップ 3: Axios インスタンスの作成

const axios = require('axios');

const instance = axios.create({
  httpsAgent: httpsAgent,
  timeout: 10000
});

// 使用方法
const response = await instance.get('https://www.aliyun.com');

4.2.2 urllib の統合

エージェントを使用して urllib を統合します。主な手順は次のとおりです：

ステップ 1: カスタムルックアップ関数の作成

const dns = require('dns');

function createHTTPDNSLookup(httpdnsClient) {
  return (hostname, options, callback) => {
    // パラメーターを標準化します
    if (typeof options === 'function') {
      callback = options;
      options = {};
    }
  
    // コールバックが存在することを確認します
    if (typeof callback !== 'function') {
      throw new Error('callback must be a function');
    }
  
    // HTTPDNS を使用してドメイン名を解決します
    const result = httpdnsClient.getHttpDnsResultForHostSyncNonBlocking(hostname);
  
    if (result) {
      const hasIPv4 = result.ipv4 && result.ipv4.length > 0;
      const hasIPv6 = result.ipv6 && result.ipv6.length > 0;
  
      if (hasIPv4 || hasIPv6) {
        if (options && options.all) {
          // すべての IP アドレスを返します
          const addresses = [
            ...(hasIPv4 ? result.ipv4.map(ip => ({ address: ip, family: 4 })) : []),
            ...(hasIPv6 ? result.ipv6.map(ip => ({ address: ip, family: 6 })) : [])
          ];
          console.log(`[DNS Lookup] HTTPDNS resolved successfully: ${hostname} -> Returning all IP addresses (${addresses.length})`);
          callback(null, addresses);
        } else {
          // IPv4 を優先し、次に IPv6 を使用します
          if (hasIPv4) {
            console.log(`[DNS Lookup] HTTPDNS resolved successfully: ${hostname} -> ${result.ipv4[0]} (IPv4)`);
            callback(null, result.ipv4[0], 4);
          } else {
            console.log(`[DNS Lookup] HTTPDNS resolved successfully: ${hostname} -> ${result.ipv6[0]} (IPv6)`);
            callback(null, result.ipv6[0], 6);
          }
        }
        return;
      }
    }
  
    console.log(`[DNS Lookup] No available IP from HTTPDNS. Falling back to system DNS for: ${hostname}`);
    dns.lookup(hostname, options, callback);
  };
}

ステップ 2: カスタムエージェントの作成

const urllib = require('urllib');
const https = require('https');

const httpsAgent = new https.Agent({
  lookup: createHTTPDNSLookup(httpdnsClient),
  keepAlive: true,
  maxSockets: 10
});

ステップ 3：リクエストの送信

async function request(url, options = {}) {
  // URL タイプに基づいてエージェントを選択します
  if (url.startsWith('https://')) {
    options.httpsAgent = httpsAgent;
  } else {
    options.agent = httpAgent; // 同様に httpAgent を作成します
  }
  
  options.timeout = options.timeout || 10000;
  
  try {
    return await urllib.request(url, options);
  } catch (error) {
    // 自動リトライロジック
    if (isConnectionError(error) && !options._retried) {
      options._retried = true;
      delete options.httpsAgent; // システム DNS を使用してリトライします
      return await urllib.request(url, options);
    }
    throw error;
  }
}