Package com.linecorp.armeria.client

Class AbstractDnsResolverBuilder

java.lang.Object

com.linecorp.armeria.client.AbstractDnsResolverBuilder

Direct Known Subclasses:

DnsAddressEndpointGroupBuilder, DnsResolverGroupBuilder, DnsServiceEndpointGroupBuilder, DnsTextEndpointGroupBuilder

@UnstableApi
public abstract class AbstractDnsResolverBuilder
extends Object

A skeletal builder implementation for DNS resolvers.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractDnsResolverBuilder()	Creates a new instance.

Method Summary

Modifier and Type	Method	Description
protected final Consumer<DnsNameResolverBuilder>	buildConfigurator(EventLoopGroup eventLoopGroup)	Builds a configurator that configures a DnsNameResolverBuilder with the properties set.
protected final String	cacheSpec()	Returns the Caffeine specification string.
AbstractDnsResolverBuilder	cacheSpec(String cacheSpec)	Sets the Caffeine specification string of the cache that stores the domain names and their resolved addresses.
AbstractDnsResolverBuilder	decodeIdn(boolean decodeIdn)	Sets if the domain and host names should be decoded to unicode when received.
AbstractDnsResolverBuilder	disableDnsQueryMetrics()	Deprecated. Use enableDnsQueryMetrics(boolean) instead.
AbstractDnsResolverBuilder	dnsCache(DnsCache dnsCache)	Sets the DnsCache that caches the resolved DnsRecords and the cause of a failure if negative cache is activated.
AbstractDnsResolverBuilder	dnsQueryLifecycleObserverFactory(DnsQueryLifecycleObserverFactory observerFactory)	Sets the DnsQueryLifecycleObserverFactory that is used to generate objects which can observe individual DNS queries.
AbstractDnsResolverBuilder	dnsServerAddressStreamProvider(DnsServerAddressStreamProvider dnsServerAddressStreamProvider)	Deprecated. Use serverAddressStreamProvider(DnsServerAddressStreamProvider) instead.
AbstractDnsResolverBuilder	enableDnsQueryMetrics(boolean enable)	Enables the default DnsQueryLifecycleObserverFactory that collects DNS query metrics through MeterRegistry.
protected final HostsFileEntriesResolver	hostsFileEntriesResolver()	Returns the HostsFileEntriesResolver.
AbstractDnsResolverBuilder	hostsFileEntriesResolver(HostsFileEntriesResolver hostsFileEntriesResolver)	Sets the HostsFileEntriesResolver which is used to first check if the hostname is locally aliased.
AbstractDnsResolverBuilder	maxPayloadSize(int maxPayloadSize)	Sets the capacity of the datagram packet buffer in bytes.
AbstractDnsResolverBuilder	maxQueriesPerResolve(int maxQueriesPerResolve)	Sets the base value of maximum allowed number of DNS queries to send when resolving a host name.
protected final int	maxTtl()	Returns the maximum TTL of the cached DNS resource records in seconds.
protected final DnsCache	maybeCreateDnsCache()	Returns a newly-created DnsCache if cacheSpec(String), ttl(int, int) or negativeTtl(int) is set.
protected final @Nullable MeterRegistry	meterRegistry()	Returns MeterRegistry that collects the DNS query metrics.
AbstractDnsResolverBuilder	meterRegistry(MeterRegistry meterRegistry)	Sets MeterRegistry to collect the DNS query metrics.
protected final int	minTtl()	Returns the minimum TTL of the cached DNS resource records in seconds.
protected final int	ndots()	Returns the number of dots which must appear in a name before an initial absolute query is made.
AbstractDnsResolverBuilder	ndots(int ndots)	Sets the number of dots which must appear in a name before an initial absolute query is made.
protected final int	negativeTtl()	Returns the negative TTL of the failed DNS queries in seconds.
AbstractDnsResolverBuilder	negativeTtl(int negativeTtl)	Sets the TTL of the cache for the failed DNS queries in seconds.
AbstractDnsResolverBuilder	optResourceEnabled(boolean optResourceEnabled)	Enables the automatic inclusion of an optional records that tries to give the remote DNS server a hint about how much data the resolver can read per response.
AbstractDnsResolverBuilder	queryTimeout(Duration queryTimeout)	Sets the timeout of the DNS query performed by this resolver.
AbstractDnsResolverBuilder	queryTimeoutForEachAttempt(Duration queryTimeoutForEachAttempt)	Sets the timeout of each DNS query performed by this endpoint group.
protected final long	queryTimeoutMillis()	Returns the timeout of the DNS query performed by this resolver in milliseconds.
AbstractDnsResolverBuilder	queryTimeoutMillis(long queryTimeoutMillis)	Sets the timeout of the DNS query performed by this resolver in milliseconds.
AbstractDnsResolverBuilder	queryTimeoutMillisForEachAttempt(long queryTimeoutMillisForEachAttempt)	Sets the timeout of each DNS query performed by this endpoint group in milliseconds.
AbstractDnsResolverBuilder	recursionDesired(boolean recursionDesired)	Sets if this resolver has to send a DNS query with the RD (recursion desired) flag set.
protected final List<String>	searchDomains()	Returns the search domains of the resolver.
AbstractDnsResolverBuilder	searchDomains(Iterable<String> searchDomains)	Sets the list of search domains of the resolver.
AbstractDnsResolverBuilder	searchDomains(String... searchDomains)	Sets the search domains of the resolver.
AbstractDnsResolverBuilder	serverAddresses(Iterable<InetSocketAddress> serverAddresses)	Sets the DNS server addresses to send queries to.
AbstractDnsResolverBuilder	serverAddresses(InetSocketAddress... serverAddresses)	Sets the DNS server addresses to send queries to.
protected final DnsServerAddressStreamProvider	serverAddressStreamProvider()	Returns the DnsServerAddressStreamProvider.
AbstractDnsResolverBuilder	serverAddressStreamProvider(DnsServerAddressStreamProvider serverAddressStreamProvider)	Sets the DnsServerAddressStreamProvider which is used to determine which DNS server is used to resolve each hostname.
AbstractDnsResolverBuilder	traceEnabled(boolean traceEnabled)	Deprecated. Use dnsQueryLifecycleObserverFactory(DnsQueryLifecycleObserverFactory) with LoggingDnsQueryLifeCycleObserverFactory.
AbstractDnsResolverBuilder	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

