io.netty.resolver.dns

类 DnsNameResolver

java.lang.Object

io.netty.resolver.SimpleNameResolver<java.net.InetAddress>

io.netty.resolver.InetNameResolver

io.netty.resolver.dns.DnsNameResolver

所有已实现的接口:

NameResolver<java.net.InetAddress>, java.io.Closeable, java.lang.AutoCloseable

public class DnsNameResolver
extends InetNameResolver

A DNS-based InetNameResolver.

字段概要

字段

限定符和类型	字段和说明
static AttributeKey<java.lang.Boolean>	DNS_PIPELINE_ATTRIBUTE An attribute used to mark all channels created by the DnsNameResolver.

构造器概要

构造器

构造器和说明
DnsNameResolver(EventLoop eventLoop, ChannelFactory<? extends DatagramChannel> channelFactory, DnsCache resolveCache, AuthoritativeDnsServerCache authoritativeDnsServerCache, DnsQueryLifecycleObserverFactory dnsQueryLifecycleObserverFactory, long queryTimeoutMillis, ResolvedAddressTypes resolvedAddressTypes, boolean recursionDesired, int maxQueriesPerResolve, boolean traceEnabled, int maxPayloadSize, boolean optResourceEnabled, HostsFileEntriesResolver hostsFileEntriesResolver, DnsServerAddressStreamProvider dnsServerAddressStreamProvider, java.lang.String[] searchDomains, int ndots, boolean decodeIdn) 已过时。 Use DnsNameResolverBuilder.
DnsNameResolver(EventLoop eventLoop, ChannelFactory<? extends DatagramChannel> channelFactory, DnsCache resolveCache, DnsCache authoritativeDnsServerCache, DnsQueryLifecycleObserverFactory dnsQueryLifecycleObserverFactory, long queryTimeoutMillis, ResolvedAddressTypes resolvedAddressTypes, boolean recursionDesired, int maxQueriesPerResolve, boolean traceEnabled, int maxPayloadSize, boolean optResourceEnabled, HostsFileEntriesResolver hostsFileEntriesResolver, DnsServerAddressStreamProvider dnsServerAddressStreamProvider, java.lang.String[] searchDomains, int ndots, boolean decodeIdn) 已过时。 Use DnsNameResolverBuilder.

方法概要

