Module lettuce.core

Package io.lettuce.core.resource

Class DirContextDnsResolver

java.lang.Object

io.lettuce.core.resource.DirContextDnsResolver

All Implemented Interfaces:

DnsResolver, Closeable, AutoCloseable

public class DirContextDnsResolver
extends Object
implements DnsResolver, Closeable

DNS Resolver based on Java's com.sun.jndi.dns.DnsContextFactory. This resolver resolves hostnames to IPv4 and IPv6 addresses using A, AAAA and CNAME records. Java IP stack preferences are read from system properties and taken into account when resolving names.

The default configuration uses system-configured DNS server addresses to perform lookups but server adresses can be specified using DirContextDnsResolver(Iterable). Custom DNS servers can be specified by using DirContextDnsResolver(String) or DirContextDnsResolver(Iterable).

Since:

4.2

Author:

Mark Paluch

Constructor Summary

Constructors

Constructor	Description
DirContextDnsResolver()	Creates a new DirContextDnsResolver using system-configured DNS servers.
DirContextDnsResolver(boolean preferIpv4, boolean preferIpv6, Properties properties)	Creates a new DirContextDnsResolver for the given stack preference and properties.
DirContextDnsResolver(Iterable<String> dnsServers)	Creates a new DirContextDnsResolver using a collection of DNS servers.
DirContextDnsResolver(String dnsServer)	Creates a new DirContextDnsResolver using a collection of DNS servers.

Method Summary

Modifier and Type	Method	Description
void	close()
InetAddress[]	resolve(String host)	Perform hostname to address resolution.

Methods inherited from class java.lang.Object

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

Constructor Details

DirContextDnsResolver

public DirContextDnsResolver()

Creates a new DirContextDnsResolver using system-configured DNS servers.

DirContextDnsResolver

public DirContextDnsResolver(String dnsServer)

Creates a new DirContextDnsResolver using a collection of DNS servers.

Parameters:

dnsServer - must not be null and not empty.

DirContextDnsResolver

public DirContextDnsResolver(Iterable<String> dnsServers)

Creates a new DirContextDnsResolver using a collection of DNS servers.

Parameters:

dnsServers - must not be null and not empty.

DirContextDnsResolver

public DirContextDnsResolver(boolean preferIpv4,
boolean preferIpv6,
Properties properties)

Creates a new DirContextDnsResolver for the given stack preference and properties.

Parameters:

preferIpv4 - flag to prefer IPv4 over IPv6 address resolution.

preferIpv6 - flag to prefer IPv6 over IPv4 address resolution.

properties - custom properties for creating the context, must not be null.

Method Details

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Throws:

IOException

resolve

public InetAddress[] resolve(String host)
                      throws UnknownHostException

Perform hostname to address resolution.

Specified by:

resolve in interface DnsResolver

Parameters:

host - the hostname, must not be empty or null.

Returns:

array of one or more addresses

Throws:

UnknownHostException