com.linkedin.r2.netty.handler.common

Class SessionResumptionSslHandler

java.lang.Object

io.netty.channel.ChannelHandlerAdapter

io.netty.channel.ChannelOutboundHandlerAdapter

com.linkedin.r2.netty.handler.common.SessionResumptionSslHandler

All Implemented Interfaces:

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

public class SessionResumptionSslHandler
extends io.netty.channel.ChannelOutboundHandlerAdapter

SSL handshake, is often an expensive operation. Luckily, it has been developed a feature that allows to resume past connections.

The SSLEngine once created doesn't have context about connections or addresses, but if host and port are specified at its creation, can use the session resumption feature.

This class just initialize the pipeline, adding the SSL handlers. It cannot be in the #initChannel of the PipelineInitializer, because when initiating the channel, we are not yet aware of the remote address. Only once connected we can know the remote address and create the SSLEngine with it to take advantage of the session resumption The class will initiate a SSL handshake upon the connection takes place.

Nested Class Summary

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

io.netty.channel.ChannelHandler.Sharable

Field Summary

Fields

Modifier and Type	Field and Description
static io.netty.util.AttributeKey<SessionResumptionSslHandler>	CHANNEL_SESSION_RESUMPTION_HANDLER
static java.lang.String	PIPELINE_SESSION_RESUMPTION_HANDLER

Constructor Summary

Constructors

Constructor and Description
SessionResumptionSslHandler(io.netty.handler.ssl.SslContext sslContext, boolean enableResumption, int sslHandShakeTimeout)
SessionResumptionSslHandler(javax.net.ssl.SSLContext sslContext, javax.net.ssl.SSLParameters sslParameters, boolean enableResumption, int sslHandShakeTimeout)

Method Summary

Modifier and Type	Method and Description
void	connect(io.netty.channel.ChannelHandlerContext ctx, java.net.SocketAddress remoteAddress, java.net.SocketAddress localAddress, io.netty.channel.ChannelPromise promise)

Methods inherited from class io.netty.channel.ChannelOutboundHandlerAdapter

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

Methods inherited from class io.netty.channel.ChannelHandlerAdapter

ensureNotSharable, exceptionCaught, handlerAdded, handlerRemoved, 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

PIPELINE_SESSION_RESUMPTION_HANDLER

public static final java.lang.String PIPELINE_SESSION_RESUMPTION_HANDLER

See Also:

Constant Field Values

CHANNEL_SESSION_RESUMPTION_HANDLER

public static final io.netty.util.AttributeKey<SessionResumptionSslHandler> CHANNEL_SESSION_RESUMPTION_HANDLER

Constructor Detail

SessionResumptionSslHandler

public SessionResumptionSslHandler(io.netty.handler.ssl.SslContext sslContext,
                                   boolean enableResumption,
                                   int sslHandShakeTimeout)

Parameters:

sslContext - note that the type is SslContext (netty implementation) and not SSLContext (JDK implementation)

SessionResumptionSslHandler

public SessionResumptionSslHandler(javax.net.ssl.SSLContext sslContext,
                                   javax.net.ssl.SSLParameters sslParameters,
                                   boolean enableResumption,
                                   int sslHandShakeTimeout)

Parameters:

sslContext - note that the type is SSLContext (JDK implementation) and not SslContext (netty implementation)

Method Detail

connect

public void connect(io.netty.channel.ChannelHandlerContext ctx,
                    java.net.SocketAddress remoteAddress,
                    java.net.SocketAddress localAddress,
                    io.netty.channel.ChannelPromise promise)
             throws java.lang.Exception

Specified by:

connect in interface io.netty.channel.ChannelOutboundHandler

Overrides:

connect in class io.netty.channel.ChannelOutboundHandlerAdapter

Throws:

java.lang.Exception