Module io.netty5.handler

Package io.netty5.handler.ssl

Class SslClientHelloHandler<T>

java.lang.Object

io.netty5.channel.ChannelHandlerAdapter

io.netty5.handler.codec.ByteToMessageDecoder

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

All Implemented Interfaces:

ChannelHandler

Direct Known Subclasses:

AbstractSniHandler

public abstract class SslClientHelloHandler<T>
extends ByteToMessageDecoder

ByteToMessageDecoder which allows to be notified once a full ClientHello was received.

Nested Class Summary

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

ByteToMessageDecoder.Cumulator

Field Summary

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

COMPOSITE_CUMULATOR, MERGE_CUMULATOR

Constructor Summary

Constructors

Constructor	Description
SslClientHelloHandler()

Method Summary

Modifier and Type	Method	Description
protected void	decode(ChannelHandlerContext ctx, Buffer in)	Decode the from one Buffer to another.
protected void	handlerRemoved0(ChannelHandlerContext ctx)	Gets called after the ByteToMessageDecoder was removed from the actual context and it doesn't handle events anymore.
protected abstract Future<T>	lookup(ChannelHandlerContext ctx, Buffer clientHello)	Kicks off a lookup for the given ClientHello and returns a Future which in turn will notify the onLookupComplete(ChannelHandlerContext, Future) on completion.
protected abstract void	onLookupComplete(ChannelHandlerContext ctx, Future<? extends T> future)	Called upon completion of the lookup(ChannelHandlerContext, Buffer) Future.
void	read(ChannelHandlerContext ctx)	Intercepts ChannelHandlerContext.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

Constructor Detail

SslClientHelloHandler

public SslClientHelloHandler()

Method Detail

decode

protected void decode(ChannelHandlerContext ctx,
                      Buffer in)
               throws Exception

Description copied from class: ByteToMessageDecoder

Decode the from one Buffer to another. This method will be called till either the input Buffer has nothing to read when return from this method or till nothing was read from the input Buffer.

Specified by:

decode in class ByteToMessageDecoder

Parameters:

ctx - the ChannelHandlerContext which this ByteToMessageDecoder belongs to

in - the Buffer from which to read data

Throws:

Exception - is thrown if an error occurs

handlerRemoved0

protected void handlerRemoved0(ChannelHandlerContext ctx)
                        throws Exception

Description copied from class: ByteToMessageDecoder

Gets called after the ByteToMessageDecoder was removed from the actual context and it doesn't handle events anymore.

Overrides:

handlerRemoved0 in class ByteToMessageDecoder

Throws:

Exception

lookup

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

Kicks off a lookup for the given ClientHello and returns a Future which in turn will notify the 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;
 

Throws:

Exception

See Also:

onLookupComplete(ChannelHandlerContext, Future)

onLookupComplete

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

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

Throws:

Exception

See Also:

lookup(ChannelHandlerContext, Buffer)

read

public void read(ChannelHandlerContext ctx)

Description copied from interface: ChannelHandler

Intercepts ChannelHandlerContext.read().