限定符和类型	方法和说明
AuthoritativeDnsServerCache	authoritativeDnsServerCache() Returns the cache used for authoritative DNS servers for a domain.
void	close() Closes the internal datagram channel used for sending and receiving DNS messages, and clears all DNS resource records from the cache.
DnsCnameCache	cnameCache() Returns the DnsCnameCache.
protected void	doResolve(java.lang.String inetHost, DnsRecord[] additionals, Promise<java.net.InetAddress> promise, DnsCache resolveCache) Hook designed for extensibility so one can pass a different cache on each resolution attempt instead of using the global one.
protected void	doResolve(java.lang.String inetHost, Promise<java.net.InetAddress> promise) Invoked by SimpleNameResolver.resolve(String) to perform the actual name resolution.
protected void	doResolveAll(java.lang.String inetHost, DnsRecord[] additionals, Promise<java.util.List<java.net.InetAddress>> promise, DnsCache resolveCache) Hook designed for extensibility so one can pass a different cache on each resolution attempt instead of using the global one.
protected void	doResolveAll(java.lang.String inetHost, Promise<java.util.List<java.net.InetAddress>> promise) Invoked by SimpleNameResolver.resolveAll(String) to perform the actual name resolution.
protected EventLoop	executor() Returns the EventExecutor which is used to notify the listeners of the Future returned by SimpleNameResolver.resolve(String).
HostsFileEntriesResolver	hostsFileEntriesResolver() Returns the component that tries to resolve hostnames against the hosts file prior to asking to remotes DNS servers.
boolean	isOptResourceEnabled() Returns the automatic inclusion of a optional records that tries to give the remote DNS server a hint about how much data the resolver can read per response is enabled.
boolean	isRecursionDesired() Returns true if and only if this resolver sends a DNS query with the RD (recursion desired) flag set.
static boolean	isTimeoutError(java.lang.Throwable cause) Returns true if the Throwable was caused by an timeout.
static boolean	isTransportOrTimeoutError(java.lang.Throwable cause) Returns true if the Throwable was caused by an timeout or transport error.
int	maxPayloadSize() Returns the capacity of the datagram packet buffer (in bytes).
int	maxQueriesPerResolve() Returns the maximum allowed number of DNS queries to send when resolving a host name.
protected DnsServerAddressStream	newRedirectDnsServerStream(java.lang.String hostname, java.util.List<java.net.InetSocketAddress> nameservers) Creates a new DnsServerAddressStream to following a redirected DNS query.
Future<AddressedEnvelope<DnsResponse,java.net.InetSocketAddress>>	query(DnsQuestion question) Sends a DNS query with the specified question.
Future<AddressedEnvelope<DnsResponse,java.net.InetSocketAddress>>	query(DnsQuestion question, java.lang.Iterable<DnsRecord> additionals) Sends a DNS query with the specified question with additional records.
Future<AddressedEnvelope<DnsResponse,java.net.InetSocketAddress>>	query(DnsQuestion question, Promise<AddressedEnvelope<? extends DnsResponse,java.net.InetSocketAddress>> promise) Sends a DNS query with the specified question.
Future<AddressedEnvelope<DnsResponse,java.net.InetSocketAddress>>	query(java.net.InetSocketAddress nameServerAddr, DnsQuestion question) Sends a DNS query with the specified question using the specified name server list.
Future<AddressedEnvelope<DnsResponse,java.net.InetSocketAddress>>	query(java.net.InetSocketAddress nameServerAddr, DnsQuestion question, java.lang.Iterable<DnsRecord> additionals) Sends a DNS query with the specified question with additional records using the specified name server list.
Future<AddressedEnvelope<DnsResponse,java.net.InetSocketAddress>>	query(java.net.InetSocketAddress nameServerAddr, DnsQuestion question, java.lang.Iterable<DnsRecord> additionals, Promise<AddressedEnvelope<? extends DnsResponse,java.net.InetSocketAddress>> promise) Sends a DNS query with the specified question with additional records using the specified name server list.
Future<AddressedEnvelope<DnsResponse,java.net.InetSocketAddress>>	query(java.net.InetSocketAddress nameServerAddr, DnsQuestion question, Promise<AddressedEnvelope<? extends DnsResponse,java.net.InetSocketAddress>> promise) Sends a DNS query with the specified question using the specified name server list.
DnsServerAddressStream	queryDnsServerAddressStream() Returns the dns server address stream used for DNS queries (not resolve).
long	queryTimeoutMillis() Returns the timeout of each DNS query performed by this resolver (in milliseconds).
Future<java.net.InetAddress>	resolve(java.lang.String inetHost, java.lang.Iterable<DnsRecord> additionals) Resolves the specified name into an address.
Future<java.net.InetAddress>	resolve(java.lang.String inetHost, java.lang.Iterable<DnsRecord> additionals, Promise<java.net.InetAddress> promise) Resolves the specified name into an address.
Future<java.util.List<DnsRecord>>	resolveAll(DnsQuestion question) Resolves the DnsRecords that are matched by the specified DnsQuestion.
Future<java.util.List<DnsRecord>>	resolveAll(DnsQuestion question, java.lang.Iterable<DnsRecord> additionals) Resolves the DnsRecords that are matched by the specified DnsQuestion.
Future<java.util.List<DnsRecord>>	resolveAll(DnsQuestion question, java.lang.Iterable<DnsRecord> additionals, Promise<java.util.List<DnsRecord>> promise) Resolves the DnsRecords that are matched by the specified DnsQuestion.
Future<java.util.List<java.net.InetAddress>>	resolveAll(java.lang.String inetHost, java.lang.Iterable<DnsRecord> additionals) Resolves the specified host name and port into a list of address.
Future<java.util.List<java.net.InetAddress>>	resolveAll(java.lang.String inetHost, java.lang.Iterable<DnsRecord> additionals, Promise<java.util.List<java.net.InetAddress>> promise) Resolves the specified host name and port into a list of address.
DnsCache	resolveCache() Returns the resolution cache.
ResolvedAddressTypes	resolvedAddressTypes() Returns the ResolvedAddressTypes resolved by SimpleNameResolver.resolve(String).

