org.mapdb.serializer

Class SerializerArrayTuple

java.lang.Object

org.mapdb.serializer.SerializerArrayTuple

All Implemented Interfaces:

java.util.Comparator<java.lang.Object[]>, Serializer<java.lang.Object[]>, GroupSerializer<java.lang.Object[]>

public class SerializerArrayTuple
extends java.lang.Object
implements GroupSerializer<java.lang.Object[]>

Serializer for tuples. It serializes fixed size array, where each array index can use different serializer. It takes array of serializes in constructor parameter. All tuples (arrays) must have the same size.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.Comparator[]	comp
protected Serializer[]	ser
protected int	size

Fields inherited from interface org.mapdb.Serializer

BIG_DECIMAL, BIG_INTEGER, BOOLEAN, BYTE, BYTE_ARRAY, BYTE_ARRAY_DELTA, BYTE_ARRAY_DELTA2, BYTE_ARRAY_NOSIZE, CHAR, CHAR_ARRAY, CLASS, DATE, DOUBLE, DOUBLE_ARRAY, ELSA, FLOAT, FLOAT_ARRAY, ILLEGAL_ACCESS, INT_ARRAY, INTEGER, INTEGER_DELTA, INTEGER_PACKED, JAVA, LONG, LONG_ARRAY, LONG_DELTA, LONG_PACKED, RECID, RECID_ARRAY, SHORT, SHORT_ARRAY, STRING, STRING_ASCII, STRING_DELTA, STRING_DELTA2, STRING_INTERN, STRING_NOSIZE, STRING_ORIGHASH, UUID

Constructor Summary

Constructors

Constructor and Description
SerializerArrayTuple(Serializer... serializers)
SerializerArrayTuple(Serializer[] serializers, java.util.Comparator[] comparators)

Method Summary

Modifier and Type	Method and Description
protected java.lang.Object[]	cast(java.lang.Object o)
int	compare(java.lang.Object[] o1, java.lang.Object[] o2)
java.lang.Object[]	deserialize(DataInput2 input, int available) Deserializes and returns the content of the given DataInput2.
boolean	equals(java.lang.Object[] a1, java.lang.Object[] a2) Returns if the first and second arguments are equal to each other.
int	hashCode(java.lang.Object[] objects, int seed) Returns a hash code of a given non-null argument.
boolean	isTrusted() Returns if this Serializer is trusted to always read the same number of bytes as it writes for any given object being serialized/de-serialized.
java.lang.Object[]	nextValue(java.lang.Object[] value) returns value+1, or null if there is no bigger value.
void	serialize(DataOutput2 out, java.lang.Object[] value) Serializes the content of the given value into the given DataOutput2.
java.lang.Object	valueArrayCopyOfRange(java.lang.Object vals, int from, int to)
java.lang.Object	valueArrayDeleteValue(java.lang.Object vals0, int pos)
java.lang.Object	valueArrayDeserialize(DataInput2 in, int size)
java.lang.Object	valueArrayEmpty()
java.lang.Object	valueArrayFromArray(java.lang.Object[] objects)
java.lang.Object[]	valueArrayGet(java.lang.Object vals, int pos)
java.lang.Object	valueArrayPut(java.lang.Object vals, int pos, java.lang.Object[] newValue)
int	valueArraySearch(java.lang.Object keys, java.lang.Object[] key)
int	valueArraySearch(java.lang.Object keys, java.lang.Object[] key, java.util.Comparator comparator)
void	valueArraySerialize(DataOutput2 out, java.lang.Object vals)
int	valueArraySize(java.lang.Object vals)
java.lang.Object	valueArrayUpdateVal(java.lang.Object vals, int pos, java.lang.Object[] newValue)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.mapdb.serializer.GroupSerializer

valueArrayBinaryGet, valueArrayBinarySearch, valueArrayToArray

Methods inherited from interface org.mapdb.Serializer

clone, deserializeFromLong, fixedSize, needsAvailableSizeHint

Methods inherited from interface java.util.Comparator

comparing, comparing, comparingDouble, comparingInt, comparingLong, equals, naturalOrder, nullsFirst, nullsLast, reversed, reverseOrder, thenComparing, thenComparing, thenComparing, thenComparingDouble, thenComparingInt, thenComparingLong

Field Detail

ser

protected final Serializer[] ser

comp

protected final java.util.Comparator[] comp

size

protected final int size

Constructor Detail

SerializerArrayTuple

public SerializerArrayTuple(Serializer[] serializers,
                            java.util.Comparator[] comparators)

SerializerArrayTuple

public SerializerArrayTuple(Serializer... serializers)

Method Detail

cast

protected java.lang.Object[] cast(java.lang.Object o)

serialize

public void serialize(@NotNull
                      DataOutput2 out,
                      @NotNull
                      java.lang.Object[] value)
               throws java.io.IOException

Description copied from interface: Serializer

Serializes the content of the given value into the given DataOutput2.

Specified by:

serialize in interface Serializer<java.lang.Object[]>

Parameters:

out - DataOutput2 to save object into

value - Object to serialize

Throws:

java.io.IOException - in case of an I/O error

deserialize

public java.lang.Object[] deserialize(@NotNull
                                      DataInput2 input,
                                      int available)
                               throws java.io.IOException

Description copied from interface: Serializer

Deserializes and returns the content of the given DataInput2.

