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

Class DnsTextEndpointGroupBuilder

java.lang.Object

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

public final class DnsTextEndpointGroupBuilder
extends Object

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	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	eventLoop(EventLoop eventLoop)	Sets the EventLoop to use for sending DNS queries.
DnsTextEndpointGroupBuilder	queryTimeout(Duration queryTimeout)	Sets the timeout of the DNS query performed by this endpoint group.
DnsTextEndpointGroupBuilder	queryTimeoutMillis(long queryTimeoutMillis)	Sets the timeout of the DNS query performed by this endpoint group in milliseconds.
DnsTextEndpointGroupBuilder	selectionStrategy(EndpointSelectionStrategy selectionStrategy)	Sets the EndpointSelectionStrategy that determines the enumeration order of Endpoints.
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	ttl(int minTtl, int maxTtl)	Sets the minimum and maximum TTL of the DNS records (in seconds).

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.

ttl

public DnsTextEndpointGroupBuilder ttl(int minTtl,
 int maxTtl)

Sets the minimum and maximum TTL of the DNS records (in seconds). If the TTL of the DNS record returned by the DNS server is less than the minimum TTL or greater than the maximum TTL, the TTL from the DNS server will be ignored and minTtl or maxTtl will be used respectively. The default minTtl and maxTtl are 1 and Integer.MAX_VALUE, which practically tells to respect the server TTL.

queryTimeout

public DnsTextEndpointGroupBuilder queryTimeout(Duration queryTimeout)

Sets the timeout of the DNS query performed by this endpoint group. 0 disables the timeout.

See Also:

• DnsNameResolverBuilder.queryTimeoutMillis(long)

queryTimeoutMillis

public DnsTextEndpointGroupBuilder queryTimeoutMillis(long queryTimeoutMillis)

Sets the timeout of the DNS query performed by this endpoint group in milliseconds. 0 disables the timeout.

See Also:

• DnsNameResolverBuilder.queryTimeoutMillis(long)

serverAddresses

public DnsTextEndpointGroupBuilder serverAddresses(InetSocketAddress... serverAddresses)

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

serverAddresses

public DnsTextEndpointGroupBuilder serverAddresses(Iterable<InetSocketAddress> serverAddresses)

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

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.