从类继承的方法 io.netty.resolver.InetNameResolver

asAddressResolver

从类继承的方法 io.netty.resolver.SimpleNameResolver

resolve, resolve, resolveAll, resolveAll

从类继承的方法 java.lang.Object

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

字段详细资料

DNS_PIPELINE_ATTRIBUTE

public static final AttributeKey<java.lang.Boolean> DNS_PIPELINE_ATTRIBUTE

An attribute used to mark all channels created by the DnsNameResolver.

构造器详细资料

DnsNameResolver

@Deprecated
public DnsNameResolver(EventLoop eventLoop,
                                    ChannelFactory<? extends DatagramChannel> channelFactory,
                                    DnsCache resolveCache,
                                    DnsCache authoritativeDnsServerCache,
                                    DnsQueryLifecycleObserverFactory dnsQueryLifecycleObserverFactory,
                                    long queryTimeoutMillis,
                                    ResolvedAddressTypes resolvedAddressTypes,
                                    boolean recursionDesired,
                                    int maxQueriesPerResolve,
                                    boolean traceEnabled,
                                    int maxPayloadSize,
                                    boolean optResourceEnabled,
                                    HostsFileEntriesResolver hostsFileEntriesResolver,
                                    DnsServerAddressStreamProvider dnsServerAddressStreamProvider,
                                    java.lang.String[] searchDomains,
                                    int ndots,
                                    boolean decodeIdn)

已过时。 Use DnsNameResolverBuilder.

Creates a new DNS-based name resolver that communicates with the specified list of DNS servers.

参数:

eventLoop - the EventLoop which will perform the communication with the DNS servers

channelFactory - the ChannelFactory that will create a DatagramChannel

resolveCache - the DNS resolved entries cache

authoritativeDnsServerCache - the cache used to find the authoritative DNS server for a domain

dnsQueryLifecycleObserverFactory - used to generate new instances of DnsQueryLifecycleObserver which can be used to track metrics for DNS servers.

queryTimeoutMillis - timeout of each DNS query in millis. 0 disables the timeout. If not set or a negative number is set, the default timeout is used.

resolvedAddressTypes - the preferred address types

recursionDesired - if recursion desired flag must be set

maxQueriesPerResolve - the maximum allowed number of DNS queries for a given name resolution

traceEnabled - if trace is enabled

maxPayloadSize - the capacity of the datagram packet buffer

optResourceEnabled - if automatic inclusion of a optional records is enabled

hostsFileEntriesResolver - the HostsFileEntriesResolver used to check for local aliases

dnsServerAddressStreamProvider - The DnsServerAddressStreamProvider used to determine the name servers for each hostname lookup.

searchDomains - the list of search domain (can be null, if so, will try to default to the underlying platform ones)

ndots - the ndots value

decodeIdn - true if domain / host names should be decoded to unicode when received. See rfc3492.

DnsNameResolver

@Deprecated
public DnsNameResolver(EventLoop eventLoop,
                                    ChannelFactory<? extends DatagramChannel> channelFactory,
                                    DnsCache resolveCache,
                                    AuthoritativeDnsServerCache authoritativeDnsServerCache,
                                    DnsQueryLifecycleObserverFactory dnsQueryLifecycleObserverFactory,
                                    long queryTimeoutMillis,
                                    ResolvedAddressTypes resolvedAddressTypes,
                                    boolean recursionDesired,
                                    int maxQueriesPerResolve,
                                    boolean traceEnabled,
                                    int maxPayloadSize,
                                    boolean optResourceEnabled,
                                    HostsFileEntriesResolver hostsFileEntriesResolver,
                                    DnsServerAddressStreamProvider dnsServerAddressStreamProvider,
                                    java.lang.String[] searchDomains,
                                    int ndots,
                                    boolean decodeIdn)

