java.lang.Object
- io.netty.resolver.dns.DnsNameResolverBuilder

public final class DnsNameResolverBuilder
extends java.lang.Object

A DnsNameResolver builder.

Field Summary

Fields
Modifier and Type	Field	Description
`private AuthoritativeDnsServerCache`	`authoritativeDnsServerCache`
`private boolean`	`caseRandomizationEnabled`
`private DnsCnameCache`	`cnameCache`
`private boolean`	`completeOncePreferredResolved`
`private ChannelFactory<? extends DatagramChannel>`	`datagramChannelFactory`
`private DnsNameResolverChannelStrategy`	`datagramChannelStrategy`
`private boolean`	`decodeIdn`
`(package private) static java.net.SocketAddress`	`DEFAULT_LOCAL_ADDRESS`
`private boolean`	`dnsCookiesEnabled`
`private DnsQueryLifecycleObserverFactory`	`dnsQueryLifecycleObserverFactory`
`private DnsServerAddressStreamProvider`	`dnsServerAddressStreamProvider`
`(package private) EventLoop`	`eventLoop`
`private HostsFileEntriesResolver`	`hostsFileEntriesResolver`
`private java.net.SocketAddress`	`localAddress`
`private static InternalLogger`	`logger`
`private int`	`maxNumConsolidation`
`private int`	`maxPayloadSize`
`private int`	`maxQueriesPerResolve`
`private java.lang.Integer`	`maxTtl`
`private java.lang.Integer`	`minTtl`
`private int`	`ndots`
`private java.lang.Integer`	`negativeTtl`
`private boolean`	`optResourceEnabled`
`private DnsServerAddressStream`	`queryDnsServerAddressStream`
`private long`	`queryTimeoutMillis`
`private boolean`	`recursionDesired`
`private DnsCache`	`resolveCache`
`private ResolvedAddressTypes`	`resolvedAddressTypes`
`private boolean`	`retryOnTimeout`
`private java.lang.String[]`	`searchDomains`
`private ChannelFactory<? extends SocketChannel>`	`socketChannelFactory`
`private boolean`	`traceEnabled`

Constructor Summary

Constructors
Constructor Description

DnsNameResolverBuilder()
Creates a new builder.

