io.netty.handler.ssl

Class SniHandler

java.lang.Object

io.netty.channel.ChannelHandlerAdapter

io.netty.channel.ChannelInboundHandlerAdapter

io.netty.handler.codec.ByteToMessageDecoder

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

io.netty.handler.ssl.SniHandler

All Implemented Interfaces:

io.netty.channel.ChannelHandler, io.netty.channel.ChannelInboundHandler, io.netty.channel.ChannelOutboundHandler

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.netty.handler.codec.ByteToMessageDecoder

io.netty.handler.codec.ByteToMessageDecoder.Cumulator

Nested classes/interfaces inherited from interface io.netty.channel.ChannelHandler

io.netty.channel.ChannelHandler.Sharable

Field Summary

Fields

Modifier and Type	Field and Description
protected io.netty.util.AsyncMapping<String,SslContext>	mapping

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

COMPOSITE_CUMULATOR, MERGE_CUMULATOR

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
String	hostname()
protected io.netty.util.concurrent.Future<SslContext>	lookup(io.netty.channel.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 void	onLookupComplete(io.netty.channel.ChannelHandlerContext ctx, String hostname, io.netty.util.concurrent.Future<SslContext> future) Called upon completion of the AbstractSniHandler.lookup(ChannelHandlerContext, String) Future.
protected void	replaceHandler(io.netty.channel.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.netty.handler.ssl.AbstractSniHandler

bind, close, connect, decode, deregister, disconnect, flush, read, write

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

actualReadableBytes, callDecode, channelInactive, channelRead, channelReadComplete, decodeLast, discardSomeReadBytes, handlerRemoved, handlerRemoved0, internalBuffer, isSingleDecode, setCumulator, setDiscardAfterReads, setSingleDecode, userEventTriggered

Methods inherited from class io.netty.channel.ChannelInboundHandlerAdapter

channelActive, channelRegistered, channelUnregistered, channelWritabilityChanged, exceptionCaught

Methods inherited from class io.netty.channel.ChannelHandlerAdapter

ensureNotSharable, handlerAdded, isSharable

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.netty.channel.ChannelHandler

exceptionCaught, handlerAdded, handlerRemoved

Field Detail

mapping

protected final io.netty.util.AsyncMapping<String,SslContext> mapping

Constructor Detail

SniHandler

public SniHandler(io.netty.util.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(io.netty.util.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(io.netty.util.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 io.netty.util.concurrent.Future<SslContext> lookup(io.netty.channel.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(io.netty.channel.ChannelHandlerContext ctx,
                                      String hostname,
                                      io.netty.util.concurrent.Future<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(io.netty.channel.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