已过时。 Use DnsNameResolverBuilder.

Creates a new DNS-based name resolver that communicates with the specified list of DNS servers.

参数:

eventLoop - the EventLoop which will perform the communication with the DNS servers

channelFactory - the ChannelFactory that will create a DatagramChannel

resolveCache - the DNS resolved entries cache

authoritativeDnsServerCache - the cache used to find the authoritative DNS server for a domain

dnsQueryLifecycleObserverFactory - used to generate new instances of DnsQueryLifecycleObserver which can be used to track metrics for DNS servers.

queryTimeoutMillis - timeout of each DNS query in millis. 0 disables the timeout. If not set or a negative number is set, the default timeout is used.

resolvedAddressTypes - the preferred address types

recursionDesired - if recursion desired flag must be set

maxQueriesPerResolve - the maximum allowed number of DNS queries for a given name resolution

traceEnabled - if trace is enabled

maxPayloadSize - the capacity of the datagram packet buffer

optResourceEnabled - if automatic inclusion of a optional records is enabled

hostsFileEntriesResolver - the HostsFileEntriesResolver used to check for local aliases

dnsServerAddressStreamProvider - The DnsServerAddressStreamProvider used to determine the name servers for each hostname lookup.

searchDomains - the list of search domain (can be null, if so, will try to default to the underlying platform ones)

ndots - the ndots value

decodeIdn - true if domain / host names should be decoded to unicode when received. See rfc3492.

方法详细资料

newRedirectDnsServerStream

protected DnsServerAddressStream newRedirectDnsServerStream(java.lang.String hostname,
                                                            java.util.List<java.net.InetSocketAddress> nameservers)

Creates a new DnsServerAddressStream to following a redirected DNS query. By overriding this it provides the opportunity to sort the name servers before following a redirected DNS query.

参数:

hostname - the hostname.

nameservers - The addresses of the DNS servers which are used in the event of a redirect. This may contain resolved and unresolved addresses so the used DnsServerAddressStream must allow unresolved addresses if you want to include these as well.

返回:

A DnsServerAddressStream which will be used to follow the DNS redirect or null if none should be followed.

resolveCache

public DnsCache resolveCache()

Returns the resolution cache.

cnameCache

public DnsCnameCache cnameCache()

Returns the DnsCnameCache.

authoritativeDnsServerCache

public AuthoritativeDnsServerCache authoritativeDnsServerCache()

Returns the cache used for authoritative DNS servers for a domain.

queryTimeoutMillis

public long queryTimeoutMillis()

Returns the timeout of each DNS query performed by this resolver (in milliseconds). The default value is 5 seconds.

queryDnsServerAddressStream

public DnsServerAddressStream queryDnsServerAddressStream()

Returns the dns server address stream used for DNS queries (not resolve).

resolvedAddressTypes

public ResolvedAddressTypes resolvedAddressTypes()

Returns the ResolvedAddressTypes resolved by SimpleNameResolver.resolve(String). The default value depends on the value of the system property "java.net.preferIPv6Addresses".

isRecursionDesired

public boolean isRecursionDesired()

Returns true if and only if this resolver sends a DNS query with the RD (recursion desired) flag set. The default value is true.

maxQueriesPerResolve

public int maxQueriesPerResolve()

Returns the maximum allowed number of DNS queries to send when resolving a host name. The default value is 8.

maxPayloadSize

public int maxPayloadSize()

Returns the capacity of the datagram packet buffer (in bytes). The default value is 4096 bytes.

isOptResourceEnabled

public boolean isOptResourceEnabled()

Returns the automatic inclusion of a optional records that tries to give the remote DNS server a hint about how much data the resolver can read per response is enabled.

hostsFileEntriesResolver

public HostsFileEntriesResolver hostsFileEntriesResolver()

Returns the component that tries to resolve hostnames against the hosts file prior to asking to remotes DNS servers.

close

public void close()

Closes the internal datagram channel used for sending and receiving DNS messages, and clears all DNS resource records from the cache. Attempting to send a DNS query or to resolve a domain name will fail once this method has been called.

