Module org.apache.qpid.protonj2

Package org.apache.qpid.protonj2.codec.decoders.primitives

Class AbstractBinaryTypeDecoder

java.lang.Object

org.apache.qpid.protonj2.codec.decoders.AbstractPrimitiveTypeDecoder<Binary>

org.apache.qpid.protonj2.codec.decoders.primitives.AbstractBinaryTypeDecoder

All Implemented Interfaces:

BinaryTypeDecoder, PrimitiveTypeDecoder<Binary>, StreamTypeDecoder<Binary>, TypeDecoder<Binary>

Direct Known Subclasses:

Binary32TypeDecoder, Binary8TypeDecoder

public abstract class AbstractBinaryTypeDecoder
extends AbstractPrimitiveTypeDecoder<Binary>
implements BinaryTypeDecoder

Base class for the various Binary type decoders used to read AMQP Binary values.

Constructor Summary

Constructors

Constructor	Description
AbstractBinaryTypeDecoder()

Method Summary

Modifier and Type	Method	Description
Binary	readValue(InputStream stream, StreamDecoderState state)	Reads the next type from the given buffer and returns it.
Binary	readValue(ProtonBuffer buffer, DecoderState state)	Reads the next type from the given buffer and returns it.
byte[]	readValueAsArray(InputStream stream, StreamDecoderState state)	Read and decode an AMQP Binary into a byte array instance and return it.
byte[]	readValueAsArray(ProtonBuffer buffer, DecoderState state)	Read and decode an AMQP Binary into a byte array instance and return it.
ProtonBuffer	readValueAsBuffer(InputStream stream, StreamDecoderState state)	Read and decode an AMQP Binary into a ProtonBuffer instance and return it.
ProtonBuffer	readValueAsBuffer(ProtonBuffer buffer, DecoderState state)	Read and decode an AMQP Binary into a ProtonBuffer instance and return it.
void	skipValue(InputStream stream, StreamDecoderState state)	Skips over the bytes that compose the type this descriptor decodes.
void	skipValue(ProtonBuffer buffer, DecoderState state)	Skips over the bytes that compose the type this descriptor decodes.

Methods inherited from class org.apache.qpid.protonj2.codec.decoders.AbstractPrimitiveTypeDecoder

isArrayType, isJavaPrimitive, isNull, readArrayElements, readArrayElements

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.qpid.protonj2.codec.decoders.primitives.BinaryTypeDecoder

getTypeClass

Methods inherited from interface org.apache.qpid.protonj2.codec.decoders.PrimitiveTypeDecoder

getTypeCode, isJavaPrimitive, isPrimitive, isZeroWidth, readPrimitiveArray, readPrimitiveArray

Methods inherited from interface org.apache.qpid.protonj2.codec.StreamTypeDecoder

getTypeClass, isArrayType, isNull, readArrayElements, readSize

Methods inherited from interface org.apache.qpid.protonj2.codec.TypeDecoder

isArrayType, isNull, readArrayElements, readSize

Constructor Details

AbstractBinaryTypeDecoder

public AbstractBinaryTypeDecoder()

Method Details

readValue

public Binary readValue(ProtonBuffer buffer,
 DecoderState state)
                 throws DecodeException

Description copied from interface: TypeDecoder

Reads the next type from the given buffer and returns it.

Specified by:

readValue in interface TypeDecoder<Binary>

Parameters:

buffer - the source of encoded data.

state - the current state of the decoder.

Returns:

the next instance in the stream that this decoder handles.

Throws:

DecodeException - if an error is encountered while reading the next value.

readValueAsBuffer

public ProtonBuffer readValueAsBuffer(ProtonBuffer buffer,
 DecoderState state)
                               throws DecodeException

Read and decode an AMQP Binary into a ProtonBuffer instance and return it.

Specified by:

readValueAsBuffer in interface BinaryTypeDecoder

Parameters:

buffer - The ProtonBuffer where the Binary encoding should be read from.

state - The EncoderState that can be used when reading the encoded value.

Returns:

the bytes that comprise the encoded Binary wrapped in a ProtonBuffer instance.

Throws:

DecodeException - if an error occurs while reading the Binary value.

readValueAsArray

public byte[] readValueAsArray(ProtonBuffer buffer,
 DecoderState state)
                        throws DecodeException

Read and decode an AMQP Binary into a byte array instance and return it.

Specified by:

readValueAsArray in interface BinaryTypeDecoder

Parameters:

buffer - The ProtonBuffer where the Binary encoding should be read from.

state - The EncoderState that can be used when reading the encoded value.

Returns:

the bytes that comprise the encoded Binary copied into a byte array instance.

Throws:

DecodeException - if an error occurs while reading the Binary value.

skipValue

public void skipValue(ProtonBuffer buffer,
 DecoderState state)
               throws DecodeException

Description copied from interface: TypeDecoder

Skips over the bytes that compose the type this descriptor decodes.

Skipping values can be used when the type is not used or processed by the application doing the decoding. An example might be an AMQP message decoder that only needs to decode certain parts of the message and not others.

Specified by:

skipValue in interface TypeDecoder<Binary>

Parameters:

buffer - The buffer that contains the encoded type.

state - The decoder state.

Throws:

DecodeException - if an error occurs while skipping the value.

readValue

public Binary readValue(InputStream stream,
 StreamDecoderState state)
                 throws DecodeException

Description copied from interface: StreamTypeDecoder

Reads the next type from the given buffer and returns it.

Specified by:

readValue in interface StreamTypeDecoder<Binary>

Parameters:

stream - the source of encoded data.

state - the current state of the decoder.

Returns:

the next instance in the stream that this decoder handles.

Throws:

DecodeException - if an error is encountered while reading the next value.

readValueAsBuffer

public ProtonBuffer readValueAsBuffer(InputStream stream,
 StreamDecoderState state)
                               throws DecodeException

Read and decode an AMQP Binary into a ProtonBuffer instance and return it.

Specified by:

readValueAsBuffer in interface BinaryTypeDecoder

Parameters:

stream - The InputStream where the Binary encoding should be read from.

state - The EncoderState that can be used when reading the encoded value.

Returns:

the bytes that comprise the encoded Binary wrapped in a ProtonBuffer instance.

Throws:

DecodeException - if an error occurs while reading the Binary value.

readValueAsArray

public byte[] readValueAsArray(InputStream stream,
 StreamDecoderState state)
                        throws DecodeException

Read and decode an AMQP Binary into a byte array instance and return it.

Specified by:

readValueAsArray in interface BinaryTypeDecoder

Parameters:

stream - The InputStream where the Binary encoding should be read from.

state - The EncoderState that can be used when reading the encoded value.

Returns:

the bytes that comprise the encoded Binary copied into a byte array instance.

Throws:

DecodeException - if an error occurs while reading the Binary value.

skipValue

public void skipValue(InputStream stream,
 StreamDecoderState state)
               throws DecodeException

Description copied from interface: StreamTypeDecoder

Skips over the bytes that compose the type this descriptor decodes.

Skipping values can be used when the type is not used or processed by the application doing the decoding. An example might be an AMQP message decoder that only needs to decode certain parts of the message and not others.

Specified by:

skipValue in interface StreamTypeDecoder<Binary>

Parameters:

stream - The stream that contains the encoded type.

state - The decoder state.

Throws:

DecodeException - if an error occurs while skipping the value.