software.amazon.awssdk.core.client.config

Class ClientOverrideConfiguration

java.lang.Object

software.amazon.awssdk.core.client.config.ClientOverrideConfiguration

All Implemented Interfaces:

ToCopyableBuilder<ClientOverrideConfiguration.Builder,ClientOverrideConfiguration>

public final class ClientOverrideConfiguration
extends Object
implements ToCopyableBuilder<ClientOverrideConfiguration.Builder,ClientOverrideConfiguration>

Configuration values for which the client already provides sensible defaults. All values are optional, and not specifying them will use optimal values defined by the service itself.

Use builder() to create a set of options.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ClientOverrideConfiguration.Builder A builder for ClientOverrideConfiguration.

Method Summary

Modifier and Type	Method and Description
<T> Optional<T>	advancedOption(SdkAdvancedClientOption<T> option) Load the optional requested advanced option that was configured on the client builder.
Optional<Duration>	apiCallAttemptTimeout() The amount of time to wait for the http request to complete before giving up and timing out.
Optional<Duration>	apiCallTimeout() The amount of time to allow the client to complete the execution of an API call.
static ClientOverrideConfiguration.Builder	builder() Create a ClientOverrideConfiguration.Builder, used to create a ClientOverrideConfiguration.
List<ExecutionInterceptor>	executionInterceptors() An immutable collection of ExecutionInterceptors that should be hooked into the execution of each request, in the order that they should be applied.
Map<String,List<String>>	headers() An unmodifiable representation of the set of HTTP headers that should be sent with every request.
Optional<RetryPolicy>	retryPolicy() The optional retry policy that should be used when handling failure cases.
ClientOverrideConfiguration.Builder	toBuilder()
String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder

copy

Method Detail

toBuilder

public ClientOverrideConfiguration.Builder toBuilder()

Specified by:

toBuilder in interface ToCopyableBuilder<ClientOverrideConfiguration.Builder,ClientOverrideConfiguration>

builder

public static ClientOverrideConfiguration.Builder builder()

Create a ClientOverrideConfiguration.Builder, used to create a ClientOverrideConfiguration.

headers

public Map<String,List<String>> headers()

An unmodifiable representation of the set of HTTP headers that should be sent with every request.

If not set, this will return an empty map.

See Also:

ClientOverrideConfiguration.Builder.headers(Map)

retryPolicy

public Optional<RetryPolicy> retryPolicy()

The optional retry policy that should be used when handling failure cases.

See Also:

ClientOverrideConfiguration.Builder.retryPolicy(RetryPolicy)

advancedOption

public <T> Optional<T> advancedOption(SdkAdvancedClientOption<T> option)

Load the optional requested advanced option that was configured on the client builder.

See Also:

ClientOverrideConfiguration.Builder.putAdvancedOption(SdkAdvancedClientOption, Object)

executionInterceptors

public List<ExecutionInterceptor> executionInterceptors()

An immutable collection of ExecutionInterceptors that should be hooked into the execution of each request, in the order that they should be applied.

apiCallTimeout

public Optional<Duration> apiCallTimeout()

The amount of time to allow the client to complete the execution of an API call. This timeout covers the entire client execution except for marshalling. This includes request handler execution, all HTTP requests including retries, unmarshalling, etc. This value should always be positive, if present.

The api call timeout feature doesn't have strict guarantees on how quickly a request is aborted when the timeout is breached. The typical case aborts the request within a few milliseconds but there may occasionally be requests that don't get aborted until several seconds after the timer has been breached. Because of this, the client execution timeout feature should not be used when absolute precision is needed.

This may be used together with apiCallAttemptTimeout() to enforce both a timeout on each individual HTTP request (i.e. each retry) and the total time spent on all requests across retries (i.e. the 'api call' time).

See Also:

ClientOverrideConfiguration.Builder.apiCallTimeout(Duration)

apiCallAttemptTimeout

public Optional<Duration> apiCallAttemptTimeout()

The amount of time to wait for the http request to complete before giving up and timing out. This value should always be positive, if present.

The request timeout feature doesn't have strict guarantees on how quickly a request is aborted when the timeout is breached. The typical case aborts the request within a few milliseconds but there may occasionally be requests that don't get aborted until several seconds after the timer has been breached. Because of this, the request timeout feature should not be used when absolute precision is needed.

This may be used together with apiCallTimeout() to enforce both a timeout on each individual HTTP request (i.e. each retry) and the total time spent on all requests across retries (i.e. the 'api call' time).

See Also:

ClientOverrideConfiguration.Builder.apiCallAttemptTimeout(Duration)

toString

public String toString()

Overrides:

toString in class Object