Package com.linecorp.armeria.client.endpoint.dns

Class DnsTextEndpointGroupBuilder

java.lang.Object

com.linecorp.armeria.client.AbstractDnsResolverBuilder

com.linecorp.armeria.client.endpoint.dns.DnsTextEndpointGroupBuilder

All Implemented Interfaces:

DynamicEndpointGroupSetters

public final class DnsTextEndpointGroupBuilder
extends AbstractDnsResolverBuilder

Builds a new DnsTextEndpointGroup that sources its Endpoint list from the TXT DNS records of a certain hostname.

Method Summary

Modifier and Type	Method	Description
DnsTextEndpointGroupBuilder	addDnsQueryListeners(DnsQueryListener... dnsQueryListeners)	Adds the DnsQueryListener that listens to the result of DnsRecord queries.
DnsTextEndpointGroupBuilder	addDnsQueryListeners(Iterable<? extends DnsQueryListener> dnsQueryListeners)	Adds the DnsQueryListeners which listens to the result of DnsRecord queries.
DnsTextEndpointGroupBuilder	allowEmptyEndpoints(boolean allowEmptyEndpoints)	Sets whether to allow an empty Endpoint list.
DnsTextEndpointGroupBuilder	backoff(Backoff backoff)	Sets the Backoff that determines how much delay should be inserted between queries when a DNS server sent an error response.
DnsTextEndpointGroup	build()	Returns a newly created DnsTextEndpointGroup.
DnsTextEndpointGroupBuilder	cacheSpec(String cacheSpec)	Sets the Caffeine specification string of the cache that stores the domain names and their resolved addresses.
DnsTextEndpointGroupBuilder	decodeIdn(boolean decodeIdn)	Sets if the domain and host names should be decoded to unicode when received.
DnsTextEndpointGroupBuilder	disableDnsQueryMetrics()	Deprecated.
DnsTextEndpointGroupBuilder	dnsCache(DnsCache dnsCache)	Sets the DnsCache that caches the resolved DnsRecords and the cause of a failure if negative cache is activated.
DnsTextEndpointGroupBuilder	dnsQueryLifecycleObserverFactory(DnsQueryLifecycleObserverFactory observerFactory)	Sets the DnsQueryLifecycleObserverFactory that is used to generate objects which can observe individual DNS queries.
DnsTextEndpointGroupBuilder	dnsServerAddressStreamProvider(DnsServerAddressStreamProvider dnsServerAddressStreamProvider)	Deprecated.
DnsTextEndpointGroupBuilder	enableDnsQueryMetrics(boolean enable)	Enables the default DnsQueryLifecycleObserverFactory that collects DNS query metrics through MeterRegistry.
DnsTextEndpointGroupBuilder	eventLoop(EventLoop eventLoop)	Sets the EventLoop to use for sending DNS queries.
DnsTextEndpointGroupBuilder	hostsFileEntriesResolver(HostsFileEntriesResolver hostsFileEntriesResolver)	Sets the HostsFileEntriesResolver which is used to first check if the hostname is locally aliased.
DnsTextEndpointGroupBuilder	maxPayloadSize(int maxPayloadSize)	Sets the capacity of the datagram packet buffer in bytes.
DnsTextEndpointGroupBuilder	maxQueriesPerResolve(int maxQueriesPerResolve)	Sets the base value of maximum allowed number of DNS queries to send when resolving a host name.
DnsTextEndpointGroupBuilder	meterRegistry(MeterRegistry meterRegistry)	Sets MeterRegistry to collect the DNS query metrics.
DnsTextEndpointGroupBuilder	ndots(int ndots)	Sets the number of dots which must appear in a name before an initial absolute query is made.
DnsTextEndpointGroupBuilder	negativeTtl(int negativeTtl)	Sets the TTL of the cache for the failed DNS queries in seconds.
DnsTextEndpointGroupBuilder	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.
DnsTextEndpointGroupBuilder	queryTimeout(Duration queryTimeout)	Sets the timeout of the DNS query performed by this resolver.
DnsTextEndpointGroupBuilder	queryTimeoutForEachAttempt(Duration queryTimeoutForEachAttempt)	Sets the timeout of each DNS query performed by this endpoint group.
DnsTextEndpointGroupBuilder	queryTimeoutMillis(long queryTimeoutMillis)	Sets the timeout of the DNS query performed by this resolver in milliseconds.
DnsTextEndpointGroupBuilder	queryTimeoutMillisForEachAttempt(long queryTimeoutMillisForEachAttempt)	Sets the timeout of each DNS query performed by this endpoint group in milliseconds.
DnsTextEndpointGroupBuilder	recursionDesired(boolean recursionDesired)	Sets if this resolver has to send a DNS query with the RD (recursion desired) flag set.
DnsTextEndpointGroupBuilder	searchDomains(Iterable<String> searchDomains)	Sets the list of search domains of the resolver.
DnsTextEndpointGroupBuilder	searchDomains(String... searchDomains)	Sets the search domains of the resolver.
DnsTextEndpointGroupBuilder	selectionStrategy(EndpointSelectionStrategy selectionStrategy)	Sets the EndpointSelectionStrategy that determines the enumeration order of Endpoints.
DnsTextEndpointGroupBuilder	selectionTimeout(Duration selectionTimeout)	Sets the timeout to wait until a successful Endpoint selection.
DnsTextEndpointGroupBuilder	selectionTimeoutMillis(long selectionTimeoutMillis)	Sets the timeout to wait until a successful Endpoint selection.
DnsTextEndpointGroupBuilder	serverAddresses(Iterable<InetSocketAddress> serverAddresses)	Sets the DNS server addresses to send queries to.
DnsTextEndpointGroupBuilder	serverAddresses(InetSocketAddress... serverAddresses)	Sets the DNS server addresses to send queries to.
DnsTextEndpointGroupBuilder	serverAddressStreamProvider(DnsServerAddressStreamProvider serverAddressStreamProvider)	Sets the DnsServerAddressStreamProvider which is used to determine which DNS server is used to resolve each hostname.
DnsTextEndpointGroupBuilder	traceEnabled(boolean traceEnabled)	Sets if this resolver should generate detailed trace information in exception messages so that it is easier to understand the cause of resolution failure.
DnsTextEndpointGroupBuilder	ttl(int minTtl, int maxTtl)	Sets the minimum and maximum TTL of the cached DNS resource records in seconds.

