org.djutils.serialization

Class ObjectArraySerializer<E>

java.lang.Object

org.djutils.serialization.BasicSerializer<T>

org.djutils.serialization.ArrayOrMatrixSerializer<E[],E>

org.djutils.serialization.ObjectArraySerializer<E>

Type Parameters:

E - class of the element object

All Implemented Interfaces:

Serializer<E[]>

public abstract class ObjectArraySerializer<E>
extends ArrayOrMatrixSerializer<E[],E>

Serializer for Object array classes.

Copyright (c) 2019-2019 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See OpenTrafficSim License.

Version:

$Revision$, $LastChangedDate$, by $Author$,

Author:

Alexander Verbraeck, Peter Knoppers, Wouter Schakel

Constructor Summary

Constructors

Constructor and Description
ObjectArraySerializer(byte type, int dataSize, E sample, String dataClassName) Construct a new ObjectArraySerializer.

Method Summary

Modifier and Type	Method and Description
E[]	deSerialize(byte[] buffer, Pointer pointer, EndianUtil endianUtil) Deserialize an object of type T.
void	serialize(E[] array, byte[] buffer, Pointer pointer, EndianUtil endianUtil) Serialize an object of type T; not including the prefix byte(s).
void	serializeWithPrefix(E[] array, byte[] buffer, Pointer pointer, EndianUtil endianUtil) Serialize an object of type T including the prefix byte(s).
int	size(E[] array) Compute the number of bytes needed to serialize an object of type T (excluding the byte(s) that indicate that an object of type T is next in the data stream).
int	sizeWithPrefix(E[] array) Compute the number of bytes needed to serialize an object of type T (including the byte(s) that indicate that an object of type T is next in the data stream).

Methods inherited from class org.djutils.serialization.ArrayOrMatrixSerializer

deSerializeElement, getElementSize, getNumberOfDimensions, serializeElement

Methods inherited from class org.djutils.serialization.BasicSerializer

dataClassName, fieldType, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

ObjectArraySerializer

public ObjectArraySerializer(byte type,
                             int dataSize,
                             E sample,
                             String dataClassName)

Construct a new ObjectArraySerializer.

Parameters:

type - byte; the field type (returned by the fieldType method)

dataSize - int; the number of bytes needed to encode one additional array element

sample - T[]; sample object (can be zero length array).

dataClassName - String; returned by the dataClassName method

Method Detail

size

public final int size(E[] array)

Description copied from interface: Serializer

Compute the number of bytes needed to serialize an object of type T (excluding the byte(s) that indicate that an object of type T is next in the data stream).

Parameters:

array - Object; Instance of the object (should be of type T)

Returns:

int; the number of bytes needed to serialize an object of type T

sizeWithPrefix

public final int sizeWithPrefix(E[] array)

Description copied from interface: Serializer

Compute the number of bytes needed to serialize an object of type T (including the byte(s) that indicate that an object of type T is next in the data stream).

Parameters:

array - Instance of the object (should be instance of T)

Returns:

int; the number of bytes needed to serialize an object of type T

serializeWithPrefix

public final void serializeWithPrefix(E[] array,
                                      byte[] buffer,
                                      Pointer pointer,
                                      EndianUtil endianUtil)
                               throws SerializationException

Description copied from interface: Serializer

Serialize an object of type T including the prefix byte(s).

Parameters:

array - Object; the object to serialize (should be of type T)

buffer - byte[]; buffer for the serialized T

pointer - Pointer; position in buffer where the first byte of the serialized T will be stored

endianUtil - EndianUtil; selects bigEndian or littleEndian encoding

Throws:

SerializationException - when a matrix has size zero or is jagged

serialize

public final void serialize(E[] array,
                            byte[] buffer,
                            Pointer pointer,
                            EndianUtil endianUtil)

Description copied from interface: Serializer

Serialize an object of type T; not including the prefix byte(s).

Parameters:

array - Object; the object to serialize (should be of type T)

buffer - byte[]; buffer for the serialized T

pointer - Pointer; position in buffer where the first byte of the serialized T will be stored

endianUtil - EndianUtil; selects bigEndian or littleEndian encoding

deSerialize

public final E[] deSerialize(byte[] buffer,
                             Pointer pointer,
                             EndianUtil endianUtil)

Description copied from interface: Serializer

Deserialize an object of type T. The pointer should be on the first byte of the object; i.e. just after the prefix byte.

Parameters:

buffer - byte[]; the bytes with serialized data that must be reconstructed into a T

pointer - Pointer; position in the buffer where the first byte of the serialized T is located

endianUtil - EndianUtil; selects bigEndian or littleEndian encoding

Returns:

T; a T object constructed from the data in the buffer