指定者:

close 在接口中 NameResolver<java.net.InetAddress>

指定者:

close 在接口中 java.io.Closeable

指定者:

close 在接口中 java.lang.AutoCloseable

覆盖:

close 在类中 SimpleNameResolver<java.net.InetAddress>

executor

protected EventLoop executor()

从类复制的说明: SimpleNameResolver

Returns the EventExecutor which is used to notify the listeners of the Future returned by SimpleNameResolver.resolve(String).

覆盖:

executor 在类中 SimpleNameResolver<java.net.InetAddress>

resolve

public final Future<java.net.InetAddress> resolve(java.lang.String inetHost,
                                                  java.lang.Iterable<DnsRecord> additionals)

Resolves the specified name into an address.

参数:

inetHost - the name to resolve

additionals - additional records (OPT)

返回:

the address as the result of the resolution

resolve

public final Future<java.net.InetAddress> resolve(java.lang.String inetHost,
                                                  java.lang.Iterable<DnsRecord> additionals,
                                                  Promise<java.net.InetAddress> promise)

Resolves the specified name into an address.

参数:

inetHost - the name to resolve

additionals - additional records (OPT)

promise - the Promise which will be fulfilled when the name resolution is finished

返回:

the address as the result of the resolution

resolveAll

public final Future<java.util.List<java.net.InetAddress>> resolveAll(java.lang.String inetHost,
                                                                     java.lang.Iterable<DnsRecord> additionals)

Resolves the specified host name and port into a list of address.

参数:

inetHost - the name to resolve

additionals - additional records (OPT)

返回:

the list of the address as the result of the resolution

resolveAll

public final Future<java.util.List<java.net.InetAddress>> resolveAll(java.lang.String inetHost,
                                                                     java.lang.Iterable<DnsRecord> additionals,
                                                                     Promise<java.util.List<java.net.InetAddress>> promise)

Resolves the specified host name and port into a list of address.

参数:

inetHost - the name to resolve

additionals - additional records (OPT)

promise - the Promise which will be fulfilled when the name resolution is finished

返回:

the list of the address as the result of the resolution

doResolve

protected void doResolve(java.lang.String inetHost,
                         Promise<java.net.InetAddress> promise)
                  throws java.lang.Exception

从类复制的说明: SimpleNameResolver

Invoked by SimpleNameResolver.resolve(String) to perform the actual name resolution.

指定者:

doResolve 在类中 SimpleNameResolver<java.net.InetAddress>

抛出:

java.lang.Exception

resolveAll

public final Future<java.util.List<DnsRecord>> resolveAll(DnsQuestion question)

Resolves the DnsRecords that are matched by the specified DnsQuestion. Unlike query(DnsQuestion), this method handles redirection, CNAMEs and multiple name servers. If the specified DnsQuestion is A or AAAA, this method looks up the configured HostsFileEntries before sending a query to the name servers. If a match is found in the HostsFileEntries, a synthetic A or AAAA record will be returned.

参数:

question - the question

返回:

the list of the DnsRecords as the result of the resolution

resolveAll

public final Future<java.util.List<DnsRecord>> resolveAll(DnsQuestion question,
                                                          java.lang.Iterable<DnsRecord> additionals)

Resolves the DnsRecords that are matched by the specified DnsQuestion. Unlike query(DnsQuestion), this method handles redirection, CNAMEs and multiple name servers. If the specified DnsQuestion is A or AAAA, this method looks up the configured HostsFileEntries before sending a query to the name servers. If a match is found in the HostsFileEntries, a synthetic A or AAAA record will be returned.

参数:

question - the question

additionals - additional records (OPT)

返回:

the list of the DnsRecords as the result of the resolution

resolveAll

public final Future<java.util.List<DnsRecord>> resolveAll(DnsQuestion question,
                                                          java.lang.Iterable<DnsRecord> additionals,
                                                          Promise<java.util.List<DnsRecord>> promise)

