software.amazon.awssdk.http.nio.netty

Class SdkEventLoopGroup

java.lang.Object

software.amazon.awssdk.http.nio.netty.SdkEventLoopGroup

public final class SdkEventLoopGroup
extends Object

Provides EventLoopGroup and ChannelFactory for NettyNioAsyncHttpClient.

There are two ways to create a new instance.

• Using create(EventLoopGroup, ChannelFactory) to provide a custom EventLoopGroup and ChannelFactory

  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.

• using builder() to provide custom configuration of EventLoopGroup. The EventLoopGroup created by the builder is managed by the SDK and will be shutdown when the HTTP client is closed.

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method and Description
static SdkEventLoopGroup.Builder	builder()
io.netty.channel.ChannelFactory<? extends io.netty.channel.Channel>	channelFactory()
static SdkEventLoopGroup	create(io.netty.channel.EventLoopGroup eventLoopGroup) Creates a new instance of SdkEventLoopGroup with EventLoopGroup.
static SdkEventLoopGroup	create(io.netty.channel.EventLoopGroup eventLoopGroup, io.netty.channel.ChannelFactory<? extends io.netty.channel.Channel> channelFactory) Creates a new instance of SdkEventLoopGroup with EventLoopGroup and ChannelFactory to be used with NettyNioAsyncHttpClient.
io.netty.channel.EventLoopGroup	eventLoopGroup()

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

eventLoopGroup

public io.netty.channel.EventLoopGroup eventLoopGroup()

Returns:

the EventLoopGroup to be used with Netty Http client.

channelFactory

public io.netty.channel.ChannelFactory<? extends io.netty.channel.Channel> channelFactory()

Returns:

the ChannelFactory to be used with Netty Http Client.

create

public static SdkEventLoopGroup create(io.netty.channel.EventLoopGroup eventLoopGroup,
                                       io.netty.channel.ChannelFactory<? extends io.netty.channel.Channel> channelFactory)

Creates a new instance of SdkEventLoopGroup with EventLoopGroup and ChannelFactory to be used with NettyNioAsyncHttpClient.

Parameters:

eventLoopGroup - the EventLoopGroup to be used

channelFactory - the channel factor to be used

Returns:

a new instance of SdkEventLoopGroup

create

public static SdkEventLoopGroup create(io.netty.channel.EventLoopGroup eventLoopGroup)

Creates a new instance of SdkEventLoopGroup with EventLoopGroup.

ChannelFactory will be resolved based on the type of EventLoopGroup provided. IllegalArgumentException will be thrown for any unknown EventLoopGroup type.

Parameters:

eventLoopGroup - the EventLoopGroup to be used

Returns:

a new instance of SdkEventLoopGroup

builder

public static SdkEventLoopGroup.Builder builder()