software.amazon.awssdk.http

Class SdkHttpConfigurationOption<T>

java.lang.Object

software.amazon.awssdk.utils.AttributeMap.Key<T>

software.amazon.awssdk.http.SdkHttpConfigurationOption<T>

Type Parameters:

T - Type of option

public final class SdkHttpConfigurationOption<T>
extends AttributeMap.Key<T>

Type safe key for an HTTP related configuration option. These options are used for service specific configuration and are treated as hints for the underlying HTTP implementation for better defaults. If an implementation does not support a particular option, they are free to ignore it.

See Also:

AttributeMap

Nested Class Summary

Nested classes/interfaces inherited from class software.amazon.awssdk.utils.AttributeMap.Key

AttributeMap.Key.UnsafeValueType

Field Summary

Fields

Modifier and Type	Field and Description
static SdkHttpConfigurationOption<Duration>	CONNECTION_ACQUIRE_TIMEOUT Timeout for acquiring an already-established connection from a connection pool to a remote service.
static SdkHttpConfigurationOption<Duration>	CONNECTION_MAX_IDLE_TIMEOUT Timeout after which an idle connection should be closed.
static SdkHttpConfigurationOption<Duration>	CONNECTION_TIME_TO_LIVE Timeout after which a connection should be closed, regardless of whether it is idle.
static SdkHttpConfigurationOption<Duration>	CONNECTION_TIMEOUT Timeout for establishing a connection to a remote service.
static AttributeMap	GLOBAL_HTTP_DEFAULTS
static SdkHttpConfigurationOption<Integer>	MAX_CONNECTIONS Maximum number of connections allowed in a connection pool.
static SdkHttpConfigurationOption<Integer>	MAX_PENDING_CONNECTION_ACQUIRES Maximum number of requests allowed to wait for a connection.
static SdkHttpConfigurationOption<Protocol>	PROTOCOL HTTP protocol to use.
static SdkHttpConfigurationOption<Duration>	READ_TIMEOUT Timeout for each read to the underlying socket.
static SdkHttpConfigurationOption<Boolean>	REAP_IDLE_CONNECTIONS Whether idle connection should be removed after the CONNECTION_MAX_IDLE_TIMEOUT has passed.
static SdkHttpConfigurationOption<Boolean>	TRUST_ALL_CERTIFICATES Option to disable SSL cert validation and SSL host name verification.
static SdkHttpConfigurationOption<Duration>	WRITE_TIMEOUT Timeout for each write to the underlying socket.

Method Summary

Modifier and Type	Method and Description
String	name() Note that the name is mainly used for debugging purposes.
String	toString()

Methods inherited from class software.amazon.awssdk.utils.AttributeMap.Key

convertValue

Methods inherited from class java.lang.Object

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

Field Detail

READ_TIMEOUT

public static final SdkHttpConfigurationOption<Duration> READ_TIMEOUT

Timeout for each read to the underlying socket.

WRITE_TIMEOUT

public static final SdkHttpConfigurationOption<Duration> WRITE_TIMEOUT

Timeout for each write to the underlying socket.

CONNECTION_TIMEOUT

public static final SdkHttpConfigurationOption<Duration> CONNECTION_TIMEOUT

Timeout for establishing a connection to a remote service.

CONNECTION_ACQUIRE_TIMEOUT

public static final SdkHttpConfigurationOption<Duration> CONNECTION_ACQUIRE_TIMEOUT

Timeout for acquiring an already-established connection from a connection pool to a remote service.

CONNECTION_MAX_IDLE_TIMEOUT

public static final SdkHttpConfigurationOption<Duration> CONNECTION_MAX_IDLE_TIMEOUT

Timeout after which an idle connection should be closed.

CONNECTION_TIME_TO_LIVE

public static final SdkHttpConfigurationOption<Duration> CONNECTION_TIME_TO_LIVE

Timeout after which a connection should be closed, regardless of whether it is idle. Zero indicates an infinite amount of time.

MAX_CONNECTIONS

public static final SdkHttpConfigurationOption<Integer> MAX_CONNECTIONS

Maximum number of connections allowed in a connection pool.

PROTOCOL

public static final SdkHttpConfigurationOption<Protocol> PROTOCOL

HTTP protocol to use.

MAX_PENDING_CONNECTION_ACQUIRES

public static final SdkHttpConfigurationOption<Integer> MAX_PENDING_CONNECTION_ACQUIRES

Maximum number of requests allowed to wait for a connection.

TRUST_ALL_CERTIFICATES

public static final SdkHttpConfigurationOption<Boolean> TRUST_ALL_CERTIFICATES

Option to disable SSL cert validation and SSL host name verification. By default, this option is off. Only enable this option for testing purposes.

REAP_IDLE_CONNECTIONS

public static final SdkHttpConfigurationOption<Boolean> REAP_IDLE_CONNECTIONS

Whether idle connection should be removed after the CONNECTION_MAX_IDLE_TIMEOUT has passed.

GLOBAL_HTTP_DEFAULTS

public static final AttributeMap GLOBAL_HTTP_DEFAULTS

Method Detail

name

public String name()

Note that the name is mainly used for debugging purposes. Two option key objects with the same name do not represent the same option. Option keys are compared by reference when obtaining a value from an AttributeMap.

Returns:

Name of this option key.

toString

public String toString()

Overrides:

toString in class Object