DnsNameResolverBuilder(EventLoop eventLoop)
Creates a new builder.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method	Description
`DnsNameResolverBuilder`	`authoritativeDnsServerCache(AuthoritativeDnsServerCache authoritativeDnsServerCache)`	Sets the cache for authoritative NS servers
`DnsNameResolverBuilder`	`authoritativeDnsServerCache(DnsCache authoritativeDnsServerCache)`	Deprecated. Use `authoritativeDnsServerCache(AuthoritativeDnsServerCache)`
`DnsNameResolver`	`build()`	Returns a new `DnsNameResolver` instance.
`DnsNameResolverBuilder`	`caseRandomizationEnabled(boolean caseRandomizationEnabled)`	Enables or disables the randomization of the case of the name in the questions of UDP queries, also known as "0x20".
`protected ChannelFactory<? extends DatagramChannel>`	`channelFactory()`	Deprecated.
`DnsNameResolverBuilder`	`channelFactory(ChannelFactory<? extends DatagramChannel> datagramChannelFactory)`	Deprecated. use `datagramChannelFactory(ChannelFactory)`
`DnsNameResolverBuilder`	`channelType(java.lang.Class<? extends DatagramChannel> channelType)`	Deprecated. use `datagramChannelType(Class)`
`DnsNameResolverBuilder`	`cnameCache(DnsCnameCache cnameCache)`	Sets the cache for `CNAME` mappings.
`DnsNameResolverBuilder`	`completeOncePreferredResolved(boolean completeOncePreferredResolved)`	If `true` `SimpleNameResolver.resolveAll(String)` will notify the returned `Future` as soon as all queries for the preferred address-type are complete.
`static ResolvedAddressTypes`	`computeResolvedAddressTypes(InternetProtocolFamily... internetProtocolFamilies)`	Compute a `ResolvedAddressTypes` from some `InternetProtocolFamily`s.
`DnsNameResolverBuilder`	`consolidateCacheSize(int maxNumConsolidation)`	Set the maximum size of the cache that is used to consolidate lookups for different hostnames when in-flight.
`DnsNameResolverBuilder`	`copy()`	Creates a copy of this `DnsNameResolverBuilder`
`(package private) ChannelFactory<? extends DatagramChannel>`	`datagramChannelFactory()`
`DnsNameResolverBuilder`	`datagramChannelFactory(ChannelFactory<? extends DatagramChannel> datagramChannelFactory)`	Sets the `ChannelFactory` that will create a `DatagramChannel`.
`DnsNameResolverBuilder`	`datagramChannelStrategy(DnsNameResolverChannelStrategy datagramChannelStrategy)`	Set the strategy that is used to determine how a `DatagramChannel` is used by the resolver for sending queries over UDP protocol.
`DnsNameResolverBuilder`	`datagramChannelType(java.lang.Class<? extends DatagramChannel> channelType)`	Sets the `ChannelFactory` as a `ReflectiveChannelFactory` of this type.
`DnsNameResolverBuilder`	`decodeIdn(boolean decodeIdn)`	Set if domain / host names should be decoded to unicode when received.
`DnsNameResolverBuilder`	`dnsCookiesEnabled(boolean dnsCookiesEnabled)`	Enables or disables the sending of a random client cookie with every UDP query, as defined by RFC 7873.
`DnsNameResolverBuilder`	`dnsQueryLifecycleObserverFactory(DnsQueryLifecycleObserverFactory lifecycleObserverFactory)`	Set the factory used to generate objects which can observe individual DNS queries.
`DnsNameResolverBuilder`	`eventLoop(EventLoop eventLoop)`	Sets the `EventLoop` which will perform the communication with the DNS servers.
`(package private) AuthoritativeDnsServerCache`	`getOrNewAuthoritativeDnsServerCache()`
`(package private) DnsCache`	`getOrNewCache()`
`(package private) DnsCnameCache`	`getOrNewCnameCache()`
`DnsNameResolverBuilder`	`hostsFileEntriesResolver(HostsFileEntriesResolver hostsFileEntriesResolver)`
`DnsNameResolverBuilder`	`localAddress(java.net.SocketAddress localAddress)`	Configure the address that will be used to bind too.
`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.
`protected DnsServerAddressStreamProvider`	`nameServerProvider()`
`DnsNameResolverBuilder`	`nameServerProvider(DnsServerAddressStreamProvider dnsServerAddressStreamProvider)`	Set the `DnsServerAddressStreamProvider` which is used to determine which DNS server is used to resolve each hostname.
`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).
`private DnsServerAddressStream`	`newQueryServerAddressStream(DnsServerAddressStreamProvider dnsServerAddressStreamProvider)`
`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.
`protected DnsServerAddressStream`	`queryServerAddressStream()`
`DnsNameResolverBuilder`	`queryServerAddressStream(DnsServerAddressStream queryServerAddressStream)`	Set the `DnsServerAddressStream` which provides the server address for DNS queries.
`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(ResolvedAddressTypes resolvedAddressTypes)`	Sets the list of the protocol families of the address resolved.
`DnsNameResolverBuilder`	`searchDomains(java.lang.Iterable<java.lang.String> searchDomains)`	Set the list of search domains of the resolver.
`DnsNameResolverBuilder`	`socketChannelFactory(ChannelFactory<? extends SocketChannel> channelFactory)`	Sets the `ChannelFactory` that will create a `SocketChannel` for TCP fallback if needed.
`DnsNameResolverBuilder`	`socketChannelFactory(ChannelFactory<? extends SocketChannel> channelFactory, boolean retryOnTimeout)`	Sets the `ChannelFactory` that will create a `SocketChannel` for TCP fallback if needed.
`DnsNameResolverBuilder`	`socketChannelType(java.lang.Class<? extends SocketChannel> channelType)`	Sets the `ChannelFactory` as a `ReflectiveChannelFactory` of this type for TCP fallback if needed.
`DnsNameResolverBuilder`	`socketChannelType(java.lang.Class<? extends SocketChannel> channelType, boolean retryOnTimeout)`	Sets the `ChannelFactory` as a `ReflectiveChannelFactory` of this type for TCP fallback if needed.
`DnsNameResolverBuilder`	`traceEnabled(boolean traceEnabled)`	Deprecated. Prefer to configure a `LoggingDnsQueryLifeCycleObserverFactory` instead.
`DnsNameResolverBuilder`	`ttl(int minTtl, int maxTtl)`	Sets the minimum and maximum TTL of the cached DNS resource records (in seconds).

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - logger
```
private static final InternalLogger logger
```
  - DEFAULT_LOCAL_ADDRESS
```
static final java.net.SocketAddress DEFAULT_LOCAL_ADDRESS
```
  - eventLoop
```
volatile EventLoop eventLoop
```
  - datagramChannelFactory
```
private ChannelFactory<? extends DatagramChannel> datagramChannelFactory
```
  - socketChannelFactory
```
private ChannelFactory<? extends SocketChannel> socketChannelFactory
```
  - retryOnTimeout
```
private boolean retryOnTimeout
```
  - resolveCache
```
private DnsCache resolveCache
```
  - cnameCache
```
private DnsCnameCache cnameCache
```
  - authoritativeDnsServerCache
```
private AuthoritativeDnsServerCache authoritativeDnsServerCache
```
  - localAddress
```
private java.net.SocketAddress localAddress
```
  - minTtl
```
private java.lang.Integer minTtl
```
  - maxTtl
```
private java.lang.Integer maxTtl
```
  - negativeTtl
```
private java.lang.Integer negativeTtl
```
  - queryTimeoutMillis
```
private long queryTimeoutMillis
```
  - resolvedAddressTypes
```
private ResolvedAddressTypes resolvedAddressTypes
```
  - completeOncePreferredResolved
```
private boolean completeOncePreferredResolved
```
  - recursionDesired
```
private boolean recursionDesired
```
  - maxQueriesPerResolve
```
private int maxQueriesPerResolve
```
  - traceEnabled
```
private boolean traceEnabled
```
  - maxPayloadSize
```
private int maxPayloadSize
```
  - optResourceEnabled
```
private boolean optResourceEnabled
```
  - hostsFileEntriesResolver
```
private HostsFileEntriesResolver hostsFileEntriesResolver
```
  - dnsServerAddressStreamProvider
```
private DnsServerAddressStreamProvider dnsServerAddressStreamProvider
```
  - queryDnsServerAddressStream
```
private DnsServerAddressStream queryDnsServerAddressStream
```
  - dnsQueryLifecycleObserverFactory
```
private DnsQueryLifecycleObserverFactory dnsQueryLifecycleObserverFactory
```
  - searchDomains
```
private java.lang.String[] searchDomains
```
  - ndots
```
private int ndots
```
  - decodeIdn
```
private boolean decodeIdn
```
  - maxNumConsolidation
```
private int maxNumConsolidation
```
  - datagramChannelStrategy
```
private DnsNameResolverChannelStrategy datagramChannelStrategy
```
  - caseRandomizationEnabled
```
private boolean caseRandomizationEnabled
```
  - dnsCookiesEnabled
```
private boolean dnsCookiesEnabled
```
- Constructor Detail
  - DnsNameResolverBuilder
```
public DnsNameResolverBuilder()
```
    Creates a new builder.
  - DnsNameResolverBuilder
```
public DnsNameResolverBuilder(EventLoop eventLoop)
```
    Creates a new builder.
    
    Parameters:
    
    eventLoop - the EventLoop which will perform the communication with the DNS servers.
- Method Detail
  - eventLoop
```
public DnsNameResolverBuilder eventLoop(EventLoop eventLoop)
```
    Sets the EventLoop which will perform the communication with the DNS servers.
    
    Parameters:
    
    eventLoop - the EventLoop
    
    Returns:
    
    this
  - channelFactory
```
@Deprecated
protected ChannelFactory<? extends DatagramChannel> channelFactory()
```
    Deprecated.
  - datagramChannelFactory
```
ChannelFactory<? extends DatagramChannel> datagramChannelFactory()
```
  - channelFactory
```
@Deprecated
public DnsNameResolverBuilder channelFactory(ChannelFactory<? extends DatagramChannel> datagramChannelFactory)
```
    Deprecated.
    use datagramChannelFactory(ChannelFactory)
    
    Sets the ChannelFactory that will create a DatagramChannel.
    If TCP fallback should be supported as well it is required to call the socketChannelFactory(ChannelFactory) or socketChannelType(Class) method.
    
    Parameters:
    
    datagramChannelFactory - the ChannelFactory
    
    Returns:
    
    this
  - datagramChannelFactory
```
public DnsNameResolverBuilder datagramChannelFactory(ChannelFactory<? extends DatagramChannel> datagramChannelFactory)
```
    Sets the ChannelFactory that will create a DatagramChannel.
    If TCP fallback should be supported as well it is required to call the socketChannelFactory(ChannelFactory) or socketChannelType(Class) method.
    
    Parameters:
    
    datagramChannelFactory - the ChannelFactory
    
    Returns:
    
    this
  - channelType
```
@Deprecated
public DnsNameResolverBuilder channelType(java.lang.Class<? extends DatagramChannel> channelType)
```
    Deprecated.
    use datagramChannelType(Class)
    
    Sets the ChannelFactory as a ReflectiveChannelFactory of this type. Use as an alternative to channelFactory(ChannelFactory).
    If TCP fallback should be supported as well it is required to call the socketChannelFactory(ChannelFactory) or socketChannelType(Class) method.
    
    Parameters:
    
    channelType - the type
    
    Returns:
    
    this
  - datagramChannelType
```
public DnsNameResolverBuilder datagramChannelType(java.lang.Class<? extends DatagramChannel> channelType)
```
    Sets the ChannelFactory as a ReflectiveChannelFactory of this type. Use as an alternative to datagramChannelFactory(ChannelFactory).
    If TCP fallback should be supported as well it is required to call the socketChannelFactory(ChannelFactory) or socketChannelType(Class) method.
    
    Parameters:
    
    channelType - the type
    
    Returns:
    
    this
  - socketChannelFactory
```
public DnsNameResolverBuilder socketChannelFactory(ChannelFactory<? extends SocketChannel> channelFactory)
```
    Sets the ChannelFactory that will create a SocketChannel for TCP fallback if needed.
    TCP fallback is not enabled by default and must be enabled by providing a non-null ChannelFactory for this method.
    
    Parameters:
    
    channelFactory - the ChannelFactory or null if TCP fallback should not be supported. By default, TCP fallback is not enabled.
    
    Returns:
    
    this
  - socketChannelType
```
public DnsNameResolverBuilder socketChannelType(java.lang.Class<? extends SocketChannel> channelType)
```
    Sets the ChannelFactory as a ReflectiveChannelFactory of this type for TCP fallback if needed. Use as an alternative to socketChannelFactory(ChannelFactory).
    TCP fallback is not enabled by default and must be enabled by providing a non-null channelType for this method.
    
    Parameters:
    
    channelType - the type or null if TCP fallback should not be supported. By default, TCP fallback is not enabled.
    
    Returns:
    
    this
  - socketChannelFactory
```
public DnsNameResolverBuilder socketChannelFactory(ChannelFactory<? extends SocketChannel> channelFactory,
                                                   boolean retryOnTimeout)
