Module io.netty5.handler

Package io.netty5.handler.ssl

Class OptionalSslHandler

java.lang.Object

io.netty5.channel.ChannelHandlerAdapter

io.netty5.handler.codec.ByteToMessageDecoder

io.netty5.handler.ssl.OptionalSslHandler

All Implemented Interfaces:

ChannelHandler

public class OptionalSslHandler
extends ByteToMessageDecoder

OptionalSslHandler is a utility decoder to support both SSL and non-SSL handlers based on the first message 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
OptionalSslHandler(SslContext sslContext)

Method Summary

Modifier and Type	Method	Description
protected void	decode(ChannelHandlerContext context, Buffer in)	Decode the from one Buffer to another.
protected ChannelHandler	newNonSslHandler(ChannelHandlerContext context)	Override to configure the ChannelHandler.
protected String	newNonSslHandlerName()	Optionally specify the non-SSL handler name, this method may return null.
protected SslHandler	newSslHandler(ChannelHandlerContext context, SslContext sslContext)	Override to configure the SslHandler eg.
protected String	newSslHandlerName()	Optionally specify the SSL handler name, this method may return null.

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

actualReadableBytes, channelInactive, channelRead, channelReadComplete, channelShutdown, decodeLast, discardSomeReadBytes, handlerAdded, handlerAdded0, handlerRemoved, handlerRemoved0, 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, read, register, sendOutboundEvent, shutdown, write

Constructor Detail

OptionalSslHandler

public OptionalSslHandler(SslContext sslContext)

Method Detail

decode

protected void decode(ChannelHandlerContext context,
                      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:

context - the ChannelHandlerContext which this ByteToMessageDecoder belongs to

in - the Buffer from which to read data

Throws:

Exception - is thrown if an error occurs

newSslHandlerName

protected String newSslHandlerName()

Optionally specify the SSL handler name, this method may return null.

Returns:

the name of the SSL handler.

newSslHandler

protected SslHandler newSslHandler(ChannelHandlerContext context,
                                   SslContext sslContext)

Override to configure the SslHandler eg. SSLParameters.setEndpointIdentificationAlgorithm(String). The hostname and port is not known by this method so servers may want to override this method and use the SslContext.newHandler(BufferAllocator, String, int) variant.

Parameters:

context - the ChannelHandlerContext to use.

sslContext - the SSLContext to use.

Returns:

the SslHandler which will replace the OptionalSslHandler in the pipeline if the traffic is SSL.

newNonSslHandlerName

protected String newNonSslHandlerName()

Optionally specify the non-SSL handler name, this method may return null.

Returns:

the name of the non-SSL handler.

newNonSslHandler

protected ChannelHandler newNonSslHandler(ChannelHandlerContext context)

Override to configure the ChannelHandler.

Parameters:

context - the ChannelHandlerContext to use.

Returns:

the ChannelHandler which will replace the OptionalSslHandler in the pipeline or null to simply remove the OptionalSslHandler if the traffic is non-SSL.