org.djutils.serialization.serializers.BasicPrimitiveArrayOrMatrixSerializer Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of djutils-serialization Show documentation

DJUTILS serialization of data structures

There is a newer version: 2.2.2

Show newest version

package org.djutils.serialization.serializers;

import org.djutils.serialization.EndianUtil;
import org.djutils.serialization.SerializationException;

/**
 * Serializer for primitive data array classes. *
 * 
 * Copyright (c) 2019-2024 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved. 

 * BSD-style license. See DJUTILS License.
 * 
 * @author Alexander Verbraeck
 * @author Peter Knoppers
 * @param  array type, e.g. int[]
 */
public abstract class BasicPrimitiveArrayOrMatrixSerializer extends BasicSerializer
{
    /** Size of one element of the encoded data. */
    private final int elementSize;

    /** Number of dimensions of the data. */
    private final int numberOfDimensions;

    /**
     * Construct a new BasicPrimitiveArrayOrMatrixSerializer.
     * @param type byte; the field type (returned by the fieldType method)
     * @param elementSize int; the number of bytes needed to encode one additional array element
     * @param dataClassName String; returned by the dataClassName method
     * @param numberOfDimensions int; number of dimensions (1 for array, 2 for matrix)
     */
    public BasicPrimitiveArrayOrMatrixSerializer(final byte type, final int elementSize, final String dataClassName,
            final int numberOfDimensions)
    {
        super(type, dataClassName);
        this.elementSize = elementSize;
        this.numberOfDimensions = numberOfDimensions;
    }

    @Override
    public final int sizeWithPrefix(final T object) throws SerializationException
    {
        return 1 + size(object);
    }

    @Override
    public final void serializeWithPrefix(final T object, final byte[] buffer, final Pointer pointer,
            final EndianUtil endianUtil) throws SerializationException
    {
        buffer[pointer.getAndIncrement(1)] = fieldType();
        serialize(object, buffer, pointer, endianUtil);
    }

    /**
     * Retrieve the number of bytes needed to encode one additional array element.
     * @return int; the number of bytes needed to encode one additional array element
     */
    public final int getElementSize()
    {
        return this.elementSize;
    }

    @Override
    public final int getNumberOfDimensions()
    {
        return this.numberOfDimensions;
    }

}