reactor.netty.transport

Interface NameResolverProvider.NameResolverSpec

Enclosing class:

NameResolverProvider

public static interface NameResolverProvider.NameResolverSpec

Method Summary

Modifier and Type	Method and Description
NameResolverProvider.NameResolverSpec	bindAddressSupplier(Supplier<? extends SocketAddress> bindAddressSupplier) Set a new local address supplier that supply the address to bind to.
NameResolverProvider	build() Build a new NameResolverProvider
NameResolverProvider.NameResolverSpec	cacheMaxTimeToLive(Duration cacheMaxTimeToLive) Sets the max time to live of the cached DNS resource records (resolution: seconds).
NameResolverProvider.NameResolverSpec	cacheMinTimeToLive(Duration cacheMinTimeToLive) Sets the min time to live of the cached DNS resource records (resolution: seconds).
NameResolverProvider.NameResolverSpec	cacheNegativeTimeToLive(Duration cacheNegativeTimeToLive) Sets the time to live of the cache for the failed DNS queries (resolution: seconds).
NameResolverProvider.NameResolverSpec	completeOncePreferredResolved(boolean enable) If true, the resolver notifies the returned Future as soon as all queries for the preferred address type are complete.
NameResolverProvider.NameResolverSpec	disableOptionalRecord(boolean disable) Disables the automatic inclusion of an optional record that tries to hint the remote DNS server about how much data the resolver can read per response.
NameResolverProvider.NameResolverSpec	disableRecursionDesired(boolean disable) Specifies whether this resolver has to send a DNS query with the recursion desired (RD) flag set.
NameResolverProvider.NameResolverSpec	hostsFileEntriesResolver(HostsFileEntriesResolver hostsFileEntriesResolver) Specifies a custom HostsFileEntriesResolver to be used for hosts file entries.
NameResolverProvider.NameResolverSpec	maxPayloadSize(int maxPayloadSize) Sets the capacity of the datagram packet buffer (in bytes).
NameResolverProvider.NameResolverSpec	maxQueriesPerResolve(int maxQueriesPerResolve) Sets the maximum allowed number of DNS queries to send when resolving a host name.
NameResolverProvider.NameResolverSpec	ndots(int ndots) Sets the number of dots which must appear in a name before an initial absolute query is made.
NameResolverProvider.NameResolverSpec	queryTimeout(Duration queryTimeout) Sets the timeout of each DNS query performed by this resolver (resolution: milliseconds).
NameResolverProvider.NameResolverSpec	resolvedAddressTypes(ResolvedAddressTypes resolvedAddressTypes) Sets the list of the protocol families of the address resolved.
NameResolverProvider.NameResolverSpec	roundRobinSelection(boolean enable) Enables an AddressResolverGroup of DnsNameResolvers that supports random selection of destination addresses if multiple are provided by the nameserver.
NameResolverProvider.NameResolverSpec	runOn(EventLoopGroup eventLoopGroup) Performs the communication with the DNS servers on the given EventLoopGroup.
NameResolverProvider.NameResolverSpec	runOn(LoopResources loopResources) Performs the communication with the DNS servers on a supplied EventLoopGroup from the LoopResources container.
NameResolverProvider.NameResolverSpec	runOn(LoopResources loopResources, boolean preferNative) Performs the communication with the DNS servers on a supplied EventLoopGroup from the LoopResources container.
NameResolverProvider.NameResolverSpec	searchDomains(List<String> searchDomains) Sets the list of search domains of the resolver.
NameResolverProvider.NameResolverSpec	trace(String category, LogLevel level) Sets a specific category and log level to be used by this resolver when generating a detailed trace information in case of resolution failure.

Method Detail

build

NameResolverProvider build()

Build a new NameResolverProvider

Returns:

a new NameResolverProvider

cacheMaxTimeToLive

NameResolverProvider.NameResolverSpec cacheMaxTimeToLive(Duration cacheMaxTimeToLive)

Sets the max time to live of the cached DNS resource records (resolution: seconds). If the time to live of the DNS resource record returned by the DNS server is greater than this max time to live, this resolver will ignore the time to live from the DNS server and will use this max time to live. Default to Build#DEFAULT_CACHE_MAX_TIME_TO_LIVE.

Parameters:

cacheMaxTimeToLive - the maximum time to live (resolution: seconds)

Returns:

this

cacheMinTimeToLive

NameResolverProvider.NameResolverSpec cacheMinTimeToLive(Duration cacheMinTimeToLive)

Sets the min time to live of the cached DNS resource records (resolution: seconds). If the time to live of the DNS resource record returned by the DNS server is less than this min time to live, this resolver will ignore the time to live from the DNS server and will use this min time to live. Default to Build#DEFAULT_CACHE_MIN_TIME_TO_LIVE.

Parameters:

cacheMinTimeToLive - the minimum time to live (resolution: seconds)

Returns:

this

cacheNegativeTimeToLive

NameResolverProvider.NameResolverSpec cacheNegativeTimeToLive(Duration cacheNegativeTimeToLive)

Sets the time to live of the cache for the failed DNS queries (resolution: seconds). Default to Build#DEFAULT_CACHE_NEGATIVE_TIME_TO_LIVE.

Parameters:

cacheNegativeTimeToLive - the time to live of the cache for the failed DNS queries (resolution: seconds)

Returns:

this

completeOncePreferredResolved

NameResolverProvider.NameResolverSpec completeOncePreferredResolved(boolean enable)