Methods inherited from class com.linecorp.armeria.client.AbstractDnsResolverBuilder

buildConfigurator, cacheSpec, hostsFileEntriesResolver, maxTtl, maybeCreateDnsCache, meterRegistry, minTtl, ndots, negativeTtl, queryTimeoutMillis, searchDomains, serverAddressStreamProvider

Methods inherited from class java.lang.Object

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

Method Details

build

public DnsTextEndpointGroup build()

Returns a newly created DnsTextEndpointGroup.

eventLoop

public DnsTextEndpointGroupBuilder eventLoop(EventLoop eventLoop)

Sets the EventLoop to use for sending DNS queries.

backoff

public DnsTextEndpointGroupBuilder backoff(Backoff backoff)

Sets the Backoff that determines how much delay should be inserted between queries when a DNS server sent an error response. Backoff.exponential(1000, 32000).withJitter(0.2) is used by default.

selectionStrategy

public DnsTextEndpointGroupBuilder selectionStrategy(EndpointSelectionStrategy selectionStrategy)

Sets the EndpointSelectionStrategy that determines the enumeration order of Endpoints.

traceEnabled

public DnsTextEndpointGroupBuilder traceEnabled(boolean traceEnabled)

Description copied from class: AbstractDnsResolverBuilder

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.

Overrides:

traceEnabled in class AbstractDnsResolverBuilder

queryTimeout

public DnsTextEndpointGroupBuilder queryTimeout(Duration queryTimeout)

Description copied from class: AbstractDnsResolverBuilder

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

Overrides:

queryTimeout in class AbstractDnsResolverBuilder

queryTimeoutMillis

public DnsTextEndpointGroupBuilder queryTimeoutMillis(long queryTimeoutMillis)

Description copied from class: AbstractDnsResolverBuilder

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

Overrides:

queryTimeoutMillis in class AbstractDnsResolverBuilder

queryTimeoutForEachAttempt

public DnsTextEndpointGroupBuilder queryTimeoutForEachAttempt(Duration queryTimeoutForEachAttempt)

Description copied from class: AbstractDnsResolverBuilder

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 AbstractDnsResolverBuilder.queryTimeout(Duration) is used.

Overrides:

queryTimeoutForEachAttempt in class AbstractDnsResolverBuilder

queryTimeoutMillisForEachAttempt

public DnsTextEndpointGroupBuilder queryTimeoutMillisForEachAttempt(long queryTimeoutMillisForEachAttempt)

