software.amazon.awssdk.http.nio.netty

Interface NettyNioAsyncHttpClient.Builder

All Superinterfaces:

SdkAsyncHttpClient.Builder<NettyNioAsyncHttpClient.Builder>, SdkBuilder<NettyNioAsyncHttpClient.Builder,SdkAsyncHttpClient>

Enclosing class:

NettyNioAsyncHttpClient

public static interface NettyNioAsyncHttpClient.Builder
extends SdkAsyncHttpClient.Builder<NettyNioAsyncHttpClient.Builder>

Builder that allows configuration of the Netty NIO HTTP implementation. Use NettyNioAsyncHttpClient.builder() to configure and construct a Netty HTTP client.

Method Summary

Modifier and Type	Method and Description
NettyNioAsyncHttpClient.Builder	connectionAcquisitionTimeout(Duration connectionAcquisitionTimeout) The amount of time to wait when acquiring a connection from the pool before giving up and timing out.
NettyNioAsyncHttpClient.Builder	connectionTimeout(Duration timeout) The amount of time to wait when initially establishing a connection before giving up and timing out.
NettyNioAsyncHttpClient.Builder	eventLoopGroup(SdkEventLoopGroup eventLoopGroup) Sets the SdkEventLoopGroup to use for the Netty HTTP client.
NettyNioAsyncHttpClient.Builder	eventLoopGroupBuilder(SdkEventLoopGroup.Builder eventLoopGroupBuilder) Sets the SdkEventLoopGroup.Builder which will be used to create the SdkEventLoopGroup for the Netty HTTP client.
NettyNioAsyncHttpClient.Builder	maxConcurrency(Integer maxConcurrency) Maximum number of allowed concurrent requests.
NettyNioAsyncHttpClient.Builder	maxPendingConnectionAcquires(Integer maxPendingAcquires) The maximum number of pending acquires allowed.
NettyNioAsyncHttpClient.Builder	protocol(Protocol protocol) Sets the HTTP protocol to use (i.e.
NettyNioAsyncHttpClient.Builder	readTimeout(Duration readTimeout) The amount of time to wait for a read on a socket before an exception is thrown.
NettyNioAsyncHttpClient.Builder	writeTimeout(Duration writeTimeout) The amount of time to wait for a write on a socket before an exception is thrown.

Methods inherited from interface software.amazon.awssdk.http.async.SdkAsyncHttpClient.Builder

build, buildWithDefaults

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

applyMutation

Method Detail

maxConcurrency

NettyNioAsyncHttpClient.Builder maxConcurrency(Integer maxConcurrency)

Maximum number of allowed concurrent requests. For HTTP/1.1 this is the same as max connections. For HTTP/2 the number of connections that will be used depends on the max streams allowed per connection.

If the maximum number of concurrent requests is exceeded they may be queued in the HTTP client (see maxPendingConnectionAcquires(Integer)

) and can cause increased latencies. If the client is overloaded enough such that the pending connection queue fills up, subsequent requests may be rejected or time out (see connectionAcquisitionTimeout(Duration)).

Parameters:

maxConcurrency - New value for max concurrency.

Returns:

This builder for method chaining.

maxPendingConnectionAcquires

NettyNioAsyncHttpClient.Builder maxPendingConnectionAcquires(Integer maxPendingAcquires)

The maximum number of pending acquires allowed. Once this exceeds, acquire tries will be failed.

Parameters:

maxPendingAcquires - Max number of pending acquires

Returns:

This builder for method chaining.

readTimeout

NettyNioAsyncHttpClient.Builder readTimeout(Duration readTimeout)

The amount of time to wait for a read on a socket before an exception is thrown.

Parameters:

readTimeout - timeout duration

Returns:

this builder for method chaining.

writeTimeout

NettyNioAsyncHttpClient.Builder writeTimeout(Duration writeTimeout)

The amount of time to wait for a write on a socket before an exception is thrown.

Parameters:

writeTimeout - timeout duration

Returns:

this builder for method chaining.

connectionTimeout

NettyNioAsyncHttpClient.Builder connectionTimeout(Duration timeout)

The amount of time to wait when initially establishing a connection before giving up and timing out.

Parameters:

timeout - the timeout duration

Returns:

this builder for method chaining.

connectionAcquisitionTimeout

NettyNioAsyncHttpClient.Builder connectionAcquisitionTimeout(Duration connectionAcquisitionTimeout)

The amount of time to wait when acquiring a connection from the pool before giving up and timing out.

Parameters:

connectionAcquisitionTimeout - the timeout duration

Returns:

this builder for method chaining.

eventLoopGroup

NettyNioAsyncHttpClient.Builder eventLoopGroup(SdkEventLoopGroup eventLoopGroup)

Sets the SdkEventLoopGroup to use for the Netty HTTP client. This event loop group may be shared across multiple HTTP clients for better resource and thread utilization. The preferred way to create an EventLoopGroup is by using the SdkEventLoopGroup.builder())} method which will choose the optimal implementation per the platform.

The EventLoopGroup MUST be closed by the caller when it is ready to be disposed. The SDK will not close the EventLoopGroup when the HTTP client is closed. See EventExecutorGroup.shutdownGracefully() to properly close the event loop group.

This configuration method is only recommended when you wish to share an EventLoopGroup with multiple clients. If you do not need to share the group it is recommended to use eventLoopGroupBuilder(SdkEventLoopGroup.Builder) as the SDK will handle its cleanup when the HTTP client is closed.

Parameters:

eventLoopGroup - Netty SdkEventLoopGroup to use.

Returns:

This builder for method chaining.

See Also:

SdkEventLoopGroup

eventLoopGroupBuilder

NettyNioAsyncHttpClient.Builder eventLoopGroupBuilder(SdkEventLoopGroup.Builder eventLoopGroupBuilder)

Sets the SdkEventLoopGroup.Builder which will be used to create the SdkEventLoopGroup for the Netty HTTP client. This allows for custom configuration of the Netty EventLoopGroup.

The EventLoopGroup created by the builder is managed by the SDK and will be shutdown when the HTTP client is closed.

This is the preferred configuration method when you just want to customize the EventLoopGroup but not share it across multiple HTTP clients. If you do wish to share an EventLoopGroup, see eventLoopGroup(SdkEventLoopGroup)

Parameters:

eventLoopGroupBuilder - SdkEventLoopGroup.Builder to use.

Returns:

This builder for method chaining.

See Also:

SdkEventLoopGroup.Builder

protocol

NettyNioAsyncHttpClient.Builder protocol(Protocol protocol)

Sets the HTTP protocol to use (i.e. HTTP/1.1 or HTTP/2). Not all services support HTTP/2.

Parameters:

protocol - Protocol to use.

Returns:

This builder for method chaining.