com.linecorp.armeria.client.retry

Class RetryingClient

java.lang.Object

com.linecorp.armeria.common.util.AbstractUnwrappable<Client<T_I,T_O>>

com.linecorp.armeria.client.DecoratingClient<I,O,I,O>

com.linecorp.armeria.client.SimpleDecoratingClient<I,O>

com.linecorp.armeria.client.retry.AbstractRetryingClient<HttpRequest,HttpResponse>

com.linecorp.armeria.client.retry.RetryingClient

All Implemented Interfaces:

Client<HttpRequest,HttpResponse>, HttpClient, Unwrappable

Direct Known Subclasses:

RetryingHttpClient

public class RetryingClient
extends AbstractRetryingClient<HttpRequest,HttpResponse>
implements HttpClient

An HttpClient decorator that handles failures of an invocation and retries HTTP requests.

Field Summary

Fields inherited from class com.linecorp.armeria.client.retry.AbstractRetryingClient

ARMERIA_RETRY_COUNT

Method Summary

Modifier and Type	Method and Description
static RetryingClientBuilder	builder(RetryStrategy retryStrategy) Returns a new RetryingClientBuilder with the specified RetryStrategy.
static RetryingClientBuilder	builder(RetryStrategyWithContent<HttpResponse> retryStrategyWithContent) Returns a new RetryingClientBuilder with the specified RetryStrategyWithContent.
protected HttpResponse	doExecute(ClientRequestContext ctx, HttpRequest req) Invoked by AbstractRetryingClient.execute(ClientRequestContext, Request) after the deadline for response timeout is set.
static Function<? super HttpClient,RetryingClient>	newDecorator(RetryStrategy retryStrategy) Creates a new HttpClient decorator that handles failures of an invocation and retries HTTP requests.
static Function<? super HttpClient,RetryingClient>	newDecorator(RetryStrategy retryStrategy, int maxTotalAttempts) Creates a new HttpClient decorator that handles failures of an invocation and retries HTTP requests.
static Function<? super HttpClient,RetryingClient>	newDecorator(RetryStrategy retryStrategy, int maxTotalAttempts, long responseTimeoutMillisForEachAttempt) Creates a new HttpClient decorator that handles failures of an invocation and retries HTTP requests.

Methods inherited from class com.linecorp.armeria.client.retry.AbstractRetryingClient

execute, getNextDelay, getNextDelay, getTotalAttempts, newDerivedContext, onRetryingComplete, retryStrategy, retryStrategyWithContent, scheduleNextRetry, setResponseTimeout

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

as, delegate, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.linecorp.armeria.client.HttpClient

execute

Methods inherited from interface com.linecorp.armeria.client.Client

as

Method Detail

builder

public static RetryingClientBuilder builder(RetryStrategy retryStrategy)

Returns a new RetryingClientBuilder with the specified RetryStrategy.

builder

public static RetryingClientBuilder builder(RetryStrategyWithContent<HttpResponse> retryStrategyWithContent)

Returns a new RetryingClientBuilder with the specified RetryStrategyWithContent.

newDecorator

public static Function<? super HttpClient,RetryingClient> newDecorator(RetryStrategy retryStrategy)

Creates a new HttpClient decorator that handles failures of an invocation and retries HTTP requests.

Parameters:

retryStrategy - the retry strategy

newDecorator

public static Function<? super HttpClient,RetryingClient> newDecorator(RetryStrategy retryStrategy,
                                                                       int maxTotalAttempts)

Creates a new HttpClient decorator that handles failures of an invocation and retries HTTP requests.

Parameters:

retryStrategy - the retry strategy

maxTotalAttempts - the maximum number of total attempts

newDecorator

public static Function<? super HttpClient,RetryingClient> newDecorator(RetryStrategy retryStrategy,
                                                                       int maxTotalAttempts,
                                                                       long responseTimeoutMillisForEachAttempt)

Creates a new HttpClient decorator that handles failures of an invocation and retries HTTP requests.

Parameters:

retryStrategy - the retry strategy

maxTotalAttempts - the maximum number of total attempts

responseTimeoutMillisForEachAttempt - response timeout for each attempt. 0 disables the timeout

doExecute

protected HttpResponse doExecute(ClientRequestContext ctx,
                                 HttpRequest req)
                          throws Exception

Description copied from class: AbstractRetryingClient

Invoked by AbstractRetryingClient.execute(ClientRequestContext, Request) after the deadline for response timeout is set.

Specified by:

doExecute in class AbstractRetryingClient<HttpRequest,HttpResponse>

Throws:

Exception