Resolves the DnsRecords that are matched by the specified DnsQuestion. Unlike query(DnsQuestion), this method handles redirection, CNAMEs and multiple name servers. If the specified DnsQuestion is A or AAAA, this method looks up the configured HostsFileEntries before sending a query to the name servers. If a match is found in the HostsFileEntries, a synthetic A or AAAA record will be returned.

参数:

question - the question

additionals - additional records (OPT)

promise - the Promise which will be fulfilled when the resolution is finished

返回:

the list of the DnsRecords as the result of the resolution

doResolve

protected void doResolve(java.lang.String inetHost,
                         DnsRecord[] additionals,
                         Promise<java.net.InetAddress> promise,
                         DnsCache resolveCache)
                  throws java.lang.Exception

Hook designed for extensibility so one can pass a different cache on each resolution attempt instead of using the global one.

抛出:

java.lang.Exception

doResolveAll

protected void doResolveAll(java.lang.String inetHost,
                            Promise<java.util.List<java.net.InetAddress>> promise)
                     throws java.lang.Exception

从类复制的说明: SimpleNameResolver

Invoked by SimpleNameResolver.resolveAll(String) to perform the actual name resolution.

指定者:

doResolveAll 在类中 SimpleNameResolver<java.net.InetAddress>

抛出:

java.lang.Exception

doResolveAll

protected void doResolveAll(java.lang.String inetHost,
                            DnsRecord[] additionals,
                            Promise<java.util.List<java.net.InetAddress>> promise,
                            DnsCache resolveCache)
                     throws java.lang.Exception

Hook designed for extensibility so one can pass a different cache on each resolution attempt instead of using the global one.

抛出:

java.lang.Exception

query

public Future<AddressedEnvelope<DnsResponse,java.net.InetSocketAddress>> query(DnsQuestion question)

Sends a DNS query with the specified question.

query

public Future<AddressedEnvelope<DnsResponse,java.net.InetSocketAddress>> query(DnsQuestion question,
                                                                               java.lang.Iterable<DnsRecord> additionals)

Sends a DNS query with the specified question with additional records.

query

public Future<AddressedEnvelope<DnsResponse,java.net.InetSocketAddress>> query(DnsQuestion question,
                                                                               Promise<AddressedEnvelope<? extends DnsResponse,java.net.InetSocketAddress>> promise)

Sends a DNS query with the specified question.

query

public Future<AddressedEnvelope<DnsResponse,java.net.InetSocketAddress>> query(java.net.InetSocketAddress nameServerAddr,
                                                                               DnsQuestion question)

Sends a DNS query with the specified question using the specified name server list.

query

public Future<AddressedEnvelope<DnsResponse,java.net.InetSocketAddress>> query(java.net.InetSocketAddress nameServerAddr,
                                                                               DnsQuestion question,
                                                                               java.lang.Iterable<DnsRecord> additionals)

Sends a DNS query with the specified question with additional records using the specified name server list.

query

public Future<AddressedEnvelope<DnsResponse,java.net.InetSocketAddress>> query(java.net.InetSocketAddress nameServerAddr,
                                                                               DnsQuestion question,
                                                                               Promise<AddressedEnvelope<? extends DnsResponse,java.net.InetSocketAddress>> promise)

Sends a DNS query with the specified question using the specified name server list.

query

public Future<AddressedEnvelope<DnsResponse,java.net.InetSocketAddress>> query(java.net.InetSocketAddress nameServerAddr,
                                                                               DnsQuestion question,
                                                                               java.lang.Iterable<DnsRecord> additionals,
                                                                               Promise<AddressedEnvelope<? extends DnsResponse,java.net.InetSocketAddress>> promise)

Sends a DNS query with the specified question with additional records using the specified name server list.

isTransportOrTimeoutError

public static boolean isTransportOrTimeoutError(java.lang.Throwable cause)

Returns true if the Throwable was caused by an timeout or transport error. These methods can be used on the Future.cause() that is returned by the various methods exposed by this DnsNameResolver.

isTimeoutError

public static boolean isTimeoutError(java.lang.Throwable cause)

Returns true if the Throwable was caused by an timeout. These methods can be used on the Future.cause() that is returned by the various methods exposed by this DnsNameResolver.