```
    Sets the ChannelFactory that will create a SocketChannel for TCP fallback if needed.
    TCP fallback is not enabled by default and must be enabled by providing a non-null ChannelFactory for this method.
    
    Parameters:
    
    channelFactory - the ChannelFactory or null if TCP fallback should not be supported. By default, TCP fallback is not enabled.
    
    retryOnTimeout - if true the DnsNameResolver will also fallback to TCP if a timeout was detected, if false it will only try to use TCP if the response was marked as truncated.
    
    Returns:
    
    this
  - socketChannelType
```
public DnsNameResolverBuilder socketChannelType(java.lang.Class<? extends SocketChannel> channelType,
                                                boolean retryOnTimeout)
```
    Sets the ChannelFactory as a ReflectiveChannelFactory of this type for TCP fallback if needed. Use as an alternative to socketChannelFactory(ChannelFactory).
    TCP fallback is not enabled by default and must be enabled by providing a non-null channelType for this method.
    
    Parameters:
    
    channelType - the type or null if TCP fallback should not be supported. By default, TCP fallback is not enabled.
    
    retryOnTimeout - if true the DnsNameResolver will also fallback to TCP if a timeout was detected, if false it will only try to use TCP if the response was marked as truncated.
    
    Returns:
    
    this
  - resolveCache
```
public DnsNameResolverBuilder resolveCache(DnsCache resolveCache)
```
    Sets the cache for resolution results.
    
    Parameters:
    
    resolveCache - the DNS resolution results cache
    
    Returns:
    
    this
  - cnameCache
```
public DnsNameResolverBuilder cnameCache(DnsCnameCache cnameCache)
```
    Sets the cache for CNAME mappings.
    
    Parameters:
    
    cnameCache - the cache used to cache CNAME mappings for a domain.
    
    Returns:
    
    this
  - dnsQueryLifecycleObserverFactory
```
public DnsNameResolverBuilder dnsQueryLifecycleObserverFactory(DnsQueryLifecycleObserverFactory lifecycleObserverFactory)
```
    Set the factory used to generate objects which can observe individual DNS queries.
    
    Parameters:
    
    lifecycleObserverFactory - the factory used to generate objects which can observe individual DNS queries.
    
    Returns:
    
    this
  - authoritativeDnsServerCache
```
@Deprecated
public DnsNameResolverBuilder authoritativeDnsServerCache(DnsCache authoritativeDnsServerCache)
```
    Deprecated.
    Use authoritativeDnsServerCache(AuthoritativeDnsServerCache)
    
    Sets the cache for authoritative NS servers
    
    Parameters:
    
    authoritativeDnsServerCache - the authoritative NS servers cache
    
    Returns:
    
    this
  - authoritativeDnsServerCache
```
public DnsNameResolverBuilder authoritativeDnsServerCache(AuthoritativeDnsServerCache authoritativeDnsServerCache)
```
    Sets the cache for authoritative NS servers
    
    Parameters:
    
    authoritativeDnsServerCache - the authoritative NS servers cache
    
    Returns:
    
    this
  - localAddress
```
public DnsNameResolverBuilder localAddress(java.net.SocketAddress localAddress)
```
    Configure the address that will be used to bind too. If null the default will be used.
    
    Parameters:
    
    localAddress - the bind address
    
    Returns:
    
    this
  - ttl
```
public DnsNameResolverBuilder ttl(int minTtl,
                                  int maxTtl)