Constructor Details

AbstractDnsResolverBuilder

protected AbstractDnsResolverBuilder()

Creates a new instance.

Method Details

traceEnabled

@Deprecated
public AbstractDnsResolverBuilder traceEnabled(boolean traceEnabled)

Deprecated.

Use dnsQueryLifecycleObserverFactory(DnsQueryLifecycleObserverFactory) with LoggingDnsQueryLifeCycleObserverFactory.

Sets if this resolver should generate detailed trace information in exception messages so that it is easier to understand the cause of resolution failure. This flag is enabled by default.

queryTimeout

public AbstractDnsResolverBuilder queryTimeout(Duration queryTimeout)

Sets the timeout of the DNS query performed by this resolver. 0 disables the timeout. If unspecified, 5000 ms will be used.

queryTimeoutMillis

protected final long queryTimeoutMillis()

Returns the timeout of the DNS query performed by this resolver in milliseconds.

queryTimeoutMillis

public AbstractDnsResolverBuilder queryTimeoutMillis(long queryTimeoutMillis)

Sets the timeout of the DNS query performed by this resolver in milliseconds. 0 disables the timeout. If unspecified, 5000 ms will be used.

queryTimeoutForEachAttempt

public AbstractDnsResolverBuilder queryTimeoutForEachAttempt(Duration queryTimeoutForEachAttempt)

