Module io.netty5.handler

Package io.netty5.handler.ssl

Class SniHandler

java.lang.Object

io.netty5.channel.ChannelHandlerAdapter

io.netty5.handler.codec.ByteToMessageDecoder

io.netty5.handler.ssl.SslClientHelloHandler<T>

io.netty5.handler.ssl.AbstractSniHandler<SslContext>

io.netty5.handler.ssl.SniHandler

All Implemented Interfaces:

ChannelHandler

public class SniHandler
extends AbstractSniHandler<SslContext>

Enables SNI (Server Name Indication) extension for server side SSL. For clients support SNI, the server could have multiple host name bound on a single IP. The client will send host name in the handshake data so server could decide which certificate to choose for the host name.

Nested Class Summary

Nested classes/interfaces inherited from class io.netty5.handler.codec.ByteToMessageDecoder

ByteToMessageDecoder.Cumulator

Field Summary

Fields

Modifier and Type	Field	Description
protected AsyncMapping<String,SslContext>	mapping

Fields inherited from class io.netty5.handler.codec.ByteToMessageDecoder

COMPOSITE_CUMULATOR, MERGE_CUMULATOR

Constructor Summary

Constructors

Constructor	Description
SniHandler(AsyncMapping<? super String,? extends SslContext> mapping)	Creates a SNI detection handler with configured SslContext maintained by AsyncMapping
SniHandler(DomainNameMapping<? extends SslContext> mapping)	Creates a SNI detection handler with configured SslContext maintained by DomainNameMapping
SniHandler(Mapping<? super String,? extends SslContext> mapping)	Creates a SNI detection handler with configured SslContext maintained by Mapping

Method Summary

Modifier and Type	Method	Description
String	hostname()
protected Future<SslContext>	lookup(ChannelHandlerContext ctx, String hostname)	The default implementation will simply call AsyncMapping.map(Object, Promise) but users can override this method to implement custom behavior.
protected SslHandler	newSslHandler(SslContext context, BufferAllocator allocator)	Returns a new SslHandler using the given SslContext and BufferAllocator.
protected void	onLookupComplete(ChannelHandlerContext ctx, String hostname, Future<? extends SslContext> future)	Called upon completion of the AbstractSniHandler.lookup(ChannelHandlerContext, String) Future.
protected void	replaceHandler(ChannelHandlerContext ctx, String hostname, SslContext sslContext)	The default implementation of this method will simply replace this SniHandler instance with a SslHandler.
SslContext	sslContext()

Methods inherited from class io.netty5.handler.ssl.AbstractSniHandler

lookup, onLookupComplete

Methods inherited from class io.netty5.handler.ssl.SslClientHelloHandler

decode, handlerRemoved0, read

Methods inherited from class io.netty5.handler.codec.ByteToMessageDecoder

actualReadableBytes, channelInactive, channelRead, channelReadComplete, channelShutdown, decodeLast, discardSomeReadBytes, handlerAdded, handlerAdded0, handlerRemoved, internalBuffer, isSharable, isSingleDecode, setSingleDecode

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.netty5.channel.ChannelHandler

bind, channelActive, channelExceptionCaught, channelInboundEvent, channelRegistered, channelUnregistered, channelWritabilityChanged, close, connect, deregister, disconnect, flush, pendingOutboundBytes, register, sendOutboundEvent, shutdown, write

Field Detail

mapping

protected final AsyncMapping<String,SslContext> mapping

Constructor Detail

SniHandler

public SniHandler(Mapping<? super String,? extends SslContext> mapping)

Creates a SNI detection handler with configured SslContext maintained by Mapping

Parameters:

mapping - the mapping of domain name to SslContext

SniHandler

public SniHandler(DomainNameMapping<? extends SslContext> mapping)

Creates a SNI detection handler with configured SslContext maintained by DomainNameMapping

Parameters:

mapping - the mapping of domain name to SslContext

SniHandler

public SniHandler(AsyncMapping<? super String,? extends SslContext> mapping)

Creates a SNI detection handler with configured SslContext maintained by AsyncMapping

Parameters:

mapping - the mapping of domain name to SslContext

Method Detail

hostname

public String hostname()

Returns:

the selected hostname

sslContext

public SslContext sslContext()

Returns:

the selected SslContext

lookup

protected Future<SslContext> lookup(ChannelHandlerContext ctx,
                                    String hostname)
                             throws Exception

The default implementation will simply call AsyncMapping.map(Object, Promise) but users can override this method to implement custom behavior.

Specified by:

lookup in class AbstractSniHandler<SslContext>

Throws:

Exception

See Also:

AsyncMapping.map(Object, Promise)

onLookupComplete

protected final void onLookupComplete(ChannelHandlerContext ctx,
                                      String hostname,
                                      Future<? extends SslContext> future)
                               throws Exception

Description copied from class: AbstractSniHandler

Called upon completion of the AbstractSniHandler.lookup(ChannelHandlerContext, String) Future.

Specified by:

onLookupComplete in class AbstractSniHandler<SslContext>

Throws:

Exception

See Also:

AbstractSniHandler.lookup(ChannelHandlerContext, String)

replaceHandler

protected void replaceHandler(ChannelHandlerContext ctx,
                              String hostname,
                              SslContext sslContext)
                       throws Exception

The default implementation of this method will simply replace this SniHandler instance with a SslHandler. Users may override this method to implement custom behavior. Please be aware that this method may get called after a client has already disconnected and custom implementations must take it into consideration when overriding this method. It's also possible for the hostname argument to be null.

Throws:

Exception

newSslHandler

protected SslHandler newSslHandler(SslContext context,
                                   BufferAllocator allocator)

Returns a new SslHandler using the given SslContext and BufferAllocator. Users may override this method to implement custom behavior.