```
    Sets the minimum and maximum TTL of the cached DNS resource records (in seconds). If the TTL of the DNS resource record returned by the DNS server is less than the minimum TTL or greater than the maximum TTL, this resolver will ignore the TTL from the DNS server and use the minimum TTL or the maximum TTL instead respectively. The default value is 0 and Integer.MAX_VALUE, which practically tells this resolver to respect the TTL from the DNS server.
    
    Parameters:
    
    minTtl - the minimum TTL
    
    maxTtl - the maximum TTL
    
    Returns:
    
    this
  - negativeTtl
```
public DnsNameResolverBuilder negativeTtl(int negativeTtl)
```
    Sets the TTL of the cache for the failed DNS queries (in seconds).
    
    Parameters:
    
    negativeTtl - the TTL for failed cached queries
    
    Returns:
    
    this
  - queryTimeoutMillis
```
public DnsNameResolverBuilder queryTimeoutMillis(long queryTimeoutMillis)
```
    Sets the timeout of each DNS query performed by this resolver (in milliseconds). 0 disables the timeout. If not set or a negative number is set, the default timeout is used.
    
    Parameters:
    
    queryTimeoutMillis - the query timeout
    
    Returns:
    
    this
  - computeResolvedAddressTypes
```
public static ResolvedAddressTypes computeResolvedAddressTypes(InternetProtocolFamily... internetProtocolFamilies)
```
    Compute a ResolvedAddressTypes from some InternetProtocolFamilys. An empty input will return the default value, based on "java.net" System properties. Valid inputs are (), (IPv4), (IPv6), (Ipv4, IPv6) and (IPv6, IPv4).
    
    Parameters:
    
    internetProtocolFamilies - a valid sequence of InternetProtocolFamilys
    
    Returns:
    
    a ResolvedAddressTypes
  - resolvedAddressTypes
```
public DnsNameResolverBuilder resolvedAddressTypes(ResolvedAddressTypes resolvedAddressTypes)
```
    Sets the list of the protocol families of the address resolved. You can use computeResolvedAddressTypes(InternetProtocolFamily...) to get a ResolvedAddressTypes out of some InternetProtocolFamilys.
    
    Parameters:
    
    resolvedAddressTypes - the address types
    
    Returns:
    
    this
  - completeOncePreferredResolved
```
public DnsNameResolverBuilder completeOncePreferredResolved(boolean completeOncePreferredResolved)
```
    If true SimpleNameResolver.resolveAll(String) will notify the returned Future as soon as all queries for the preferred address-type are complete.
    
    Parameters:
    
    completeOncePreferredResolved - true to enable, false to disable.
    
    Returns:
    
    this
  - recursionDesired
```
public DnsNameResolverBuilder recursionDesired(boolean recursionDesired)
```
    Sets if this resolver has to send a DNS query with the RD (recursion desired) flag set.
    
    Parameters:
    
    recursionDesired - true if recursion is desired
    
    Returns:
    
    this
  - maxQueriesPerResolve
```
public DnsNameResolverBuilder maxQueriesPerResolve(int maxQueriesPerResolve)
```
    Sets the maximum allowed number of DNS queries to send when resolving a host name.
    
    Parameters:
    
    maxQueriesPerResolve - the max number of queries
    
    Returns:
    
    this
  - traceEnabled
```
@Deprecated
public DnsNameResolverBuilder traceEnabled(boolean traceEnabled)
```
    Deprecated.
    Prefer to configure a LoggingDnsQueryLifeCycleObserverFactory instead.
    
    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.
    
    Parameters:
    
    traceEnabled - true if trace is enabled
    
    Returns:
    
    this
  - maxPayloadSize
```
public DnsNameResolverBuilder maxPayloadSize(int maxPayloadSize)
```
    Sets the capacity of the datagram packet buffer (in bytes). The default value is 4096 bytes.
    
    Parameters:
    
    maxPayloadSize - the capacity of the datagram packet buffer
    
    Returns:
    
    this
  - optResourceEnabled
```
public 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. Some DNSServer may not support this and so fail to answer queries. If you find problems you may want to disable this.
    
    Parameters:
    
    optResourceEnabled - if optional records inclusion is enabled
    
    Returns:
    
    this
  - hostsFileEntriesResolver