If true, the resolver notifies the returned Future as soon as all queries for the preferred address type are complete. If false, the resolver notifies the returned Future when all possible address types are complete. This configuration is applicable for SimpleNameResolver.resolveAll(String). By default, this is enabled.

Parameters:

enable - true to enable, false to disable.

Returns:

this

disableOptionalRecord

NameResolverProvider.NameResolverSpec disableOptionalRecord(boolean disable)

Disables the automatic inclusion of an optional record that tries to hint the remote DNS server about how much data the resolver can read per response. By default, this is enabled.

Parameters:

disable - true if an optional record is not included

Returns:

this

disableRecursionDesired

NameResolverProvider.NameResolverSpec disableRecursionDesired(boolean disable)

Specifies whether this resolver has to send a DNS query with the recursion desired (RD) flag set. By default, this is enabled.

Parameters:

disable - true if RD flag is not set

Returns:

this

hostsFileEntriesResolver

NameResolverProvider.NameResolverSpec hostsFileEntriesResolver(HostsFileEntriesResolver hostsFileEntriesResolver)

Specifies a custom HostsFileEntriesResolver to be used for hosts file entries. Default to DefaultHostsFileEntriesResolver.

Parameters:

hostsFileEntriesResolver - the HostsFileEntriesResolver to be used for hosts file entries

Returns:

this

Since:

1.0.12

maxPayloadSize

NameResolverProvider.NameResolverSpec maxPayloadSize(int maxPayloadSize)

Sets the capacity of the datagram packet buffer (in bytes). Default to Build#DEFAULT_MAX_PAYLOAD_SIZE.

Parameters:

maxPayloadSize - the capacity of the datagram packet buffer

Returns:

this

Throws:

IllegalArgumentException - if maxPayloadSize is not positive

maxQueriesPerResolve

NameResolverProvider.NameResolverSpec maxQueriesPerResolve(int maxQueriesPerResolve)

Sets the maximum allowed number of DNS queries to send when resolving a host name. Default to Build#DEFAULT_MAX_QUERIES_PER_RESOLVE.

Parameters:

maxQueriesPerResolve - the max number of queries

Returns:

this

Throws:

IllegalArgumentException - if maxQueriesPerResolve is not positive

ndots

NameResolverProvider.NameResolverSpec ndots(int ndots)

Sets the number of dots which must appear in a name before an initial absolute query is made. Default to Build#DEFAULT_NDOTS which determines the value from the OS on Unix or uses the value 1.

Parameters:

ndots - the ndots value

Returns:

this

Throws:

IllegalArgumentException - if ndots is less than -1

queryTimeout

NameResolverProvider.NameResolverSpec queryTimeout(Duration queryTimeout)

Sets the timeout of each DNS query performed by this resolver (resolution: milliseconds). Default to Build#DEFAULT_QUERY_TIMEOUT.

Parameters:

queryTimeout - the query timeout (resolution: milliseconds)

Returns:

this

resolvedAddressTypes

NameResolverProvider.NameResolverSpec resolvedAddressTypes(ResolvedAddressTypes resolvedAddressTypes)

Sets the list of the protocol families of the address resolved.

Parameters:

resolvedAddressTypes - the address types

Returns:

this

bindAddressSupplier

NameResolverProvider.NameResolverSpec bindAddressSupplier(Supplier<? extends SocketAddress> bindAddressSupplier)

Set a new local address supplier that supply the address to bind to. By default, the host is configured for any local address, and the system picks up an ephemeral port.

Parameters:

bindAddressSupplier - A supplier of local address to bind to.

Returns:

this

Since:

1.0.14

roundRobinSelection

NameResolverProvider.NameResolverSpec roundRobinSelection(boolean enable)

Enables an AddressResolverGroup of DnsNameResolvers that supports random selection of destination addresses if multiple are provided by the nameserver. See RoundRobinDnsAddressResolverGroup. Default to DnsAddressResolverGroup.

Returns:

this

runOn

NameResolverProvider.NameResolverSpec runOn(EventLoopGroup eventLoopGroup)

Performs the communication with the DNS servers on the given EventLoopGroup.

Parameters:

eventLoopGroup - the EventLoopGroup

Returns:

this

runOn

NameResolverProvider.NameResolverSpec runOn(LoopResources loopResources)

Performs the communication with the DNS servers on a supplied EventLoopGroup from the LoopResources container. Will prefer native (epoll/kqueue) implementation if available unless the environment property reactor.netty.native is set to false.

Parameters:

loopResources - the LoopResources

Returns:

this

runOn

NameResolverProvider.NameResolverSpec runOn(LoopResources loopResources,
                                            boolean preferNative)

Performs the communication with the DNS servers on a supplied EventLoopGroup from the LoopResources container.

Parameters:

loopResources - the LoopResources

preferNative - should prefer running on epoll or kqueue instead of java NIO

Returns:

this

searchDomains

NameResolverProvider.NameResolverSpec searchDomains(List<String> searchDomains)

Sets the list of search domains of the resolver. By default, the effective search domain list will be populated using the system DNS search domains.

Parameters:

searchDomains - the search domains

Returns:

this

trace

NameResolverProvider.NameResolverSpec trace(String category,
                                            LogLevel level)

Sets a specific category and log level to be used by this resolver when generating a detailed trace information in case of resolution failure.

Parameters:

category - the logger category

level - the logger level

Returns:

this