de.haumacher.msgbuf.binary

Interface DataReader

All Known Implementing Classes:

OctetDataReader

public interface DataReader

Output interface for creating binary messages out of data objects.

A message constructed by a DataWriter may only contain object at top-level. Therefore the first call to an instance of DataReader must be beginObject().

See Also:

DataWriter

Method Summary

Modifier and Type	Method and Description
int	beginArray() Starts reading an array.
void	beginObject() Starts reading an object.
void	endArray() Finishes reading the array started with beginArray().
void	endObject() Finishes reading the object started with the last call to beginObject().
boolean	hasNext() When reading an object or array, whether there are more fields or array elements left to read.
byte[]	nextBinary() Reads a binary string value.
default boolean	nextBoolean() Reads a boolean value.
double	nextDouble() Reads a 64 bit double value.
float	nextFloat() Reads a 32 bit float value.
int	nextInt() Reads an (unsigned) integer value.
int	nextIntFixed() Reads a full 32 bit integer value.
int	nextIntSigned() Reads a signed integer value.
long	nextLong() Reads an (unsigned) long value.
long	nextLongFixed() Reads a full 64 bit long value.
long	nextLongSigned() Reads a signed long value.
int	nextName() When reading an object, retrieves the next field identifier.
String	nextString() Reads an utf-8 String value.
void	skipValue() Skips the current value to read.

Method Detail

beginObject

void beginObject()
          throws IOException

Starts reading an object.

After this call, an alternating sequence of calls to nextName() followed by a value retrieval method such as nextInt(),... nextString() followed by a final call to endObject() is expected.

Throws:

IOException

endObject

void endObject()
        throws IOException

Finishes reading the object started with the last call to beginObject().

Throws:

IOException

hasNext

boolean hasNext()
         throws IOException

When reading an object or array, whether there are more fields or array elements left to read.

Throws:

IOException

nextName

int nextName()
      throws IOException

When reading an object, retrieves the next field identifier.

Note: hasNext() must return true to be able to read the next field identifier.

Throws:

IOException

nextBoolean

default boolean nextBoolean()
                     throws IOException

Reads a boolean value.

Throws:

IOException

nextInt

int nextInt()
     throws IOException

Reads an (unsigned) integer value.

Throws:

IOException

nextIntSigned

int nextIntSigned()
           throws IOException

Reads a signed integer value.

Throws:

IOException

nextIntFixed

int nextIntFixed()
          throws IOException

Reads a full 32 bit integer value.

Throws:

IOException

nextLong

long nextLong()
       throws IOException

Reads an (unsigned) long value.

Throws:

IOException

nextLongSigned

long nextLongSigned()
             throws IOException

Reads a signed long value.

Throws:

IOException

nextLongFixed

long nextLongFixed()
            throws IOException

Reads a full 64 bit long value.

Throws:

IOException

nextFloat

float nextFloat()
         throws IOException

Reads a 32 bit float value.

Throws:

IOException

nextDouble

double nextDouble()
           throws IOException

Reads a 64 bit double value.

Throws:

IOException

nextString

String nextString()
           throws IOException

Reads an utf-8 String value.

Throws:

IOException

nextBinary

byte[] nextBinary()
           throws IOException

Reads a binary string value.

Throws:

IOException

beginArray

int beginArray()
        throws IOException

Starts reading an array.

Returns:

The number of array elements to read.

Throws:

IOException

endArray

void endArray()
       throws IOException

Finishes reading the array started with beginArray().

Throws:

IOException

skipValue

void skipValue()
        throws IOException

Skips the current value to read.

Throws:

IOException