```
public DnsNameResolverBuilder hostsFileEntriesResolver(HostsFileEntriesResolver hostsFileEntriesResolver)
```
    Parameters:
    
    hostsFileEntriesResolver - the HostsFileEntriesResolver used to first check if the hostname is locally aliased.
    
    Returns:
    
    this
  - nameServerProvider
```
protected DnsServerAddressStreamProvider nameServerProvider()
```
  - nameServerProvider
```
public DnsNameResolverBuilder nameServerProvider(DnsServerAddressStreamProvider dnsServerAddressStreamProvider)
```
    Set the DnsServerAddressStreamProvider which is used to determine which DNS server is used to resolve each hostname.
    
    Returns:
    
    this.
  - queryServerAddressStream
```
protected DnsServerAddressStream queryServerAddressStream()
```
  - queryServerAddressStream
```
public DnsNameResolverBuilder queryServerAddressStream(DnsServerAddressStream queryServerAddressStream)
```
    Set the DnsServerAddressStream which provides the server address for DNS queries.
    
    Returns:
    
    this.
  - searchDomains
```
public DnsNameResolverBuilder searchDomains(java.lang.Iterable<java.lang.String> searchDomains)
```
    Set the list of search domains of the resolver.
    
    Parameters:
    
    searchDomains - the search domains
    
    Returns:
    
    this
  - ndots
