com.linecorp.armeria.client.endpoint.dns

Class DnsServiceEndpointGroupBuilder

java.lang.Object

com.linecorp.armeria.client.endpoint.dns.DnsServiceEndpointGroupBuilder

public final class DnsServiceEndpointGroupBuilder
extends Object

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

Constructor Summary

Constructors

Constructor and Description
DnsServiceEndpointGroupBuilder(String hostname) Deprecated. Use DnsServiceEndpointGroup.builder(String).

Method Summary

Modifier and Type	Method and Description
DnsServiceEndpointGroupBuilder	backoff(Backoff backoff) Sets the Backoff that determines how much delay should be inserted between queries when a DNS server sent an error response.
DnsServiceEndpointGroup	build() Returns a newly created DnsServiceEndpointGroup.
DnsServiceEndpointGroupBuilder	eventLoop(io.netty.channel.EventLoop eventLoop) Sets the EventLoop to use for sending DNS queries.
DnsServiceEndpointGroupBuilder	selectionStrategy(EndpointSelectionStrategy selectionStrategy) Sets the EndpointSelectionStrategy that deteremines the enumeration order of Endpoints.
DnsServiceEndpointGroupBuilder	serverAddresses(InetSocketAddress... serverAddresses) Sets the DNS server addresses to send queries to.
DnsServiceEndpointGroupBuilder	serverAddresses(Iterable<InetSocketAddress> serverAddresses) Sets the DNS server addresses to send queries to.
DnsServiceEndpointGroupBuilder	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

DnsServiceEndpointGroupBuilder

@Deprecated
public DnsServiceEndpointGroupBuilder(String hostname)

Deprecated. Use DnsServiceEndpointGroup.builder(String).

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

Parameters:

hostname - the hostname to query DNS queries for

Method Detail

build

public DnsServiceEndpointGroup build()

Returns a newly created DnsServiceEndpointGroup.

eventLoop

public DnsServiceEndpointGroupBuilder eventLoop(io.netty.channel.EventLoop eventLoop)

Sets the EventLoop to use for sending DNS queries.

ttl

public DnsServiceEndpointGroupBuilder 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 DnsServiceEndpointGroupBuilder serverAddresses(InetSocketAddress... serverAddresses)

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

serverAddresses

public DnsServiceEndpointGroupBuilder serverAddresses(Iterable<InetSocketAddress> serverAddresses)

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

backoff

public DnsServiceEndpointGroupBuilder 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 DnsServiceEndpointGroupBuilder selectionStrategy(EndpointSelectionStrategy selectionStrategy)

Sets the EndpointSelectionStrategy that deteremines the enumeration order of Endpoints.