Description copied from class: AbstractDnsResolverBuilder

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 AbstractDnsResolverBuilder.queryTimeoutMillis(long) is used.

Overrides:

queryTimeoutMillisForEachAttempt in class AbstractDnsResolverBuilder

recursionDesired

public DnsTextEndpointGroupBuilder recursionDesired(boolean recursionDesired)

Description copied from class: AbstractDnsResolverBuilder

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

Overrides:

recursionDesired in class AbstractDnsResolverBuilder

maxQueriesPerResolve

public DnsTextEndpointGroupBuilder maxQueriesPerResolve(int maxQueriesPerResolve)

Description copied from class: AbstractDnsResolverBuilder

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.

Overrides:

maxQueriesPerResolve in class AbstractDnsResolverBuilder

See Also:

• AbstractDnsResolverBuilder.serverAddressStreamProvider(DnsServerAddressStreamProvider)

serverAddresses

public DnsTextEndpointGroupBuilder serverAddresses(InetSocketAddress... serverAddresses)

Description copied from class: AbstractDnsResolverBuilder

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

Overrides:

serverAddresses in class AbstractDnsResolverBuilder

serverAddresses

public DnsTextEndpointGroupBuilder serverAddresses(Iterable<InetSocketAddress> serverAddresses)

Description copied from class: AbstractDnsResolverBuilder

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

Overrides:

serverAddresses in class AbstractDnsResolverBuilder

serverAddressStreamProvider

public DnsTextEndpointGroupBuilder serverAddressStreamProvider(DnsServerAddressStreamProvider serverAddressStreamProvider)

Description copied from class: AbstractDnsResolverBuilder

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

Overrides:

serverAddressStreamProvider in class AbstractDnsResolverBuilder

dnsServerAddressStreamProvider

@Deprecated
public DnsTextEndpointGroupBuilder dnsServerAddressStreamProvider(DnsServerAddressStreamProvider dnsServerAddressStreamProvider)

Deprecated.

Description copied from class: AbstractDnsResolverBuilder

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

Overrides:

dnsServerAddressStreamProvider in class AbstractDnsResolverBuilder

maxPayloadSize

public DnsTextEndpointGroupBuilder maxPayloadSize(int maxPayloadSize)

Description copied from class: AbstractDnsResolverBuilder

Sets the capacity of the datagram packet buffer in bytes.

Overrides:

maxPayloadSize in class AbstractDnsResolverBuilder

optResourceEnabled

public DnsTextEndpointGroupBuilder optResourceEnabled(boolean optResourceEnabled)

Description copied from class: AbstractDnsResolverBuilder

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.

Overrides:

optResourceEnabled in class AbstractDnsResolverBuilder

hostsFileEntriesResolver

public DnsTextEndpointGroupBuilder hostsFileEntriesResolver(HostsFileEntriesResolver hostsFileEntriesResolver)

Description copied from class: AbstractDnsResolverBuilder

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

Overrides:

hostsFileEntriesResolver in class AbstractDnsResolverBuilder

dnsQueryLifecycleObserverFactory

public DnsTextEndpointGroupBuilder dnsQueryLifecycleObserverFactory(DnsQueryLifecycleObserverFactory observerFactory)

Description copied from class: AbstractDnsResolverBuilder

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

Overrides:

dnsQueryLifecycleObserverFactory in class AbstractDnsResolverBuilder

disableDnsQueryMetrics

@Deprecated
public DnsTextEndpointGroupBuilder disableDnsQueryMetrics()

Deprecated.

Description copied from class: AbstractDnsResolverBuilder

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

Overrides:

disableDnsQueryMetrics in class AbstractDnsResolverBuilder

enableDnsQueryMetrics

public DnsTextEndpointGroupBuilder enableDnsQueryMetrics(boolean enable)

Description copied from class: AbstractDnsResolverBuilder

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

Overrides:

enableDnsQueryMetrics in class AbstractDnsResolverBuilder

searchDomains

public DnsTextEndpointGroupBuilder searchDomains(String... searchDomains)

Description copied from class: AbstractDnsResolverBuilder

Sets the search domains of the resolver.

Overrides:

searchDomains in class AbstractDnsResolverBuilder

searchDomains

public DnsTextEndpointGroupBuilder searchDomains(Iterable<String> searchDomains)

Description copied from class: AbstractDnsResolverBuilder

Sets the list of search domains of the resolver.

Overrides:

searchDomains in class AbstractDnsResolverBuilder

ndots

public DnsTextEndpointGroupBuilder ndots(int ndots)