```
public DnsNameResolverBuilder ndots(int ndots)
```
    Set the number of dots which must appear in a name before an initial absolute query is made. The default value is 1.
    
    Parameters:
    
    ndots - the ndots value
    
    Returns:
    
    this
  - getOrNewCache
```
DnsCache getOrNewCache()
```
  - getOrNewAuthoritativeDnsServerCache
```
AuthoritativeDnsServerCache getOrNewAuthoritativeDnsServerCache()
```
  - newQueryServerAddressStream
```
private DnsServerAddressStream newQueryServerAddressStream(DnsServerAddressStreamProvider dnsServerAddressStreamProvider)
```
  - getOrNewCnameCache
```
DnsCnameCache getOrNewCnameCache()
```
  - decodeIdn
```
public DnsNameResolverBuilder decodeIdn(boolean decodeIdn)
```
    Set if domain / host names should be decoded to unicode when received. See rfc3492.
    
    Parameters:
    
    decodeIdn - if should get decoded
    
    Returns:
    
    this
  - consolidateCacheSize
```
public DnsNameResolverBuilder consolidateCacheSize(int maxNumConsolidation)
```
    Set the maximum size of the cache that is used to consolidate lookups for different hostnames when in-flight. This means if multiple lookups are done for the same hostname and still in-flight only one actual query will be made and the result will be cascaded to the others.
    
    Parameters:
    
    maxNumConsolidation - the maximum lookups to consolidate (different hostnames), or 0 if no consolidation should be performed.
    
    Returns:
    
    this
  - datagramChannelStrategy
