io.netty.handler.codec

Class FixedLengthFrameDecoder

java.lang.Object

io.netty.channel.ChannelHandlerAdapter

io.netty.channel.ChannelStateHandlerAdapter

io.netty.channel.ChannelInboundByteHandlerAdapter

io.netty.handler.codec.ByteToMessageDecoder

io.netty.handler.codec.FixedLengthFrameDecoder

All Implemented Interfaces:

io.netty.channel.ChannelHandler, io.netty.channel.ChannelInboundByteHandler, io.netty.channel.ChannelStateHandler

public class FixedLengthFrameDecoder
extends ByteToMessageDecoder

A decoder that splits the received ByteBufs by the fixed number of bytes. For example, if you received the following four fragmented packets:

 +---+----+------+----+
 | A | BC | DEFG | HI |
 +---+----+------+----+
 

A FixedLengthFrameDecoder(3) will decode them into the following three packets with the fixed length:

 +-----+-----+-----+
 | ABC | DEF | GHI |
 +-----+-----+-----+
 

Nested Class Summary

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

io.netty.channel.ChannelHandler.Sharable

Constructor Summary

Constructors

Constructor and Description
FixedLengthFrameDecoder(int frameLength) Calls FixedLengthFrameDecoder(int, boolean) with false
FixedLengthFrameDecoder(int frameLength, boolean allocateFullBuffer) Creates a new instance.

Method Summary

Methods

Modifier and Type	Method and Description
protected Object	decode(io.netty.channel.ChannelHandlerContext ctx, io.netty.buffer.ByteBuf in)
protected void	decode(io.netty.channel.ChannelHandlerContext ctx, io.netty.buffer.ByteBuf in, io.netty.buffer.MessageBuf<Object> out) Decode the from one ByteBuf to an other.
io.netty.buffer.ByteBuf	newInboundBuffer(io.netty.channel.ChannelHandlerContext ctx)

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

callDecode, channelInactive, channelReadSuspended, decodeLast, inboundBufferUpdated, isSingleDecode, setSingleDecode

Methods inherited from class io.netty.channel.ChannelInboundByteHandlerAdapter

discardInboundReadBytes, inboundBufferUpdated

Methods inherited from class io.netty.channel.ChannelStateHandlerAdapter

channelActive, channelRegistered, channelUnregistered, userEventTriggered

Methods inherited from class io.netty.channel.ChannelHandlerAdapter

exceptionCaught, handlerAdded, handlerRemoved

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.ChannelStateHandler

channelActive, channelRegistered, channelUnregistered, userEventTriggered

Methods inherited from interface io.netty.channel.ChannelHandler

exceptionCaught, handlerAdded, handlerRemoved

Constructor Detail

FixedLengthFrameDecoder

public FixedLengthFrameDecoder(int frameLength)

Calls FixedLengthFrameDecoder(int, boolean) with false

FixedLengthFrameDecoder

public FixedLengthFrameDecoder(int frameLength,
                       boolean allocateFullBuffer)

Creates a new instance.

Parameters:

frameLength - the length of the frame

allocateFullBuffer - true if the cumulative ByteBuf should use the frameLength as its initial size

Method Detail

newInboundBuffer

public io.netty.buffer.ByteBuf newInboundBuffer(io.netty.channel.ChannelHandlerContext ctx)
                                         throws Exception

Specified by:

newInboundBuffer in interface io.netty.channel.ChannelInboundByteHandler

Overrides:

newInboundBuffer in class io.netty.channel.ChannelInboundByteHandlerAdapter

Throws:

Exception

decode

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

Description copied from class: ByteToMessageDecoder

Decode the from one ByteBuf to an other. This method will be called till either the input ByteBuf has nothing to read anymore, till nothing was read from the input ByteBuf or till this method returns null.

Specified by:

decode in class ByteToMessageDecoder

Parameters:

ctx - the ChannelHandlerContext which this ByteToByteDecoder belongs to

in - the ByteBuf from which to read data

out - the MessageBuf to which decoded messages should be added

Throws:

Exception - is thrown if an error accour

decode

protected Object decode(io.netty.channel.ChannelHandlerContext ctx,
            io.netty.buffer.ByteBuf in)
                 throws Exception

Throws:

Exception