io.netty.resolver.dns

Class UnixResolverDnsServerAddressStreamProvider

java.lang.Object

io.netty.resolver.dns.UnixResolverDnsServerAddressStreamProvider

All Implemented Interfaces:

DnsServerAddressStreamProvider

@UnstableApi
public final class UnixResolverDnsServerAddressStreamProvider
extends Object
implements DnsServerAddressStreamProvider

Able to parse files such as /etc/resolv.conf and /etc/resolver to respect the system default domain servers.

Constructor Summary

Constructors

Constructor and Description
UnixResolverDnsServerAddressStreamProvider(File etcResolvConf, File... etcResolverFiles) Parse a file of the format /etc/resolv.conf which may contain the default DNS server to use, and also overrides for individual domains.
UnixResolverDnsServerAddressStreamProvider(String etcResolvConf, String etcResolverDir) Parse a file of the format /etc/resolv.conf which may contain the default DNS server to use, and also overrides for individual domains.

Method Summary

Modifier and Type	Method and Description
DnsServerAddressStream	nameServerAddressStream(String hostname) Ask this provider for the name servers to query for hostname.
static DnsServerAddressStreamProvider	parseSilently() Attempt to parse /etc/resolv.conf and files in the /etc/resolver directory by default.

Methods inherited from class java.lang.Object

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

Constructor Detail

UnixResolverDnsServerAddressStreamProvider

public UnixResolverDnsServerAddressStreamProvider(File etcResolvConf,
                                                  File... etcResolverFiles)
                                           throws IOException

Parse a file of the format /etc/resolv.conf which may contain the default DNS server to use, and also overrides for individual domains. Also parse list of files of the format /etc/resolver which may contain multiple files to override the name servers used for multimple domains.

Parameters:

etcResolvConf - /etc/resolv.conf.

etcResolverFiles - List of files of the format defined in /etc/resolver.

Throws:

IOException - If an error occurs while parsing the input files.

UnixResolverDnsServerAddressStreamProvider

public UnixResolverDnsServerAddressStreamProvider(String etcResolvConf,
                                                  String etcResolverDir)
                                           throws IOException

Parse a file of the format /etc/resolv.conf which may contain the default DNS server to use, and also overrides for individual domains. Also parse a directory of the format /etc/resolver which may contain multiple files to override the name servers used for multimple domains.

Parameters:

etcResolvConf - /etc/resolv.conf.

etcResolverDir - Directory containing files of the format defined in /etc/resolver.

Throws:

IOException - If an error occurs while parsing the input files.

Method Detail

parseSilently

public static DnsServerAddressStreamProvider parseSilently()

Attempt to parse /etc/resolv.conf and files in the /etc/resolver directory by default. A failure to parse will return DefaultDnsServerAddressStreamProvider.

nameServerAddressStream

public DnsServerAddressStream nameServerAddressStream(String hostname)

Description copied from interface: DnsServerAddressStreamProvider

Ask this provider for the name servers to query for hostname.

Specified by:

nameServerAddressStream in interface DnsServerAddressStreamProvider

Parameters:

hostname - The hostname for which to lookup the DNS server addressed to use. If this is the final DnsServerAddressStreamProvider to be queried then generally empty string or '.' correspond to the default DnsServerAddressStream.

Returns:

The DnsServerAddressStream which should be used to resolve hostname.