Package it.unimi.di.law.bubing.sieve

Interface ByteSerializerDeserializer<V>

All Known Implementing Classes:

ByteArrayListByteSerializerDeserializer, CharSequenceByteSerializerDeserializer

public interface ByteSerializerDeserializer<V>

A light for of serialization based on InputStream/OutputStream (and FastBufferedInputStream for fast skipping).

Field Summary

Fields

Modifier and Type	Field	Description
static ByteSerializerDeserializer<byte[]>	BYTE_ARRAY	A serializer-deserializer for byte arrays that write the array length using variable-length byte encoding, and the writes the content of the array.
static ByteSerializerDeserializer<java.lang.Integer>	INTEGER	A trivial serializer-deserializer for Integer.
static ByteSerializerDeserializer<java.lang.Void>	VOID	A NOP-serializer-deserializer for Void (only for values).

Method Summary

Modifier and Type	Method	Description
V	fromStream(java.io.InputStream is)	Deserializes an object starting from a given portion of a byte array.
void	skip(FastBufferedInputStream is)	Skip an object, usually without deserializing it.
void	toStream(V v, java.io.OutputStream os)	Serializes an object starting from a given offset of a byte array.

Field Detail

VOID

static final ByteSerializerDeserializer<java.lang.Void> VOID

A NOP-serializer-deserializer for Void (only for values).

INTEGER

static final ByteSerializerDeserializer<java.lang.Integer> INTEGER

A trivial serializer-deserializer for Integer.

BYTE_ARRAY

static final ByteSerializerDeserializer<byte[]> BYTE_ARRAY

A serializer-deserializer for byte arrays that write the array length using variable-length byte encoding, and the writes the content of the array.

Method Detail

fromStream

V fromStream(java.io.InputStream is)
      throws java.io.IOException

Deserializes an object starting from a given portion of a byte array.

Parameters:

is - the input stream from which the object will be deserialized.

Returns:

a new object, deserialized from the given portion of the array.

Throws:

java.io.IOException

toStream

void toStream(V v,
              java.io.OutputStream os)
       throws java.io.IOException

Serializes an object starting from a given offset of a byte array.

Parameters:

v - the object to be serialized.

os - the output stream that will receive the serialized object.

Throws:

java.io.IOException

skip

void skip(FastBufferedInputStream is)
   throws java.io.IOException

Skip an object, usually without deserializing it.

Note that this method requires explicitly a FastBufferedInputStream. As a result, you can safely use skip() to skip the number of bytes required (see the documentation of FastBufferedInputStream.skip(long) for some elaboration).

Calling this method must be equivalent to calling fromStream(InputStream) and discarding the result.

Parameters:

is - the fast buffered input stream from which the next object will be skipped.

Throws:

java.io.IOException