HTTPDNS:Integrasi SDK Node.js

3.1.1 Konfigurasi log

Untuk menampilkan log HTTPDNS selama pengembangan aplikasi, konfigurasikan logger saat inisialisasi. Kode berikut memberikan contohnya:

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

3.2.1 Resolusi sinkron non-blocking (Direkomendasikan)

Gunakan metode resolusi sinkron non-blocking yang langsung mengembalikan hasil dari cache tanpa memblokir eksekusi program. Kode berikut memberikan contohnya:

function resolve() {
  const result = client.getHttpDnsResultForHostSyncNonBlocking('www.aliyun.com');
  if (result) {
    console.log('Hasil resolusi:', result.ipv4);
    console.log('Nama domain:', result.domain);
    console.log('IPv6:', result.ipv6);
  } else {
    console.log('Cache miss. Resolusi asinkron sedang berlangsung...');
    // Resolusi asinkron telah dimulai di latar belakang. Panggilan berikutnya akan mengembalikan hasilnya.
  }
}

3.2.2 Resolusi sinkron

Untuk memastikan Anda menerima hasil resolusi, gunakan metode resolusi sinkron yang menunggu hingga proses resolusi selesai sebelum melanjutkan. Kode berikut memberikan contohnya:

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

4.2.1 Integrasi Axios

Integrasikan Axios menggunakan agent. Langkah-langkah utamanya sebagai berikut:

Langkah 1: Buat fungsi lookup kustom

const dns = require('dns');

function createHTTPDNSLookup(httpdnsClient) {
  return (hostname, options, callback) => {
    // Standarkan parameter
    if (typeof options === 'function') {
      callback = options;
      options = {};
    }
  
    // Pastikan callback tersedia
    if (typeof callback !== 'function') {
      throw new Error('callback must be a function');
    }
  
    // Gunakan HTTPDNS untuk menyelesaikan nama domain
    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) {
          // Kembalikan semua alamat 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 {
          // Prioritaskan IPv4, lalu 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);
  };
}

Langkah 2: Buat agen kustom

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

Langkah 3: Buat instance Axios

const axios = require('axios');

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

// Penggunaan
const response = await instance.get('https://www.aliyun.com');

4.2.2 Integrasi urllib

Integrasikan urllib menggunakan agent. Langkah-langkah utamanya sebagai berikut:

Langkah 1: Buat fungsi lookup kustom

const dns = require('dns');

function createHTTPDNSLookup(httpdnsClient) {
  return (hostname, options, callback) => {
    // Standarkan parameter
    if (typeof options === 'function') {
      callback = options;
      options = {};
    }
  
    // Pastikan callback tersedia
    if (typeof callback !== 'function') {
      throw new Error('callback must be a function');
    }
  
    // Gunakan HTTPDNS untuk menyelesaikan nama domain
    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) {
          // Kembalikan semua alamat 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 {
          // Prioritaskan IPv4, lalu 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);
  };
}

Langkah 2: Buat agen kustom

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

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

Langkah 3: Kirim permintaan

async function request(url, options = {}) {
  // Pilih agent berdasarkan jenis URL
  if (url.startsWith('https://')) {
    options.httpsAgent = httpsAgent;
  } else {
    options.agent = httpAgent; // Buat httpAgent secara serupa
  }
  
  options.timeout = options.timeout || 10000;
  
  try {
    return await urllib.request(url, options);
  } catch (error) {
    // Logika retry otomatis
    if (isConnectionError(error) && !options._retried) {
      options._retried = true;
      delete options.httpsAgent; // Ulangi menggunakan DNS sistem
      return await urllib.request(url, options);
    }
    throw error;
  }
}