io.netty.incubator.codec.quic

Class QuicCodecDispatcher

java.lang.Object

io.netty.channel.ChannelHandlerAdapter

io.netty.channel.ChannelInboundHandlerAdapter

io.netty.incubator.codec.quic.QuicCodecDispatcher

All Implemented Interfaces:

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

public abstract class QuicCodecDispatcher
extends io.netty.channel.ChannelInboundHandlerAdapter

Special ChannelHandler that should be used to init Channels that will be used for QUIC while SO_REUSEPORT is used to bind to same InetSocketAddress multiple times. This is necessary to ensure QUIC packets are always dispatched to the correct codec that keeps the mapping for the connection id. This implementation use a very simple mapping strategy by encoding the index of the internal datastructure that keeps track of the different ChannelHandlerContexts into the destination connection id. This way once a QUIC packet is received its possible to forward it to the right codec. Subclasses might change how encoding / decoding of the index is done by overriding decodeIndex(ByteBuf) and newIdGenerator(int).

It is important that the same QuicCodecDispatcher instance is shared between all the Channels that are bound to the same InetSocketAddress and use SO_REUSEPORT.

An alternative way to handle this would be to do the "routing" to the correct socket in an epbf program by implementing your own QuicConnectionIdGenerator that issue ids that can be understood and handled by the epbf program to route the packet to the correct socket.

Nested Class Summary

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

io.netty.channel.ChannelHandler.Sharable

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	QuicCodecDispatcher() Create a new instance using the default connection id length.
protected	QuicCodecDispatcher(int localConnectionIdLength) Create a new instance

Method Summary

Modifier and Type	Method and Description
void	channelRead(io.netty.channel.ChannelHandlerContext ctx, java.lang.Object msg)
void	channelReadComplete(io.netty.channel.ChannelHandlerContext ctx)
protected int	decodeIndex(io.netty.buffer.ByteBuf connectionId) Return the idx that was encoded into the connectionId via the QuicConnectionIdGenerator before, or -1 if decoding was not successful.
void	handlerAdded(io.netty.channel.ChannelHandlerContext ctx)
void	handlerRemoved(io.netty.channel.ChannelHandlerContext ctx)
protected abstract void	initChannel(io.netty.channel.Channel channel, int localConnectionIdLength, QuicConnectionIdGenerator idGenerator) Init the Channel and add all the needed ChannelHandler to the pipeline.
boolean	isSharable()
protected QuicConnectionIdGenerator	newIdGenerator(int idx) Returns a QuicConnectionIdGenerator that will encode the given index into all the ids that it produces.

Methods inherited from class io.netty.channel.ChannelInboundHandlerAdapter

channelActive, channelInactive, channelRegistered, channelUnregistered, channelWritabilityChanged, exceptionCaught, userEventTriggered

Methods inherited from class io.netty.channel.ChannelHandlerAdapter

ensureNotSharable

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

QuicCodecDispatcher

protected QuicCodecDispatcher()

Create a new instance using the default connection id length.

QuicCodecDispatcher

protected QuicCodecDispatcher(int localConnectionIdLength)

Create a new instance

Parameters:

localConnectionIdLength - the local connection id length. This must be between 10 and 20.

Method Detail

isSharable

public final boolean isSharable()

Overrides:

isSharable in class io.netty.channel.ChannelHandlerAdapter

handlerAdded

public final void handlerAdded(io.netty.channel.ChannelHandlerContext ctx)
                        throws java.lang.Exception

Specified by:

handlerAdded in interface io.netty.channel.ChannelHandler

Overrides:

handlerAdded in class io.netty.channel.ChannelHandlerAdapter

Throws:

java.lang.Exception

handlerRemoved

public final void handlerRemoved(io.netty.channel.ChannelHandlerContext ctx)
                          throws java.lang.Exception

Specified by:

handlerRemoved in interface io.netty.channel.ChannelHandler

Overrides:

handlerRemoved in class io.netty.channel.ChannelHandlerAdapter

Throws:

java.lang.Exception

channelRead

public final void channelRead(io.netty.channel.ChannelHandlerContext ctx,
                              java.lang.Object msg)
                       throws java.lang.Exception

Specified by:

channelRead in interface io.netty.channel.ChannelInboundHandler

Overrides:

channelRead in class io.netty.channel.ChannelInboundHandlerAdapter

Throws:

java.lang.Exception

channelReadComplete

public final void channelReadComplete(io.netty.channel.ChannelHandlerContext ctx)

Specified by:

channelReadComplete in interface io.netty.channel.ChannelInboundHandler

Overrides:

channelReadComplete in class io.netty.channel.ChannelInboundHandlerAdapter

initChannel

protected abstract void initChannel(io.netty.channel.Channel channel,
                                    int localConnectionIdLength,
                                    QuicConnectionIdGenerator idGenerator)
                             throws java.lang.Exception

Init the Channel and add all the needed ChannelHandler to the pipeline. This also included building the QUIC codec via QuicCodecBuilder sub-type using the given local connection id length and QuicConnectionIdGenerator.

Parameters:

channel - the Channel to init.

localConnectionIdLength - the local connection id length that must be used with the QuicCodecBuilder.

idGenerator - the QuicConnectionIdGenerator that must be used with the QuicCodecBuilder.

Throws:

java.lang.Exception - thrown on error.

decodeIndex

protected int decodeIndex(io.netty.buffer.ByteBuf connectionId)

Return the idx that was encoded into the connectionId via the QuicConnectionIdGenerator before, or -1 if decoding was not successful.

Subclasses may override this. In this case newIdGenerator(int) should be overridden as well to implement the encoding scheme for the encoding side.

Parameters:

connectionId - the destination connection id of the QUIC connection.

Returns:

the index or -1.

newIdGenerator

protected QuicConnectionIdGenerator newIdGenerator(int idx)

Returns a QuicConnectionIdGenerator that will encode the given index into all the ids that it produces.

Subclasses may override this. In this case decodeIndex(ByteBuf) should be overridden as well to implement the encoding scheme for the decoding side.

Parameters:

idx - the index to encode into each id.

Returns:

the QuicConnectionIdGenerator.