com.linecorp.armeria.client.endpoint.dns

Class DnsAddressEndpointGroupBuilder

java.lang.Object

com.linecorp.armeria.client.endpoint.dns.DnsAddressEndpointGroupBuilder

public final class DnsAddressEndpointGroupBuilder
extends Object

Builds a new DnsAddressEndpointGroup that sources its Endpoint list from the A or AAAA DNS records of a certain hostname.

Constructor Summary

Constructors

Constructor and Description
DnsAddressEndpointGroupBuilder(String hostname) Deprecated. Use DnsAddressEndpointGroup.builder(String).

Method Summary

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

DnsAddressEndpointGroupBuilder

@Deprecated
public DnsAddressEndpointGroupBuilder(String hostname)

Deprecated. Use DnsAddressEndpointGroup.builder(String).

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

Parameters:

hostname - the hostname to query DNS queries for

Method Detail

port

public DnsAddressEndpointGroupBuilder port(int port)

Sets the port number of the Endpoints created by DnsAddressEndpointGroup. By default, the port number of the Endpoints will remain unspecified and the protocol-dependent default port number will be chosen automatically, e.g. 80 or 443.

build

public DnsAddressEndpointGroup build()

Returns a newly created DnsAddressEndpointGroup.

eventLoop

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

Sets the EventLoop to use for sending DNS queries.

ttl

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

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

serverAddresses

public DnsAddressEndpointGroupBuilder serverAddresses(Iterable<InetSocketAddress> serverAddresses)

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

backoff

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

Sets the EndpointSelectionStrategy that deteremines the enumeration order of Endpoints.