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.

Constructor Summary

Constructors

Constructor and Description
DnsTextEndpointGroupBuilder(String hostname, Function<byte[],Endpoint> mapping) Deprecated. Use DnsTextEndpointGroup.builder(String, Function).

Method Summary

Modifier and Type	Method and Description
B	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.
B	eventLoop(io.netty.channel.EventLoop eventLoop) Sets the EventLoop to use for sending DNS queries.
B	serverAddresses(InetSocketAddress... serverAddresses) Sets the DNS server addresses to send queries to.
B	serverAddresses(Iterable<InetSocketAddress> serverAddresses) Sets the DNS server addresses to send queries to.
B	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

Constructor Detail

DnsTextEndpointGroupBuilder

@Deprecated
public DnsTextEndpointGroupBuilder(String hostname,
                                               Function<byte[],Endpoint> mapping)

Deprecated. Use DnsTextEndpointGroup.builder(String, Function).

Creates a new instance that builds a DnsTextEndpointGroup for the specified hostname.

Parameters:

hostname - the hostname to query DNS queries for

mapping - the Function that maps the content of a TXT record into an Endpoint. The Function is expected to return null if the record contains unsupported content.

Method Detail

build

public DnsTextEndpointGroup build()

Returns a newly created DnsTextEndpointGroup.

eventLoop

public final B eventLoop(io.netty.channel.EventLoop eventLoop)

Sets the EventLoop to use for sending DNS queries.

ttl

public final B 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.

serverAddresses

public final B serverAddresses(InetSocketAddress... serverAddresses)

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

serverAddresses

public final B serverAddresses(Iterable<InetSocketAddress> serverAddresses)

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

backoff

public final B 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.