Specified by:

deserialize in interface Serializer<java.lang.Object[]>

Parameters:

input - DataInput2 to de-serialize data from

available - how many bytes that are available in the DataInput2 for reading, may be -1 (in streams) or 0 (null).

Returns:

the de-serialized content of the given DataInput2

Throws:

java.io.IOException - in case of an I/O error

valueArraySerialize

public void valueArraySerialize(DataOutput2 out,
                                java.lang.Object vals)
                         throws java.io.IOException

Specified by:

valueArraySerialize in interface GroupSerializer<java.lang.Object[]>

Throws:

java.io.IOException

valueArrayDeserialize

public java.lang.Object valueArrayDeserialize(DataInput2 in,
                                              int size)
                                       throws java.io.IOException

Specified by:

valueArrayDeserialize in interface GroupSerializer<java.lang.Object[]>

Throws:

java.io.IOException

valueArraySearch

public int valueArraySearch(java.lang.Object keys,
                            java.lang.Object[] key)

Specified by:

valueArraySearch in interface GroupSerializer<java.lang.Object[]>

valueArraySearch

public int valueArraySearch(java.lang.Object keys,
                            java.lang.Object[] key,
                            java.util.Comparator comparator)

Specified by:

valueArraySearch in interface GroupSerializer<java.lang.Object[]>

valueArrayGet

public java.lang.Object[] valueArrayGet(java.lang.Object vals,
                                        int pos)

Specified by:

valueArrayGet in interface GroupSerializer<java.lang.Object[]>

valueArraySize

public int valueArraySize(java.lang.Object vals)

Specified by:

valueArraySize in interface GroupSerializer<java.lang.Object[]>

valueArrayEmpty

public java.lang.Object valueArrayEmpty()

Specified by:

valueArrayEmpty in interface GroupSerializer<java.lang.Object[]>

valueArrayPut

public java.lang.Object valueArrayPut(java.lang.Object vals,
                                      int pos,
                                      java.lang.Object[] newValue)

Specified by:

valueArrayPut in interface GroupSerializer<java.lang.Object[]>

valueArrayUpdateVal

public java.lang.Object valueArrayUpdateVal(java.lang.Object vals,
                                            int pos,
                                            java.lang.Object[] newValue)

Specified by:

valueArrayUpdateVal in interface GroupSerializer<java.lang.Object[]>

valueArrayFromArray

public java.lang.Object valueArrayFromArray(java.lang.Object[] objects)

Specified by:

valueArrayFromArray in interface GroupSerializer<java.lang.Object[]>

valueArrayCopyOfRange

public java.lang.Object valueArrayCopyOfRange(java.lang.Object vals,
                                              int from,
                                              int to)

Specified by:

valueArrayCopyOfRange in interface GroupSerializer<java.lang.Object[]>

valueArrayDeleteValue

public java.lang.Object valueArrayDeleteValue(java.lang.Object vals0,
                                              int pos)

Specified by:

valueArrayDeleteValue in interface GroupSerializer<java.lang.Object[]>

nextValue

public java.lang.Object[] nextValue(java.lang.Object[] value)

Description copied from interface: GroupSerializer

returns value+1, or null if there is no bigger value.

Specified by:

nextValue in interface GroupSerializer<java.lang.Object[]>

equals

public boolean equals(java.lang.Object[] a1,
                      java.lang.Object[] a2)

Description copied from interface: Serializer

Returns if the first and second arguments are equal to each other. Consequently, if both arguments are null, true is returned and if exactly one argument is null, false is returned.

Specified by:

equals in interface Serializer<java.lang.Object[]>

Parameters:

a1 - an object

a2 - another object to be compared with the first object for equality

Returns:

if the first and second arguments are equal to each other

See Also:

Object.equals(Object)

compare

public int compare(java.lang.Object[] o1,
                   java.lang.Object[] o2)

Specified by:

compare in interface java.util.Comparator<java.lang.Object[]>

Specified by:

compare in interface Serializer<java.lang.Object[]>

hashCode

public int hashCode(@NotNull
                    java.lang.Object[] objects,
                    int seed)

Description copied from interface: Serializer

Returns a hash code of a given non-null argument. The output of the method is affected by the given seed, allowing protection against crafted hash attacks and to provide a better distribution of hashes.

Specified by:

hashCode in interface Serializer<java.lang.Object[]>

Parameters:

objects - an object

seed - used to "scramble" the

Returns:

a hash code of a non-null argument

See Also:

Object.hashCode()

isTrusted

public boolean isTrusted()

Description copied from interface: Serializer

Returns if this Serializer is trusted to always read the same number of bytes as it writes for any given object being serialized/de-serialized.

MapDB has a relaxed record size boundary checking. It expects deserializers to read exactly as many bytes as were written during serialization. If a deserializer reads more bytes than it wrote, it might start reading others record data in store.

Some serializers (Kryo) have problems with this. To prevent this, we can not read data directly from a store, but we must copy them into separate byte[] buffers. Thus, zero-copy optimizations are disabled by default, but can be explicitly enabled here by letting this method return true.

This flag indicates if this serializer was 'verified' to read as many bytes as it writes. It should also be much better tested etc.

Specified by:

isTrusted in interface Serializer<java.lang.Object[]>

Returns:

if this Serializer is trusted to always read the same number of bytes as it writes for any given object being serialized/de-serialized