io.netty.handler.ssl

Class AbstractSniHandler<T>

java.lang.Object

io.netty.channel.ChannelHandlerAdapter

io.netty.channel.ChannelInboundHandlerAdapter

io.netty.handler.codec.ByteToMessageDecoder

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

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

All Implemented Interfaces:

ChannelHandler, ChannelInboundHandler, ChannelOutboundHandler

Direct Known Subclasses:

SniHandler

public abstract class AbstractSniHandler<T>
extends SslClientHelloHandler<T>

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

ByteToMessageDecoder.Cumulator

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

ChannelHandler.Sharable

Field Summary

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

COMPOSITE_CUMULATOR, MERGE_CUMULATOR

Constructor Summary

Constructors

Constructor and Description
AbstractSniHandler()

Method Summary

Modifier and Type	Method and Description
protected Future<T>	lookup(ChannelHandlerContext ctx, ByteBuf clientHello) Kicks off a lookup for the given ClientHello and returns a Future which in turn will notify the SslClientHelloHandler.onLookupComplete(ChannelHandlerContext, Future) on completion.
protected abstract Future<T>	lookup(ChannelHandlerContext ctx, String hostname) Kicks off a lookup for the given SNI value and returns a Future which in turn will notify the onLookupComplete(ChannelHandlerContext, String, Future) on completion.
protected void	onLookupComplete(ChannelHandlerContext ctx, Future<T> future) Called upon completion of the SslClientHelloHandler.lookup(ChannelHandlerContext, ByteBuf) Future.
protected abstract void	onLookupComplete(ChannelHandlerContext ctx, String hostname, Future<T> future) Called upon completion of the lookup(ChannelHandlerContext, String) Future.

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

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

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

actualReadableBytes, callDecode, channelInactive, channelRead, channelReadComplete, decodeLast, discardSomeReadBytes, handlerRemoved, 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

Constructor Detail

AbstractSniHandler

public AbstractSniHandler()

Method Detail

lookup

protected Future<T> lookup(ChannelHandlerContext ctx,
                           ByteBuf clientHello)
                    throws Exception

Description copied from class: SslClientHelloHandler

Kicks off a lookup for the given ClientHello and returns a Future which in turn will notify the SslClientHelloHandler.onLookupComplete(ChannelHandlerContext, Future) on completion. See https://tools.ietf.org/html/rfc5246#section-7.4.1.2

 struct {
    ProtocolVersion client_version;
    Random random;
    SessionID session_id;
    CipherSuite cipher_suites<2..2^16-2>;
    CompressionMethod compression_methods<1..2^8-1>;
    select (extensions_present) {
        case false:
            struct {};
        case true:
            Extension extensions<0..2^16-1>;
    };
 } ClientHello;
 

Specified by:

lookup in class SslClientHelloHandler<T>

Throws:

Exception

See Also:

SslClientHelloHandler.onLookupComplete(ChannelHandlerContext, Future)

onLookupComplete

protected void onLookupComplete(ChannelHandlerContext ctx,
                                Future<T> future)
                         throws Exception

Description copied from class: SslClientHelloHandler

Called upon completion of the SslClientHelloHandler.lookup(ChannelHandlerContext, ByteBuf) Future.

Specified by:

onLookupComplete in class SslClientHelloHandler<T>

Throws:

Exception

See Also:

SslClientHelloHandler.lookup(ChannelHandlerContext, ByteBuf)

lookup

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

Kicks off a lookup for the given SNI value and returns a Future which in turn will notify the onLookupComplete(ChannelHandlerContext, String, Future) on completion.

Throws:

Exception

See Also:

onLookupComplete(ChannelHandlerContext, String, Future)

onLookupComplete

protected abstract void onLookupComplete(ChannelHandlerContext ctx,
                                         String hostname,
                                         Future<T> future)
                                  throws Exception

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

Throws:

Exception

See Also:

lookup(ChannelHandlerContext, String)