com.linecorp.armeria.client.endpoint.dns

Class DnsAddressEndpointGroup

java.lang.Object

com.linecorp.armeria.common.util.AbstractListenable<List<Endpoint>>

com.linecorp.armeria.client.endpoint.DynamicEndpointGroup

com.linecorp.armeria.client.endpoint.dns.DnsAddressEndpointGroup

All Implemented Interfaces:

EndpointGroup, EndpointSelector, AsyncCloseable, Listenable<List<Endpoint>>, ListenableAsyncCloseable, AutoCloseable

public final class DnsAddressEndpointGroup
extends DynamicEndpointGroup

DynamicEndpointGroup which resolves targets using DNS address queries (A and AAAA). This is useful for environments where service discovery is handled using DNS, e.g. Kubernetes DNS-based service discovery.

Method Summary

Modifier and Type	Method and Description
static DnsAddressEndpointGroupBuilder	builder(String hostname) Returns a new DnsAddressEndpointGroupBuilder with the specified hostname.
protected void	doCloseAsync(CompletableFuture<?> future) Stops polling DNS servers for service updates.
static DnsAddressEndpointGroup	of(String hostname) Creates a DnsAddressEndpointGroup with an unspecified port that schedules queries on a random EventLoop from CommonPools.workerGroup().
static DnsAddressEndpointGroup	of(String hostname, int port) Creates a DnsAddressEndpointGroup that schedules queries on a random EventLoop from CommonPools.workerGroup().

Methods inherited from class com.linecorp.armeria.client.endpoint.DynamicEndpointGroup

addEndpoint, close, closeAsync, endpoints, isClosed, isClosing, removeEndpoint, select, selectionStrategy, setEndpoints, whenClosed, whenReady

Methods inherited from class com.linecorp.armeria.common.util.AbstractListenable

addListener, notifyListeners, removeListener

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.linecorp.armeria.client.endpoint.EndpointGroup

addListener, awaitInitialEndpoints, awaitInitialEndpoints, empty, initialEndpointsFuture, of, of, of, of, orElse, removeListener

Method Detail

of

public static DnsAddressEndpointGroup of(String hostname)

Creates a DnsAddressEndpointGroup with an unspecified port that schedules queries on a random EventLoop from CommonPools.workerGroup().

Parameters:

hostname - the hostname to query DNS queries for

of

public static DnsAddressEndpointGroup of(String hostname,
                                         int port)

Creates a DnsAddressEndpointGroup that schedules queries on a random EventLoop from CommonPools.workerGroup().

Parameters:

hostname - the hostname to query DNS queries for

port - the port of the Endpoints

builder

public static DnsAddressEndpointGroupBuilder builder(String hostname)

Returns a new DnsAddressEndpointGroupBuilder with the specified hostname.

Parameters:

hostname - the hostname to query DNS queries for

doCloseAsync

protected final void doCloseAsync(CompletableFuture<?> future)

Stops polling DNS servers for service updates.

Overrides:

doCloseAsync in class DynamicEndpointGroup