Package com.linecorp.armeria.client.endpoint

Class AbstractEndpointSelector

java.lang.Object

com.linecorp.armeria.client.endpoint.AbstractEndpointSelector

All Implemented Interfaces:

EndpointSelector

public abstract class AbstractEndpointSelector
extends Object
implements EndpointSelector

A skeletal EndpointSelector implementation. This abstract class implements the select(ClientRequestContext, ScheduledExecutorService, long) method by listening to the change events emitted by EndpointGroup specified at construction time.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractEndpointSelector(EndpointGroup endpointGroup)	Creates a new instance that selects an Endpoint from the specified EndpointGroup.

Method Summary

Modifier and Type	Method	Description
protected EndpointGroup	group()	Returns the EndpointGroup being selected by this EndpointSelector.
CompletableFuture<Endpoint>	select(ClientRequestContext ctx, ScheduledExecutorService executor, long timeoutMillis)	Selects an Endpoint asynchronously from the EndpointGroup associated with the specified ClientRequestContext, waiting up to the specified timeoutMillis.

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.EndpointSelector

selectNow

Constructor Details

AbstractEndpointSelector

protected AbstractEndpointSelector(EndpointGroup endpointGroup)

Creates a new instance that selects an Endpoint from the specified EndpointGroup.

Method Details

group

protected final EndpointGroup group()

Returns the EndpointGroup being selected by this EndpointSelector.

select

public final CompletableFuture<Endpoint> select(ClientRequestContext ctx, ScheduledExecutorService executor, long timeoutMillis)

Description copied from interface: EndpointSelector

Selects an Endpoint asynchronously from the EndpointGroup associated with the specified ClientRequestContext, waiting up to the specified timeoutMillis.

Specified by:

select in interface EndpointSelector

Parameters:

ctx - the ClientRequestContext of the Request being handled.

executor - the ScheduledExecutorService used for notifying the CompletableFuture being returned and scheduling timeout tasks.

timeoutMillis - the amount of milliseconds to wait until a successful Endpoint selection.

Returns:

the CompletableFuture that will be completed with the Endpoint selected by this EndpointSelector's selection strategy, or completed with null if no Endpoint was selected within the specified timeoutMillis, which can happen if the EndpointGroup is empty.