com.yahoo.sketches

Class ArrayOfItemsSerDe<T>

java.lang.Object

com.yahoo.sketches.ArrayOfItemsSerDe<T>

Type Parameters:

T - Type of item

Direct Known Subclasses:

ArrayOfDoublesSerDe, ArrayOfLongsSerDe, ArrayOfNumbersSerDe, ArrayOfStringsSerDe, ArrayOfUtf16StringsSerDe

public abstract class ArrayOfItemsSerDe<T>
extends Object

Base class for serializing and deserializing custom types.

Author:

Alexander Saydakov

Constructor Summary

Constructors

Constructor and Description
ArrayOfItemsSerDe()

Method Summary

Modifier and Type	Method and Description
abstract T[]	deserializeFromMemory(Memory mem, int numItems) Deserialize an array of items from a given Memory object.
short	getId() Deprecated.
abstract byte[]	serializeToByteArray(T[] items) Serialize an array of items to byte array.

Methods inherited from class java.lang.Object

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

Constructor Detail

ArrayOfItemsSerDe

public ArrayOfItemsSerDe()

Method Detail

serializeToByteArray

public abstract byte[] serializeToByteArray(T[] items)

Serialize an array of items to byte array. The size of the array doesn't need to be serialized. This method is called by the sketch serialization process.

Parameters:

items - array of items to be serialized

Returns:

serialized representation of the given array of items

deserializeFromMemory

public abstract T[] deserializeFromMemory(Memory mem,
                                          int numItems)

Deserialize an array of items from a given Memory object. This method is called by the sketch deserialization process.

Parameters:

mem - Memory containing a serialized array of items

numItems - number of items in the serialized array

Returns:

deserialized array of items

getId

@Deprecated
public short getId()

Deprecated.

Provides a simple mechanism to check compatibility between SerDe implementations.

You will need to override this in the following cases:

• If you want to rename the class or change its package hierarchy and keep the ID the same. This enables compatible deserialization of binary images that were serialized with a different class name or package hierarchy.
• If you wish to change the binary layout of the serialization and don't want to change the class name or package hierarchy, you will need to change the returned code.

Returns:

a unique identifier of this SerDe