Sets the timeout of each DNS query performed by this endpoint group. This option is useful if you want to set a timeout for each search domain resolution. If unspecified, the value of queryTimeout(Duration) is used.

queryTimeoutMillisForEachAttempt

public AbstractDnsResolverBuilder queryTimeoutMillisForEachAttempt(long queryTimeoutMillisForEachAttempt)

Sets the timeout of each DNS query performed by this endpoint group in milliseconds. This option is useful if you want to set a timeout for each search domain resolution. If unspecified, the value of queryTimeoutMillis(long) is used.

recursionDesired

public AbstractDnsResolverBuilder recursionDesired(boolean recursionDesired)

Sets if this resolver has to send a DNS query with the RD (recursion desired) flag set. This flag is enabled by default.

maxQueriesPerResolve

public AbstractDnsResolverBuilder maxQueriesPerResolve(int maxQueriesPerResolve)

Sets the base value of maximum allowed number of DNS queries to send when resolving a host name. The actual maximum allowed number of queries will be multiplied by the DnsServerAddressStream.size(). For example, if maxQueriesPerResolve is 5 and DnsServerAddressStream.size() is 2, DNS queries can be executed up to 10 times. The DnsServerAddressStream is provided by DnsServerAddressStreamProvider.

See Also:

• serverAddressStreamProvider(DnsServerAddressStreamProvider)

serverAddresses

public AbstractDnsResolverBuilder serverAddresses(InetSocketAddress... serverAddresses)

Sets the DNS server addresses to send queries to. Operating system default is used by default.

serverAddresses

public AbstractDnsResolverBuilder serverAddresses(Iterable<InetSocketAddress> serverAddresses)

Sets the DNS server addresses to send queries to. Operating system default is used by default.

serverAddressStreamProvider

protected final DnsServerAddressStreamProvider serverAddressStreamProvider()

Returns the DnsServerAddressStreamProvider.

serverAddressStreamProvider

public AbstractDnsResolverBuilder serverAddressStreamProvider(DnsServerAddressStreamProvider serverAddressStreamProvider)

Sets the DnsServerAddressStreamProvider which is used to determine which DNS server is used to resolve each hostname.

dnsServerAddressStreamProvider

@Deprecated
public AbstractDnsResolverBuilder dnsServerAddressStreamProvider(DnsServerAddressStreamProvider dnsServerAddressStreamProvider)

Deprecated.

Use serverAddressStreamProvider(DnsServerAddressStreamProvider) instead.

Sets the DnsServerAddressStreamProvider which is used to determine which DNS server is used to resolve each hostname.

maxPayloadSize

public AbstractDnsResolverBuilder maxPayloadSize(int maxPayloadSize)

Sets the capacity of the datagram packet buffer in bytes.

optResourceEnabled

public AbstractDnsResolverBuilder optResourceEnabled(boolean optResourceEnabled)

Enables the automatic inclusion of an optional records that tries to give the remote DNS server a hint about how much data the resolver can read per response. Some DNS Server may not support this and so fail to answer queries.

hostsFileEntriesResolver

protected final HostsFileEntriesResolver hostsFileEntriesResolver()

Returns the HostsFileEntriesResolver.

hostsFileEntriesResolver

public AbstractDnsResolverBuilder hostsFileEntriesResolver(HostsFileEntriesResolver hostsFileEntriesResolver)

Sets the HostsFileEntriesResolver which is used to first check if the hostname is locally aliased.

dnsQueryLifecycleObserverFactory

public AbstractDnsResolverBuilder dnsQueryLifecycleObserverFactory(DnsQueryLifecycleObserverFactory observerFactory)

Sets the DnsQueryLifecycleObserverFactory that is used to generate objects which can observe individual DNS queries.

disableDnsQueryMetrics

@Deprecated
public AbstractDnsResolverBuilder disableDnsQueryMetrics()

Deprecated.

Use enableDnsQueryMetrics(boolean) instead.

