Apache HttpClient への HTTPDNS 統合 - HTTPDNS

このドキュメントでは、Java アプリケーションで HTTPDNS を Apache HttpClient と統合する方法について説明します。

1. 背景情報

Apache HttpClient は、Java エコシステムで広く使用されている HTTP ネットワークライブラリです。4.x と 5.x の 2 つのメジャーバージョンをサポートしています。DnsResolver インターフェイスを実装することで、HTTPDNS を HttpClient に統合できます。

2. カスタム DnsResolver の実装

HttpClient 5.x

import org.apache.hc.client5.http.DnsResolver;
import com.alibaba.sdk.java.httpdns.HttpDnsClient;
import com.alibaba.sdk.java.httpdns.HTTPDNSResult;
import com.alibaba.sdk.java.httpdns.RequestIpType;

import java.net.InetAddress;
import java.net.UnknownHostException;
import java.util.ArrayList;
import java.util.List;

public class HttpDnsResolver implements DnsResolver {
    
    private final HttpDnsClient httpDnsClient;
    
    public HttpDnsResolver(HttpDnsClient httpDnsClient) {
        this.httpDnsClient = httpDnsClient;
    }

    @Override
    public String resolveCanonicalHostname(String host) {
        return host;
    }

    @Override
    public InetAddress[] resolve(String host) throws UnknownHostException {
        HTTPDNSResult result = httpDnsClient.getHttpDnsResultForHostSyncNonBlocking(host, RequestIpType.both);

        List<InetAddress> addresses = new ArrayList<>();
        try {
            if (result != null && result.getIps() != null) {
                for (String ip : result.getIps()) {
                    addresses.add(InetAddress.getByName(ip));
                }
            }
            if (result != null && result.getIpv6s() != null) {
                for (String ip : result.getIpv6s()) {
                    addresses.add(InetAddress.getByName(ip));
                }
            }
        } catch (UnknownHostException e) {
            // 単一の IP アドレスの解析失敗は無視します。
        }
        
        if (!addresses.isEmpty()) {
            return addresses.toArray(new InetAddress[0]);
        }
        
        // システム DNS にフォールバックします。
        return InetAddress.getAllByName(host);
    }
}

HttpClient 4.x

import org.apache.http.conn.DnsResolver;
import com.alibaba.sdk.java.httpdns.HttpDnsClient;
import com.alibaba.sdk.java.httpdns.HTTPDNSResult;
import com.alibaba.sdk.java.httpdns.RequestIpType;

import java.net.InetAddress;
import java.net.UnknownHostException;
import java.util.ArrayList;
import java.util.List;

public class HttpDnsResolver4 implements DnsResolver {
    
    private final HttpDnsClient httpDnsClient;
    
    public HttpDnsResolver4(HttpDnsClient httpDnsClient) {
        this.httpDnsClient = httpDnsClient;
    }

    @Override
    public InetAddress[] resolve(String host) throws UnknownHostException {
        HTTPDNSResult result = httpDnsClient.getHttpDnsResultForHostSyncNonBlocking(host, RequestIpType.both);

        List<InetAddress> addresses = new ArrayList<>();
        try {
            if (result != null && result.getIps() != null) {
                for (String ip : result.getIps()) {
                    addresses.add(InetAddress.getByName(ip));
                }
            }
            if (result != null && result.getIpv6s() != null) {
                for (String ip : result.getIpv6s()) {
                    addresses.add(InetAddress.getByName(ip));
                }
            }
        } catch (UnknownHostException e) {
            // 単一の IP アドレスの解析失敗は無視します。
        }
        
        if (!addresses.isEmpty()) {
            return addresses.toArray(new InetAddress[0]);
        }
        
        // システム DNS にフォールバックします。
        return InetAddress.getAllByName(host);
    }
}

説明

4.x と 5.x の DnsResolver は、異なるパッケージに由来します。バージョン 5.x では、resolveCanonicalHostname() メソッドも実装する必要があります。

3. HttpClient の設定

HttpClient 5.x

import org.apache.hc.client5.http.impl.classic.CloseableHttpClient;
import org.apache.hc.client5.http.impl.classic.HttpClients;
import org.apache.hc.client5.http.impl.io.PoolingHttpClientConnectionManagerBuilder;
import org.apache.hc.client5.http.io.HttpClientConnectionManager;

HttpDnsClient httpDnsClient = HttpDnsClient.getClient(accountId);

HttpClientConnectionManager connectionManager = PoolingHttpClientConnectionManagerBuilder.create()
    .setDnsResolver(new HttpDnsResolver(httpDnsClient))
    .build();

CloseableHttpClient httpClient = HttpClients.custom()
    .setConnectionManager(connectionManager)
    .build();

HttpClient 4.x

import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;

HttpDnsClient httpDnsClient = HttpDnsClient.getClient(accountId);

CloseableHttpClient httpClient = HttpClients.custom()
    .setDnsResolver(new HttpDnsResolver4(httpDnsClient))
    .build();

4. まとめ

Apache HttpClient と HTTPDNS を併用する主な利点は次のとおりです：

シンプルな実装： DnsResolver インターフェイスを実装するだけで統合できます。
高い汎用性： HTTPS、サーバ名表示 (SNI)、Cookie の設定などのシナリオで機能します。証明書の検証やドメイン名の検証などの追加手順を処理する必要はありません。
バージョン互換性： HttpClient 4.x と 5.x の両方をサポートします。