me.melchor9000.net.resolver

Class DNSResolver

java.lang.Object

me.melchor9000.net.resolver.DNSResolver

All Implemented Interfaces:

java.lang.AutoCloseable, Callback<Socket>

public class DNSResolver
extends java.lang.Object
implements java.lang.AutoCloseable, Callback<Socket>

DNS resolver for any domain.

Constructor Summary

Constructors

Constructor and Description
DNSResolver(IOService service) Deprecated.
DNSResolver(IOService service, DNSServerProvider lookupList) Creates a DNSResolver using the DNS servers lookup method.

Method Summary

Modifier and Type	Method and Description
void	call(Socket arg) Executes the block of code with the argument arg.
void	close()
Future<java.lang.Void>	closeAsync() Closes the resolver asynchronously
java.lang.Iterable<java.net.InetAddress>	resolve(java.lang.String name) Resolves the domain name to IPv4 and IPv6 addresses.
Future<java.lang.Iterable<java.net.InetAddress>>	resolveAsync(java.lang.String name) Resolves the domain name to IPv4 and IPv6 addresses.
Future<java.lang.Iterable<java.net.InetAddress>>	resolveAsyncV4(java.lang.String name) Resolves the domain name to IPv4 addresses.
Future<java.lang.Iterable<java.net.InetAddress>>	resolveAsyncV6(java.lang.String name) Resolves the domain name to IPv6 addresses.
java.lang.Iterable<java.net.InetAddress>	resolveV4(java.lang.String name) Resolves the domain name to IPv4 addresses.
java.lang.Iterable<java.net.InetAddress>	resolveV6(java.lang.String name) Resolves the domain name to IPv6 addresses.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DNSResolver

public DNSResolver(@NotNull
                   IOService service,
                   @NotNull
                   DNSServerProvider lookupList)

Creates a DNSResolver using the DNS servers lookup method.

Parameters:

service - IOService

lookupList - One type of DNS server provider

See Also:

DNSServerProvider

DNSResolver

@Deprecated
public DNSResolver(IOService service)

Deprecated.

Creates a DNSResolver using the default servers (84.200.69.80 and 2001:1608:10:25::9249:d69b from dns.watch). It is recommended to use the DNSResolver(IOService, DNSServerProvider) constructor to fetch the configuration from some system provider.

Parameters:

service - IOService

Method Detail

resolveAsyncV4

@NotNull
public Future<java.lang.Iterable<java.net.InetAddress>> resolveAsyncV4(@NotNull
                                                                                java.lang.String name)

Resolves the domain name to IPv4 addresses. Will try using any of the configured DNS servers in the OS.

Parameters:

name - domain name to resolveV4

Returns:

a Future representing the task

resolveAsyncV6

@NotNull
public Future<java.lang.Iterable<java.net.InetAddress>> resolveAsyncV6(@NotNull
                                                                                java.lang.String name)

Resolves the domain name to IPv6 addresses. Will try using any of the configured DNS servers in the OS.

Parameters:

name - domain name to resolveV4

Returns:

a Future representing the task

resolveAsync

@NotNull
public Future<java.lang.Iterable<java.net.InetAddress>> resolveAsync(@NotNull
                                                                              java.lang.String name)

Resolves the domain name to IPv4 and IPv6 addresses. Will try using any of the configured DNS servers in the OS.

Parameters:

name - domain name to resolveV4

Returns:

a Future representing the task

resolveV4

@NotNull
public java.lang.Iterable<java.net.InetAddress> resolveV4(@NotNull
                                                                   java.lang.String name)

Resolves the domain name to IPv4 addresses. Will try using any of the configured DNS servers in the OS.

Parameters:

name - domain name to resolveV4

Returns:

an Iterable object with the IP addresses or null

resolveV6

@NotNull
public java.lang.Iterable<java.net.InetAddress> resolveV6(@NotNull
                                                                   java.lang.String name)

Resolves the domain name to IPv6 addresses. Will try using any of the configured DNS servers in the OS.

Parameters:

name - domain name to resolveV4

Returns:

an Iterable object with the IP addresses or null

resolve

@NotNull
public java.lang.Iterable<java.net.InetAddress> resolve(@NotNull
                                                                 java.lang.String name)

Resolves the domain name to IPv4 and IPv6 addresses. Will try using any of the configured DNS servers in the OS.

Parameters:

name - domain name to resolveV4

Returns:

a Future representing the task

close

public void close()

Specified by:

close in interface java.lang.AutoCloseable

closeAsync

@NotNull
public Future<java.lang.Void> closeAsync()

Closes the resolver asynchronously

Returns:

a Future representing the close task

call

public void call(Socket arg)

Description copied from interface: Callback

Executes the block of code with the argument arg.

Specified by:

call in interface Callback<Socket>

Parameters:

arg - argument to pass