org.apache.qpid.codec

Class AMQDecoder<T extends MethodProcessor>

java.lang.Object

org.apache.qpid.codec.AMQDecoder<T>

Direct Known Subclasses:

ClientDecoder

public abstract class AMQDecoder<T extends MethodProcessor>
extends Object

AMQDecoder delegates the decoding of AMQP either to a data block decoder, or in the case of new connections, to a protocol initiation decoder. It is a cumulative decoder, which means that it can accumulate data to decode in the buffer until there is enough data to decode.

One instance of this class is created per session, so any changes or configuration done at run time to the decoder will only affect decoding of the protocol session data to which is it bound.

TODO If protocol initiation decoder not needed, then don't create it. Probably not a big deal, but it adds to the per-session overhead.

Field Summary

Fields

Modifier and Type	Field and Description
static int	FRAME_HEADER_SIZE
static int	FRAME_MIN_SIZE

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AMQDecoder(boolean expectProtocolInitiation, T methodProcessor) Creates a new AMQP decoder.

Method Summary

Methods

Modifier and Type	Method and Description
protected int	decodable(ByteBuffer in)
protected int	decode(ByteBuffer buf)
T	getMethodProcessor()
protected int	processAMQPFrames(ByteBuffer buf)
protected void	processFrame(int channel, byte type, long bodySize, ByteBuffer in)
protected void	processInput(ByteBuffer in)
void	setExpectProtocolInitiation(boolean expectProtocolInitiation) Sets the protocol initation flag, that determines whether decoding is handled by the data decoder of the protocol initation decoder.
void	setMaxFrameSize(int frameMax)

Methods inherited from class java.lang.Object

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

Field Detail

FRAME_HEADER_SIZE

public static final int FRAME_HEADER_SIZE

See Also:

Constant Field Values

FRAME_MIN_SIZE

public static final int FRAME_MIN_SIZE

See Also:

Constant Field Values

Constructor Detail

AMQDecoder

protected AMQDecoder(boolean expectProtocolInitiation,
          T methodProcessor)

Creates a new AMQP decoder.

Parameters:

expectProtocolInitiation - true if this decoder needs to handle protocol initiation.

methodProcessor - method processor

Method Detail

setExpectProtocolInitiation

public void setExpectProtocolInitiation(boolean expectProtocolInitiation)

Sets the protocol initation flag, that determines whether decoding is handled by the data decoder of the protocol initation decoder. This method is expected to be called with false once protocol initation completes.

Parameters:

expectProtocolInitiation - true to use the protocol initiation decoder, false to use the data decoder.

setMaxFrameSize

public void setMaxFrameSize(int frameMax)

getMethodProcessor

public T getMethodProcessor()

decode

protected final int decode(ByteBuffer buf)
                    throws AMQFrameDecodingException

Throws:

AMQFrameDecodingException

processAMQPFrames

protected int processAMQPFrames(ByteBuffer buf)
                         throws AMQFrameDecodingException

Throws:

AMQFrameDecodingException

decodable

protected int decodable(ByteBuffer in)
                 throws AMQFrameDecodingException

Throws:

AMQFrameDecodingException

processInput

protected void processInput(ByteBuffer in)
                     throws AMQFrameDecodingException,
                            AMQProtocolVersionException

Throws:

AMQFrameDecodingException

AMQProtocolVersionException

processFrame

protected void processFrame(int channel,
                byte type,
                long bodySize,
                ByteBuffer in)
                     throws AMQFrameDecodingException

Throws:

AMQFrameDecodingException