com.linecorp.armeria.client.retry

Class RetryingHttpClient

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.RetryingClient<HttpRequest,HttpResponse>

com.linecorp.armeria.client.retry.RetryingHttpClient

All Implemented Interfaces:

Client<HttpRequest,HttpResponse>, HttpClient, Unwrappable

public final class RetryingHttpClient
extends RetryingClient<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.RetryingClient

ARMERIA_RETRY_COUNT

Method Summary

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

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 RetryingHttpClientBuilder builder(RetryStrategy retryStrategy)

Returns a new RetryingHttpClientBuilder with the specified RetryStrategy.

builder

public static RetryingHttpClientBuilder builder(RetryStrategyWithContent<HttpResponse> retryStrategyWithContent)

Returns a new RetryingHttpClientBuilder with the specified RetryStrategyWithContent.

newDecorator

public static Function<? super HttpClient,RetryingHttpClient> 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,RetryingHttpClient> 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,RetryingHttpClient> 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: RetryingClient

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

Specified by:

doExecute in class RetryingClient<HttpRequest,HttpResponse>

Throws:

Exception