Package org.djutils.serialization.serializers

Class BasicPrimitiveArrayOrMatrixSerializer<T>

java.lang.Object

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

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

Type Parameters:

T - array type, e.g. int[]

All Implemented Interfaces:

Serializer<T>

public abstract class BasicPrimitiveArrayOrMatrixSerializer<T>
extends BasicSerializer<T>

Serializer for primitive data array classes. *

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

Author:

Alexander Verbraeck, Peter Knoppers

Constructor Summary

Constructors

Constructor	Description
BasicPrimitiveArrayOrMatrixSerializer(byte type, int elementSize, String dataClassName, int numberOfDimensions)	Construct a new BasicPrimitiveArrayOrMatrixSerializer.

Method Summary

Modifier and Type	Method	Description
final int	getElementSize()	Retrieve the number of bytes needed to encode one additional array element.
final int	getNumberOfDimensions()	Return the number of dimensions of the stored data.
final void	serializeWithPrefix(T object, byte[] buffer, Pointer pointer, Endianness endianness)	Serialize an object of type T including the prefix byte(s).
final int	sizeWithPrefix(T object)	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.BasicSerializer

dataClassName, fieldType, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.djutils.serialization.serializers.Serializer

deSerialize, hasUnit, serialize, size

Constructor Details

BasicPrimitiveArrayOrMatrixSerializer

public BasicPrimitiveArrayOrMatrixSerializer(byte type,
 int elementSize,
 String dataClassName,
 int numberOfDimensions)

Construct a new BasicPrimitiveArrayOrMatrixSerializer.

Parameters:

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

elementSize - the number of bytes needed to encode one additional array element

dataClassName - returned by the dataClassName method

numberOfDimensions - number of dimensions (1 for array, 2 for matrix)

Method Details

sizeWithPrefix

public final int sizeWithPrefix(T object)
                         throws SerializationException

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:

object - Instance of the object

Returns:

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

Throws:

SerializationException - when the object cannot be serialized

serializeWithPrefix

public final void serializeWithPrefix(T object,
 byte[] buffer,
 Pointer pointer,
 Endianness endianness)
                               throws SerializationException

Description copied from interface: Serializer

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

Parameters:

object - the object to serialize

buffer - buffer for the serialized T

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

endianness - selects bigEndian or littleEndian encoding

Throws:

SerializationException - when a matrix has size zero or is jagged

getElementSize

public final int getElementSize()

Retrieve the number of bytes needed to encode one additional array element.

Returns:

the number of bytes needed to encode one additional array element

getNumberOfDimensions

public final int getNumberOfDimensions()

Description copied from interface: Serializer

Return the number of dimensions of the stored data.

Returns:

0 for plain data, 1 for array, 2 for matrix