cloudstrife9999/java-quick-a-aaaa-dns-over-https

Client library to perform DNS-over-HTTPS queries with Java, and to obtain an HttpsURLConnection, or an SSLSocket after DNS-over-HTTPS queries.

Documentation

Description

Quick Java library to perform A and AAAA DNS queries over HTTPS to 1.1.1.1, and get a HttpsURLConnection or an SSLSocket where the domain name of the server is indicated via SNI (and the hostname is resolved with DNS over HTTPS, if needed).

Usage for quick DNS-over-HTTPS queries only

Doh client = new Doh();
List<String> ipv4Results = client.resolveToIPv4(domainName);
List<String> ipv6Results = client.resolveToIPv6(domainName);

Getting an HttpsURLConnection (DNS-over-HTTPS is used to resolve the domain name)

// If omitted or true, an AAAA DNS request is sent first, and the first returned IPv6 is used.
// If false, or no IPv6 is available according to the DNS response, an A DNS request is sent, and the first returned IPv4 is used.
boolean preferIPv6IfAvailable = false;
HttpsURLConnection connection = HttpsConnectionWithDoHAndSNI.connectAfterResolvingViaDoH(<domain-name-here>, <subresource-here>, preferIPv6IfAvailable);

Getting an SSLSocket (DNS-over-HTTPS is used to resolve the domain name)

// If omitted or true, an AAAA DNS request is sent first, and the first returned IPv6 is used.
// If false, or no IPv6 is available according to the DNS response, an A DNS request is sent, and the first returned IPv4 is used.
boolean preferIPv6IfAvailable = false;
SSLSocket socket = TLSSocketFactoryWithDoHAndSNI.getInstance(domainName).createSocket(domainName, 443, preferIPv6IfAvailable);