com.linecorp.armeria.client.retry

Class RetryingHttpClientBuilder

java.lang.Object

com.linecorp.armeria.client.retry.RetryingClientBuilder<HttpResponse>

com.linecorp.armeria.client.retry.RetryingHttpClientBuilder

public final class RetryingHttpClientBuilder
extends RetryingClientBuilder<HttpResponse>

Builds a new RetryingHttpClient or its decorator function.

Constructor Summary

Constructors

Constructor and Description
RetryingHttpClientBuilder(RetryStrategy retryStrategy) Deprecated. Use RetryingHttpClient.builder(RetryStrategy).
RetryingHttpClientBuilder(RetryStrategyWithContent<HttpResponse> retryStrategyWithContent) Deprecated. Use RetryingHttpClient.builder(RetryStrategyWithContent).

Method Summary

Modifier and Type	Method and Description
RetryingHttpClient	build(HttpClient delegate) Returns a newly-created RetryingHttpClient based on the properties of this builder.
RetryingHttpClientBuilder	contentPreviewLength(int contentPreviewLength) Sets the length of content required to determine whether to retry or not.
RetryingHttpClientBuilder	maxTotalAttempts(int maxTotalAttempts) Sets the maximum number of total attempts.
Function<? super HttpClient,RetryingHttpClient>	newDecorator() Returns a newly-created decorator that decorates an HttpClient with a new RetryingHttpClient based on the properties of this builder.
RetryingHttpClientBuilder	responseTimeoutForEachAttempt(Duration responseTimeoutForEachAttempt) Sets the response timeout for each attempt.
RetryingHttpClientBuilder	responseTimeoutMillisForEachAttempt(long responseTimeoutMillisForEachAttempt) Sets the response timeout for each attempt in milliseconds.
String	toString()
RetryingHttpClientBuilder	useRetryAfter(boolean useRetryAfter) Whether retry should be attempted according to the retryHeader from the server or not.

Methods inherited from class java.lang.Object

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

Constructor Detail

RetryingHttpClientBuilder

@Deprecated
public RetryingHttpClientBuilder(RetryStrategy retryStrategy)

Deprecated. Use RetryingHttpClient.builder(RetryStrategy).

Creates a new builder with the specified RetryStrategy.

RetryingHttpClientBuilder

@Deprecated
public RetryingHttpClientBuilder(RetryStrategyWithContent<HttpResponse> retryStrategyWithContent)

Deprecated. Use RetryingHttpClient.builder(RetryStrategyWithContent).

Creates a new builder with the specified RetryStrategyWithContent.

Method Detail

useRetryAfter

public RetryingHttpClientBuilder useRetryAfter(boolean useRetryAfter)

Whether retry should be attempted according to the retryHeader from the server or not. The web server may request a client to retry after specific time with retryAfter header. If you want to follow the direction from the server not by your Backoff, invoke this method with the useRetryAfter with true to request after the specified delay.

Parameters:

useRetryAfter - true if you want to retry after using the retryAfter header. false otherwise

Returns:

RetryingHttpClientBuilder to support method chaining

contentPreviewLength

public RetryingHttpClientBuilder contentPreviewLength(int contentPreviewLength)

Sets the length of content required to determine whether to retry or not. If the total length of content exceeds this length and there's no retry condition matched, it will hand over the stream to the client. Note that this property is useful only if you specified RetryStrategyWithContent when calling this builder's constructor. The default value of this property is .

Parameters:

contentPreviewLength - the content length to preview. 0 does not disable the length limit.

Returns:

RetryingHttpClientBuilder to support method chaining

Throws:

IllegalStateException - if this builder is created with a RetryStrategy rather than RetryStrategyWithContent

IllegalArgumentException - if the specified contentPreviewLength is equal to or less than 0

build

public RetryingHttpClient build(HttpClient delegate)

Returns a newly-created RetryingHttpClient based on the properties of this builder.

newDecorator

public Function<? super HttpClient,RetryingHttpClient> newDecorator()

Returns a newly-created decorator that decorates an HttpClient with a new RetryingHttpClient based on the properties of this builder.

toString

public String toString()

Overrides:

toString in class RetryingClientBuilder<HttpResponse>

maxTotalAttempts

public RetryingHttpClientBuilder maxTotalAttempts(int maxTotalAttempts)

Description copied from class: RetryingClientBuilder

Sets the maximum number of total attempts. If unspecified, the value from Flags.defaultMaxTotalAttempts() will be used.

Overrides:

maxTotalAttempts in class RetryingClientBuilder<HttpResponse>

Returns:

this to support method chaining.

responseTimeoutMillisForEachAttempt

public RetryingHttpClientBuilder responseTimeoutMillisForEachAttempt(long responseTimeoutMillisForEachAttempt)

Description copied from class: RetryingClientBuilder

Sets the response timeout for each attempt in milliseconds. When requests in RetryingClient are made, corresponding responses are timed out by this value. 0 disables the timeout. It will be set by the default value in Flags.defaultResponseTimeoutMillis(), if the client dose not specify.

Overrides:

responseTimeoutMillisForEachAttempt in class RetryingClientBuilder<HttpResponse>

Returns:

this to support method chaining.

See Also:

Per-attempt timeout

responseTimeoutForEachAttempt

public RetryingHttpClientBuilder responseTimeoutForEachAttempt(Duration responseTimeoutForEachAttempt)

Description copied from class: RetryingClientBuilder

Sets the response timeout for each attempt. When requests in RetryingClient are made, corresponding responses are timed out by this value. 0 disables the timeout.

Overrides:

responseTimeoutForEachAttempt in class RetryingClientBuilder<HttpResponse>

Returns:

this to support method chaining.

See Also:

Per-attempt timeout