io.netty.handler.ssl

Class OptionalSslHandler

java.lang.Object

io.netty.channel.ChannelHandlerAdapter

io.netty.channel.ChannelInboundHandlerAdapter

io.netty.handler.codec.ByteToMessageDecoder

io.netty.handler.ssl.OptionalSslHandler

All Implemented Interfaces:

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

public class OptionalSslHandler
extends io.netty.handler.codec.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.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 inherited from class io.netty.handler.codec.ByteToMessageDecoder

COMPOSITE_CUMULATOR, MERGE_CUMULATOR

Constructor Summary

Constructors

Constructor and Description
OptionalSslHandler(SslContext sslContext)

Method Summary

Modifier and Type	Method and Description
protected void	decode(io.netty.channel.ChannelHandlerContext context, io.netty.buffer.ByteBuf in, List<Object> out)
protected io.netty.channel.ChannelHandler	newNonSslHandler(io.netty.channel.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(io.netty.channel.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.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

handlerAdded

Constructor Detail

OptionalSslHandler

public OptionalSslHandler(SslContext sslContext)

Method Detail

decode

protected void decode(io.netty.channel.ChannelHandlerContext context,
                      io.netty.buffer.ByteBuf in,
                      List<Object> out)
               throws Exception

Specified by:

decode in class io.netty.handler.codec.ByteToMessageDecoder

Throws:

Exception

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(io.netty.channel.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(ByteBufAllocator, 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 io.netty.channel.ChannelHandler newNonSslHandler(io.netty.channel.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.