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-2020 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 Details

    • 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 Details

    • 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