@UnstableApi public final class DnsNameResolverBuilder extends Object
DnsNameResolver
builder.Constructor and Description |
---|
DnsNameResolverBuilder(EventLoop eventLoop)
Creates a new builder.
|
Modifier and Type | Method and Description |
---|---|
DnsNameResolver |
build()
Returns a new
DnsNameResolver instance. |
DnsNameResolverBuilder |
channelFactory(ChannelFactory<? extends DatagramChannel> channelFactory)
Sets the
ChannelFactory that will create a DatagramChannel . |
DnsNameResolverBuilder |
channelType(Class<? extends DatagramChannel> channelType)
Sets the
ChannelFactory as a ReflectiveChannelFactory of this type. |
DnsNameResolverBuilder |
hostsFileEntriesResolver(HostsFileEntriesResolver hostsFileEntriesResolver) |
DnsNameResolverBuilder |
maxPayloadSize(int maxPayloadSize)
Sets the capacity of the datagram packet buffer (in bytes).
|
DnsNameResolverBuilder |
maxQueriesPerResolve(int maxQueriesPerResolve)
Sets the maximum allowed number of DNS queries to send when resolving a host name.
|
DnsNameResolverBuilder |
nameServerAddresses(DnsServerAddresses nameServerAddresses)
Sets the addresses of the DNS server.
|
DnsNameResolverBuilder |
ndots(int ndots)
Set the number of dots which must appear in a name before an initial absolute query is made.
|
DnsNameResolverBuilder |
negativeTtl(int negativeTtl)
Sets the TTL of the cache for the failed DNS queries (in seconds).
|
DnsNameResolverBuilder |
optResourceEnabled(boolean optResourceEnabled)
Enable 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.
|
DnsNameResolverBuilder |
queryTimeoutMillis(long queryTimeoutMillis)
Sets the timeout of each DNS query performed by this resolver (in milliseconds).
|
DnsNameResolverBuilder |
recursionDesired(boolean recursionDesired)
Sets if this resolver has to send a DNS query with the RD (recursion desired) flag set.
|
DnsNameResolverBuilder |
resolveCache(DnsCache resolveCache)
Sets the cache for resolution results.
|
DnsNameResolverBuilder |
resolvedAddressTypes(InternetProtocolFamily... resolvedAddressTypes)
Sets the list of the protocol families of the address resolved.
|
DnsNameResolverBuilder |
resolvedAddressTypes(Iterable<InternetProtocolFamily> resolvedAddressTypes)
Sets the list of the protocol families of the address resolved.
|
DnsNameResolverBuilder |
searchDomains(Iterable<String> searchDomains)
Set the list of search domains of the resolver.
|
DnsNameResolverBuilder |
traceEnabled(boolean traceEnabled)
Sets if this resolver should generate the detailed trace information in an exception message so that
it is easier to understand the cause of resolution failure.
|
DnsNameResolverBuilder |
ttl(int minTtl,
int maxTtl)
Sets the minimum and maximum TTL of the cached DNS resource records (in seconds).
|
public DnsNameResolverBuilder channelFactory(ChannelFactory<? extends DatagramChannel> channelFactory)
ChannelFactory
that will create a DatagramChannel
.channelFactory
- the ChannelFactory
this
public DnsNameResolverBuilder channelType(Class<? extends DatagramChannel> channelType)
ChannelFactory
as a ReflectiveChannelFactory
of this type.
Use as an alternative to channelFactory(ChannelFactory)
.channelType
- the typethis
public DnsNameResolverBuilder nameServerAddresses(DnsServerAddresses nameServerAddresses)
nameServerAddresses
- the DNS server addressesthis
public DnsNameResolverBuilder resolveCache(DnsCache resolveCache)
resolveCache
- the DNS resolution results cachethis
public DnsNameResolverBuilder ttl(int minTtl, int maxTtl)
0
and Integer.MAX_VALUE
, which practically tells this resolver to
respect the TTL from the DNS server.minTtl
- the minimum TTLmaxTtl
- the maximum TTLthis
public DnsNameResolverBuilder negativeTtl(int negativeTtl)
negativeTtl
- the TTL for failed cached queriesthis
public DnsNameResolverBuilder queryTimeoutMillis(long queryTimeoutMillis)
queryTimeoutMillis
- the query timeoutthis
public DnsNameResolverBuilder resolvedAddressTypes(InternetProtocolFamily... resolvedAddressTypes)
InternetProtocolFamily.IPv4
and InternetProtocolFamily.IPv6
are specified in
the order of preference. To enforce the resolve to retrieve the address of a specific protocol family,
specify only a single InternetProtocolFamily
.resolvedAddressTypes
- the address typesthis
public DnsNameResolverBuilder resolvedAddressTypes(Iterable<InternetProtocolFamily> resolvedAddressTypes)
InternetProtocolFamily.IPv4
and InternetProtocolFamily.IPv6
are specified in
the order of preference. To enforce the resolve to retrieve the address of a specific protocol family,
specify only a single InternetProtocolFamily
.resolvedAddressTypes
- the address typesthis
public DnsNameResolverBuilder recursionDesired(boolean recursionDesired)
recursionDesired
- true if recursion is desiredthis
public DnsNameResolverBuilder maxQueriesPerResolve(int maxQueriesPerResolve)
maxQueriesPerResolve
- the max number of queriesthis
public DnsNameResolverBuilder traceEnabled(boolean traceEnabled)
traceEnabled
- true if trace is enabledthis
public DnsNameResolverBuilder maxPayloadSize(int maxPayloadSize)
4096
bytes.maxPayloadSize
- the capacity of the datagram packet bufferthis
public DnsNameResolverBuilder optResourceEnabled(boolean optResourceEnabled)
optResourceEnabled
- if optional records inclusion is enabledthis
public DnsNameResolverBuilder hostsFileEntriesResolver(HostsFileEntriesResolver hostsFileEntriesResolver)
hostsFileEntriesResolver
- the HostsFileEntriesResolver
used to first check
if the hostname is locally aliased.this
public DnsNameResolverBuilder searchDomains(Iterable<String> searchDomains)
searchDomains
- the search domainsthis
public DnsNameResolverBuilder ndots(int ndots)
1
.ndots
- the ndots valuethis
public DnsNameResolver build()
DnsNameResolver
instance.DnsNameResolver
Copyright © 2008–2016 The Netty Project. All rights reserved.