Disables the default DnsQueryLifecycleObserverFactory that collects DNS query metrics through MeterRegistry.

enableDnsQueryMetrics

public AbstractDnsResolverBuilder enableDnsQueryMetrics(boolean enable)

Enables the default DnsQueryLifecycleObserverFactory that collects DNS query metrics through MeterRegistry. This option is enabled by default.

searchDomains

protected final List<String> searchDomains()

Returns the search domains of the resolver.

searchDomains

public AbstractDnsResolverBuilder searchDomains(String... searchDomains)

Sets the search domains of the resolver.

searchDomains

public AbstractDnsResolverBuilder searchDomains(Iterable<String> searchDomains)

Sets the list of search domains of the resolver.

ndots

protected final int ndots()

Returns the number of dots which must appear in a name before an initial absolute query is made.

ndots

public AbstractDnsResolverBuilder ndots(int ndots)

Sets the number of dots which must appear in a name before an initial absolute query is made.

decodeIdn

public AbstractDnsResolverBuilder decodeIdn(boolean decodeIdn)

Sets if the domain and host names should be decoded to unicode when received. See rfc3492. This flag is enabled by default.

meterRegistry

@Nullable
protected final @Nullable MeterRegistry meterRegistry()

Returns MeterRegistry that collects the DNS query metrics.

meterRegistry

public AbstractDnsResolverBuilder meterRegistry(MeterRegistry meterRegistry)

Sets MeterRegistry to collect the DNS query metrics.

cacheSpec

protected final String cacheSpec()

Returns the Caffeine specification string.

cacheSpec

public AbstractDnsResolverBuilder cacheSpec(String cacheSpec)

Sets the Caffeine specification string of the cache that stores the domain names and their resolved addresses. If not set, Flags.dnsCacheSpec() is used by default.

Note that cacheSpec(String) and dnsCache(DnsCache) are mutually exclusive.

minTtl

protected final int minTtl()

Returns the minimum TTL of the cached DNS resource records in seconds.

maxTtl

protected final int maxTtl()

Returns the maximum TTL of the cached DNS resource records in seconds.

ttl

public AbstractDnsResolverBuilder 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 1 and Integer.MAX_VALUE, which practically tells this resolver to respect the TTL from the DNS server.

Note that ttl(int, int) and dnsCache(DnsCache) are mutually exclusive.

negativeTtl

protected final int negativeTtl()

Returns the negative TTL of the failed DNS queries in seconds.

negativeTtl

public AbstractDnsResolverBuilder negativeTtl(int negativeTtl)

Sets the TTL of the cache for the failed DNS queries in seconds. The default value is 0 which means that the DNS resolver does not cache when DNS queries are failed.

Note that negativeTtl(int) and dnsCache(DnsCache) are mutually exclusive.

dnsCache

@UnstableApi
public AbstractDnsResolverBuilder dnsCache(DnsCache dnsCache)

Sets the DnsCache that caches the resolved DnsRecords and the cause of a failure if negative cache is activated. This option is useful if you want to share a DnsCache with multiple DNS resolvers. If unspecified, the default DnsCache is used.

Note that if cacheSpec(String), ttl(int, int), or negativeTtl(int) is set, the DNS resolver will create its own DnsCache using the properties. Therefore, cacheSpec(String), ttl(int, int), and negativeTtl(int) are mutually exclusive with dnsCache(DnsCache).

maybeCreateDnsCache

@UnstableApi
protected final DnsCache maybeCreateDnsCache()

Returns a newly-created DnsCache if cacheSpec(String), ttl(int, int) or negativeTtl(int) is set. Returns the DnsCache specified by dnsCache(DnsCache) if it is set. Otherwise, returns the default DnsCache.

buildConfigurator

@UnstableApi
protected final Consumer<DnsNameResolverBuilder> buildConfigurator(EventLoopGroup eventLoopGroup)

Builds a configurator that configures a DnsNameResolverBuilder with the properties set.