org.msgpack.core

Class MessageUnpacker

java.lang.Object

org.msgpack.core.MessageUnpacker

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

public class MessageUnpacker
extends java.lang.Object
implements java.io.Closeable

MessageUnpacker lets an application read message-packed values from a data stream. The application needs to call getNextFormat() followed by an appropriate unpackXXX method according to the the returned format type.

 
     MessageUnpacker unpacker = MessagePack.newDefaultUnpacker(...);
     while(unpacker.hasNext()) {
         MessageFormat f = unpacker.getNextFormat();
         switch(f) {
             case MessageFormat.POSFIXINT:
             case MessageFormat.INT8:
             case MessageFormat.UINT8: {
                int v = unpacker.unpackInt();
                break;
             }
             case MessageFormat.STRING: {
                String v = unpacker.unpackString();
                break;
             }
             // ...
       }
     }

 
 

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	MessageUnpacker(MessageBufferInput in, MessagePack.UnpackerConfig config) Create an MessageUnpacker that reads data from the given MessageBufferInput.

Method Summary

Modifier and Type	Method and Description
void	close()
MessageFormat	getNextFormat() Returns the next MessageFormat type.
long	getTotalReadBytes()
boolean	hasNext() Returns true true if this unpacker has more elements.
void	readPayload(byte[] dst)
void	readPayload(byte[] dst, int off, int len) Read up to len bytes of data into the destination array
void	readPayload(java.nio.ByteBuffer dst)
byte[]	readPayload(int length)
MessageBuffer	readPayloadAsReference(int length)
MessageBufferInput	reset(MessageBufferInput in) Reset input.
void	skipValue() Skip the next value, then move the cursor at the end of the value
void	skipValue(int count) Skip next values, then move the cursor at the end of the value
int	unpackArrayHeader()
java.math.BigInteger	unpackBigInteger()
int	unpackBinaryHeader()
boolean	unpackBoolean()
byte	unpackByte()
double	unpackDouble()
ExtensionTypeHeader	unpackExtensionTypeHeader()
float	unpackFloat()
int	unpackInt()
long	unpackLong()
int	unpackMapHeader()
void	unpackNil()
int	unpackRawStringHeader()
short	unpackShort()
java.lang.String	unpackString()
ImmutableValue	unpackValue()
Variable	unpackValue(Variable var)

Methods inherited from class java.lang.Object

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

Constructor Detail

MessageUnpacker

protected MessageUnpacker(MessageBufferInput in,
                          MessagePack.UnpackerConfig config)

Create an MessageUnpacker that reads data from the given MessageBufferInput. This method is available for subclasses to override. Use MessagePack.UnpackerConfig.newUnpacker method to instanciate this implementation.

Parameters:

in -

Method Detail

reset

public MessageBufferInput reset(MessageBufferInput in)
                         throws java.io.IOException

Reset input. This method doesn't close the old resource.

Parameters:

in - new input

Returns:

the old resource

Throws:

java.io.IOException

getTotalReadBytes

public long getTotalReadBytes()

hasNext

public boolean hasNext()
                throws java.io.IOException

Returns true true if this unpacker has more elements. When this returns true, subsequent call to getNextFormat() returns an MessageFormat instance. If false, next getNextFormat() call will throw an MessageInsufficientBufferException.

Returns:

true if this unpacker has more elements to read

Throws:

java.io.IOException

getNextFormat

public MessageFormat getNextFormat()
                            throws java.io.IOException

Returns the next MessageFormat type. This method should be called after hasNext() returns true. If hasNext() returns false, calling this method throws MessageInsufficientBufferException.

This method does not proceed the internal cursor.

Returns:

the next MessageFormat

Throws:

java.io.IOException - when failed to read the input data.

MessageInsufficientBufferException - when the end of file reached, i.e. hasNext() == false.

skipValue

public void skipValue()
               throws java.io.IOException

Skip the next value, then move the cursor at the end of the value

Throws:

java.io.IOException

skipValue

public void skipValue(int count)
               throws java.io.IOException

Skip next values, then move the cursor at the end of the value

Parameters:

count - number of values to skip

Throws:

java.io.IOException

unpackValue

public ImmutableValue unpackValue()
                           throws java.io.IOException

Throws:

java.io.IOException

unpackValue

public Variable unpackValue(Variable var)
                     throws java.io.IOException

Throws:

java.io.IOException

unpackNil

public void unpackNil()
               throws java.io.IOException

Throws:

java.io.IOException

unpackBoolean

public boolean unpackBoolean()
                      throws java.io.IOException

Throws:

java.io.IOException

unpackByte

public byte unpackByte()
                throws java.io.IOException

Throws:

java.io.IOException

unpackShort

public short unpackShort()
                  throws java.io.IOException

Throws:

java.io.IOException

unpackInt

public int unpackInt()
              throws java.io.IOException

Throws:

java.io.IOException

unpackLong

public long unpackLong()
                throws java.io.IOException

Throws:

java.io.IOException

unpackBigInteger

public java.math.BigInteger unpackBigInteger()
                                      throws java.io.IOException

Throws:

java.io.IOException

unpackFloat

public float unpackFloat()
                  throws java.io.IOException

Throws:

java.io.IOException

unpackDouble

public double unpackDouble()
                    throws java.io.IOException

Throws:

java.io.IOException

unpackString

public java.lang.String unpackString()
                              throws java.io.IOException

Throws:

java.io.IOException

unpackArrayHeader

public int unpackArrayHeader()
                      throws java.io.IOException

Throws:

java.io.IOException

unpackMapHeader

public int unpackMapHeader()
                    throws java.io.IOException

Throws:

java.io.IOException

unpackExtensionTypeHeader

public ExtensionTypeHeader unpackExtensionTypeHeader()
                                              throws java.io.IOException

Throws:

java.io.IOException

unpackRawStringHeader

public int unpackRawStringHeader()
                          throws java.io.IOException

Throws:

java.io.IOException

unpackBinaryHeader

public int unpackBinaryHeader()
                       throws java.io.IOException

Throws:

java.io.IOException

readPayload

public void readPayload(java.nio.ByteBuffer dst)
                 throws java.io.IOException

Throws:

java.io.IOException

readPayload

public void readPayload(byte[] dst)
                 throws java.io.IOException

Throws:

java.io.IOException

readPayload

public byte[] readPayload(int length)
                   throws java.io.IOException

Throws:

java.io.IOException

readPayload

public void readPayload(byte[] dst,
                        int off,
                        int len)
                 throws java.io.IOException

Read up to len bytes of data into the destination array

Parameters:

dst - the buffer into which the data is read

off - the offset in the dst array

len - the number of bytes to read

Throws:

java.io.IOException

readPayloadAsReference

public MessageBuffer readPayloadAsReference(int length)
                                     throws java.io.IOException

Throws:

java.io.IOException

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Throws:

java.io.IOException