```
public DnsNameResolverBuilder datagramChannelStrategy(DnsNameResolverChannelStrategy datagramChannelStrategy)
```
    Set the strategy that is used to determine how a DatagramChannel is used by the resolver for sending queries over UDP protocol.
    
    Parameters:
    
    datagramChannelStrategy - the DnsNameResolverChannelStrategy to use when doing queries over UDP protocol.
    
    Returns:
    
    this
  - caseRandomizationEnabled
```
public DnsNameResolverBuilder caseRandomizationEnabled(boolean caseRandomizationEnabled)
```
    Enables or disables the randomization of the case of the name in the questions of UDP queries, also known as "0x20". The response is only accepted if it echoes the name with exactly the same case, which adds entropy that an off-path attacker needs to guess in order to spoof a response, on top of the query id and the source port. See RFC 5452.
    Some nameservers do not preserve the case of the name in their responses. Queries to these will time out if this is enabled. This is disabled by default.
    
    Parameters:
    
    caseRandomizationEnabled - true if the case of the name should be randomized.
    
    Returns:
    
    this
  - dnsCookiesEnabled
```
public DnsNameResolverBuilder dnsCookiesEnabled(boolean dnsCookiesEnabled)
```
    Enables or disables the sending of a random client cookie with every UDP query, as defined by RFC 7873. A response is rejected if it carries a cookie that does not echo the client cookie. Once a nameserver was seen to echo the client cookie, responses from it that omit the cookie are rejected as well.
    The cookie is part of the OPT record, so this has no effect on queries that do not include one, which is the case if optResourceEnabled(boolean) is false or if the query already has an OPT record. Nameservers that require a valid server cookie and so answer with BADCOOKIE are not supported. This is disabled by default.
    
    Parameters:
    
    dnsCookiesEnabled - true if DNS cookies should be used.
    
    Returns:
    
    this
  - build
```
public DnsNameResolver build()
```
    Returns a new DnsNameResolver instance.
    
    Returns:
    
    a DnsNameResolver
  - copy
```
public DnsNameResolverBuilder copy()
```
    Creates a copy of this DnsNameResolverBuilder
    
    Returns:
    
    DnsNameResolverBuilder

Constructor	Description
`DnsNameResolverBuilder()`	Creates a new builder.
`DnsNameResolverBuilder(EventLoop eventLoop)`	Creates a new builder.

Class DnsNameResolverBuilder

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

logger

DEFAULT_LOCAL_ADDRESS

eventLoop

datagramChannelFactory

socketChannelFactory

retryOnTimeout

resolveCache

cnameCache

authoritativeDnsServerCache

localAddress

minTtl

maxTtl

negativeTtl

queryTimeoutMillis

resolvedAddressTypes

completeOncePreferredResolved

recursionDesired

maxQueriesPerResolve

traceEnabled

maxPayloadSize

optResourceEnabled

hostsFileEntriesResolver

dnsServerAddressStreamProvider

queryDnsServerAddressStream

dnsQueryLifecycleObserverFactory

searchDomains

ndots

decodeIdn

maxNumConsolidation

datagramChannelStrategy

caseRandomizationEnabled

dnsCookiesEnabled

Constructor Detail

DnsNameResolverBuilder

DnsNameResolverBuilder

Method Detail

eventLoop

channelFactory

datagramChannelFactory

channelFactory

datagramChannelFactory

channelType

datagramChannelType

socketChannelFactory

socketChannelType

socketChannelFactory

socketChannelType

resolveCache

cnameCache

dnsQueryLifecycleObserverFactory

authoritativeDnsServerCache

authoritativeDnsServerCache

localAddress

ttl

negativeTtl

queryTimeoutMillis

computeResolvedAddressTypes

resolvedAddressTypes

completeOncePreferredResolved

recursionDesired

maxQueriesPerResolve

traceEnabled

maxPayloadSize

optResourceEnabled

hostsFileEntriesResolver

nameServerProvider

nameServerProvider

queryServerAddressStream

queryServerAddressStream

searchDomains

ndots

getOrNewCache

getOrNewAuthoritativeDnsServerCache

newQueryServerAddressStream