Description copied from class: AbstractDnsResolverBuilder

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

Overrides:

ndots in class AbstractDnsResolverBuilder

decodeIdn

public DnsTextEndpointGroupBuilder decodeIdn(boolean decodeIdn)

Description copied from class: AbstractDnsResolverBuilder

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

Overrides:

decodeIdn in class AbstractDnsResolverBuilder

meterRegistry

public DnsTextEndpointGroupBuilder meterRegistry(MeterRegistry meterRegistry)

Description copied from class: AbstractDnsResolverBuilder

Sets MeterRegistry to collect the DNS query metrics.

Overrides:

meterRegistry in class AbstractDnsResolverBuilder

cacheSpec

public DnsTextEndpointGroupBuilder cacheSpec(String cacheSpec)

Description copied from class: AbstractDnsResolverBuilder

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 AbstractDnsResolverBuilder.cacheSpec(String) and AbstractDnsResolverBuilder.dnsCache(DnsCache) are mutually exclusive.

Overrides:

cacheSpec in class AbstractDnsResolverBuilder

ttl

public DnsTextEndpointGroupBuilder ttl(int minTtl,
 int maxTtl)

Description copied from class: AbstractDnsResolverBuilder

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 AbstractDnsResolverBuilder.ttl(int, int) and AbstractDnsResolverBuilder.dnsCache(DnsCache) are mutually exclusive.

Overrides:

ttl in class AbstractDnsResolverBuilder

negativeTtl

public DnsTextEndpointGroupBuilder negativeTtl(int negativeTtl)

Description copied from class: AbstractDnsResolverBuilder

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 AbstractDnsResolverBuilder.negativeTtl(int) and AbstractDnsResolverBuilder.dnsCache(DnsCache) are mutually exclusive.

Overrides:

negativeTtl in class AbstractDnsResolverBuilder

dnsCache

public DnsTextEndpointGroupBuilder dnsCache(DnsCache dnsCache)

Description copied from class: AbstractDnsResolverBuilder

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 AbstractDnsResolverBuilder.cacheSpec(String), AbstractDnsResolverBuilder.ttl(int, int), or AbstractDnsResolverBuilder.negativeTtl(int) is set, the DNS resolver will create its own DnsCache using the properties. Therefore, AbstractDnsResolverBuilder.cacheSpec(String), AbstractDnsResolverBuilder.ttl(int, int), and AbstractDnsResolverBuilder.negativeTtl(int) are mutually exclusive with AbstractDnsResolverBuilder.dnsCache(DnsCache).

Overrides:

dnsCache in class AbstractDnsResolverBuilder

allowEmptyEndpoints

public DnsTextEndpointGroupBuilder allowEmptyEndpoints(boolean allowEmptyEndpoints)

Description copied from interface: DynamicEndpointGroupSetters

Sets whether to allow an empty Endpoint list. If unspecified, an empty Endpoint list is allowed.

Specified by:

allowEmptyEndpoints in interface DynamicEndpointGroupSetters

selectionTimeout

public DnsTextEndpointGroupBuilder selectionTimeout(Duration selectionTimeout)

Description copied from interface: DynamicEndpointGroupSetters

Sets the timeout to wait until a successful Endpoint selection. Duration.ZERO disables the timeout. If unspecified, Flags.defaultConnectTimeoutMillis() is used by default.

Specified by:

selectionTimeout in interface DynamicEndpointGroupSetters

selectionTimeoutMillis

public DnsTextEndpointGroupBuilder selectionTimeoutMillis(long selectionTimeoutMillis)

Sets the timeout to wait until a successful Endpoint selection. 0 disables the timeout. If unspecified, the default DNS query timeout (DnsUtil.DEFAULT_DNS_QUERY_TIMEOUT_MILLIS ms) is used by default.

Specified by:

selectionTimeoutMillis in interface DynamicEndpointGroupSetters

addDnsQueryListeners

public DnsTextEndpointGroupBuilder addDnsQueryListeners(Iterable<? extends DnsQueryListener> dnsQueryListeners)

Adds the DnsQueryListeners which listens to the result of DnsRecord queries. If no DnsQueryListener is configured, DnsQueryListener.of() is used by default.

addDnsQueryListeners

public DnsTextEndpointGroupBuilder addDnsQueryListeners(DnsQueryListener... dnsQueryListeners)

Adds the DnsQueryListener that listens to the result of DnsRecord queries. If no DnsQueryListener is configured, DnsQueryListener.of() is used by default.