Netty/Resolver/DNS 4.1.107.Final · io.netty.resolver.dns.UnixResolverDnsServerAddressStreamProvider

Field Summary

Modifier and Type	Field and Description
private final DnsServerAddresses	defaultNameServerAddresses
private static final String	DOMAIN_ROW_LABEL
private final Map<String, DnsServerAddresses>	domainToNameServerStreamMap
private static final String	ETC_RESOLV_CONF_FILE
private static final String	ETC_RESOLVER_DIR
private static final InternalLogger	logger
private static final String	NAMESERVER_ROW_LABEL
private static final String	OPTIONS_ROTATE_FLAG
private static final String	OPTIONS_ROW_LABEL
private static final String	PORT_ROW_LABEL
private static final String	RES_OPTIONS
private static final String	SEARCH_ROW_LABEL
private static final String	SORTLIST_ROW_LABEL
private static final Pattern	WHITESPACE_PATTERN

Constructor Summary

Access	Constructor and Description
public	UnixResolverDnsServerAddressStreamProvider(File /etc/resolv.conf. etcResolvConf, File... List of files of the format defined in /etc/resolver. 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.
public	UnixResolverDnsServerAddressStreamProvider(String /etc/resolv.conf. etcResolvConf, String Directory containing files of the format defined in /etc/resolver. 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
private boolean	mayOverrideNameServers()
public DnsServerAddressStream	nameServerAddressStream(String 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`. hostname) Implements io.netty.resolver.dns.DnsServerAddressStreamProvider.nameServerAddressStream. Ask this provider for the name servers to query for `hostname`.
private static Map<String, DnsServerAddresses>	parse(File... etcResolverFiles)
pack-priv static UnixResolverOptions	Returns: The options values provided by /etc/resolve.conf. parseEtcResolverOptions() Parse /etc/resolv.conf and return options of interest, namely: timeout, attempts and ndots.
pack-priv static UnixResolverOptions	Returns: The options values provided by /etc/resolve.conf. parseEtcResolverOptions(File a file of the format /etc/resolv.conf. etcResolvConf) Parse a file of the format /etc/resolv.conf and return options of interest, namely: timeout, attempts and ndots.
pack-priv static List<String>	Returns: List of search domains. parseEtcResolverSearchDomains() Parse a file of the format /etc/resolv.conf and return the list of search domains found in it or an empty list if not found.
pack-priv static List<String>	Returns: List of search domains. parseEtcResolverSearchDomains(File a file of the format /etc/resolv.conf. etcResolvConf) Parse a file of the format /etc/resolv.conf and return the list of search domains found in it or an empty list if not found.
private static int	parseResIntOption(String opt, String fullLabel)
private static void	parseResOptions(String line, UnixResolverOptions.Builder builder)
pack-priv static DnsServerAddressStreamProvider	parseSilently() Attempt to parse `/etc/resolv.conf` and files in the `/etc/resolver` directory by default.
private static void	putIfAbsent(Map<String, DnsServerAddresses> domainToNameServerStreamMap, String domainName, List<InetSocketAddress> addresses, boolean rotate)
private static void	putIfAbsent(Map<String, DnsServerAddresses> domainToNameServerStreamMap, String domainName, DnsServerAddresses addresses)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

defaultNameServerAddresses	back to summary
private final DnsServerAddresses defaultNameServerAddresses

DOMAIN_ROW_LABEL	back to summary
private static final String DOMAIN_ROW_LABEL

domainToNameServerStreamMap	back to summary
private final Map<String, DnsServerAddresses> domainToNameServerStreamMap

ETC_RESOLV_CONF_FILE	back to summary
private static final String ETC_RESOLV_CONF_FILE

ETC_RESOLVER_DIR	back to summary
private static final String ETC_RESOLVER_DIR

logger	back to summary
private static final InternalLogger logger

NAMESERVER_ROW_LABEL	back to summary
private static final String NAMESERVER_ROW_LABEL

OPTIONS_ROTATE_FLAG	back to summary
private static final String OPTIONS_ROTATE_FLAG

OPTIONS_ROW_LABEL	back to summary
private static final String OPTIONS_ROW_LABEL

PORT_ROW_LABEL	back to summary
private static final String PORT_ROW_LABEL

RES_OPTIONS	back to summary
private static final String RES_OPTIONS

SEARCH_ROW_LABEL	back to summary
private static final String SEARCH_ROW_LABEL

SORTLIST_ROW_LABEL	back to summary
private static final String SORTLIST_ROW_LABEL

WHITESPACE_PATTERN	back to summary
private static final Pattern WHITESPACE_PATTERN

Constructor Detail

UnixResolverDnsServerAddressStreamProvider	back to summary
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 multiple domains. Parameters etcResolvConf:File /etc/resolv.conf. etcResolverFiles:File[] List of files of the format defined in /etc/resolver. Exceptions IOException: If an error occurs while parsing the input files.

UnixResolverDnsServerAddressStreamProvider

back to summary

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 multiple domains.

Parameters

etcResolvConf:File: /etc/resolv.conf.
etcResolverFiles:File[]: List of files of the format defined in /etc/resolver.

Exceptions

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

UnixResolverDnsServerAddressStreamProvider	back to summary
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 multiple domains. Parameters etcResolvConf:String /etc/resolv.conf. etcResolverDir:String Directory containing files of the format defined in /etc/resolver. Exceptions IOException: If an error occurs while parsing the input files.

UnixResolverDnsServerAddressStreamProvider

back to summary

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 multiple domains.

Parameters

etcResolvConf:String: /etc/resolv.conf.
etcResolverDir:String: Directory containing files of the format defined in /etc/resolver.

Exceptions

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

Method Detail

mayOverrideNameServers	back to summary
private boolean mayOverrideNameServers()

nameServerAddressStream back to summary

nameServerAddressStream	back to summary
public DnsServerAddressStream nameServerAddressStream(String hostname) Implements io.netty.resolver.dns.DnsServerAddressStreamProvider.nameServerAddressStream. Doc from io.netty.resolver.dns.DnsServerAddressStreamProvider.nameServerAddressStream. Ask this provider for the name servers to query for `hostname`. Parameters hostname:String 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:DnsServerAddressStream The `DnsServerAddressStream` which should be used to resolve `hostname`. Annotations @Override

public DnsServerAddressStream nameServerAddressStream(String hostname)

Implements io.netty.resolver.dns.DnsServerAddressStreamProvider.nameServerAddressStream.

Doc from io.netty.resolver.dns.DnsServerAddressStreamProvider.nameServerAddressStream.

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

Parameters

hostname:String: 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:DnsServerAddressStream

The DnsServerAddressStream which should be used to resolve hostname.

Annotations

@Override

parse	back to summary
private static Map<String, DnsServerAddresses> parse(File... etcResolverFiles) throws IOException

parseEtcResolverOptions	back to summary
pack-priv static UnixResolverOptions parseEtcResolverOptions() throws IOException Parse /etc/resolv.conf and return options of interest, namely: timeout, attempts and ndots. Returns:UnixResolverOptions The options values provided by /etc/resolve.conf. Exceptions IOException: If a failure occurs parsing the file.

parseEtcResolverOptions

back to summary

pack-priv static UnixResolverOptions parseEtcResolverOptions() throws IOException

Parse /etc/resolv.conf and return options of interest, namely: timeout, attempts and ndots.

Returns:UnixResolverOptions

The options values provided by /etc/resolve.conf.

Exceptions

IOException:: If a failure occurs parsing the file.

parseEtcResolverOptions	back to summary
pack-priv static UnixResolverOptions parseEtcResolverOptions(File etcResolvConf) throws IOException Parse a file of the format /etc/resolv.conf and return options of interest, namely: timeout, attempts and ndots. Parameters etcResolvConf:File a file of the format /etc/resolv.conf. Returns:UnixResolverOptions The options values provided by /etc/resolve.conf. Exceptions IOException: If a failure occurs parsing the file.

parseEtcResolverOptions

back to summary

pack-priv static UnixResolverOptions parseEtcResolverOptions(File etcResolvConf) throws IOException

Parse a file of the format /etc/resolv.conf and return options of interest, namely: timeout, attempts and ndots.

Parameters

etcResolvConf:File: a file of the format /etc/resolv.conf.

Returns:UnixResolverOptions

The options values provided by /etc/resolve.conf.

Exceptions

IOException:: If a failure occurs parsing the file.

parseEtcResolverSearchDomains	back to summary
pack-priv static List<String> parseEtcResolverSearchDomains() throws IOException Parse a file of the format /etc/resolv.conf and return the list of search domains found in it or an empty list if not found. Returns:List<String> List of search domains. Exceptions IOException: If a failure occurs parsing the file.

parseEtcResolverSearchDomains

back to summary

pack-priv static List<String> parseEtcResolverSearchDomains() throws IOException

Parse a file of the format /etc/resolv.conf and return the list of search domains found in it or an empty list if not found.

Returns:List<String>

List of search domains.

Exceptions

IOException:: If a failure occurs parsing the file.

parseEtcResolverSearchDomains	back to summary
pack-priv static List<String> parseEtcResolverSearchDomains(File etcResolvConf) throws IOException Parse a file of the format /etc/resolv.conf and return the list of search domains found in it or an empty list if not found. Parameters etcResolvConf:File a file of the format /etc/resolv.conf. Returns:List<String> List of search domains. Exceptions IOException: If a failure occurs parsing the file.

parseEtcResolverSearchDomains

back to summary

pack-priv static List<String> parseEtcResolverSearchDomains(File etcResolvConf) throws IOException

Parse a file of the format /etc/resolv.conf and return the list of search domains found in it or an empty list if not found.

Parameters

etcResolvConf:File: a file of the format /etc/resolv.conf.

Returns:List<String>

List of search domains.

Exceptions

IOException:: If a failure occurs parsing the file.

parseResIntOption	back to summary
private static int parseResIntOption(String opt, String fullLabel)

parseResOptions	back to summary
private static void parseResOptions(String line, UnixResolverOptions.Builder builder)

parseSilently	back to summary
pack-priv 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`.

putIfAbsent	back to summary
private static void putIfAbsent(Map<String, DnsServerAddresses> domainToNameServerStreamMap, String domainName, List<InetSocketAddress> addresses, boolean rotate)

putIfAbsent	back to summary
private static void putIfAbsent(Map<String, DnsServerAddresses> domainToNameServerStreamMap, String domainName, DnsServerAddresses addresses)

public final Class UnixResolverDnsServerAddressStreamProvider

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail