Package org.djutils.serialization.serializers

Class ObjectArraySerializer<E>

java.lang.Object

org.djutils.serialization.serializers.BasicSerializer<T>

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

org.djutils.serialization.serializers.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-2023 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See DJUTILS License.

Version:

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

Author:

Alexander Verbraeck, Peter Knoppers

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	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.serializers.ArrayOrMatrixSerializer

deSerializeElement, getElementSize, getNumberOfDimensions, serializeElement

Methods inherited from class org.djutils.serialization.serializers.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 - E; 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 - T; Instance of the object

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 - T; Instance of the object

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 - T; the object to serialize

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 - T; the object to serialize

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