io.permazen.core.type

Class ObjectArrayType<E>

java.lang.Object

io.permazen.core.FieldType<T>

io.permazen.core.type.NonNullFieldType<T>

io.permazen.core.type.ArrayType<E[],E>

io.permazen.core.type.ObjectArrayType<E>

Type Parameters:

E - array element type

All Implemented Interfaces:

Serializable, Comparator<E[]>

public class ObjectArrayType<E>
extends ArrayType<E[],E>

Array type for object arrays having non-primitive element types. Does not support null arrays.

In the binary encoding, array elements are simply concatenated, with each element preceded by a 0x01 byte. After the last element, a final 0x00 byte follows. This encoding ensures lexicographic ordering.

See Also:

Serialized Form

Field Summary

Fields inherited from class io.permazen.core.type.ArrayType

ARRAY_SUFFIX, MAX_DIMENSIONS

Fields inherited from class io.permazen.core.FieldType

name, NAME_PATTERN, REFERENCE_TYPE_NAME, signature, typeToken

Constructor Summary

Constructors

Constructor and Description
ObjectArrayType(FieldType<E> elementType)

Method Summary

Modifier and Type	Method and Description
protected E[]	createArray(List<E> elements) Create a new array instance containing the given elements.
protected E	getArrayElement(E[] array, int index) Get an element from the given array.
protected int	getArrayLength(E[] array) Get the length of the given array.
E[]	read(ByteReader reader) Read a value from the given input.
void	skip(ByteReader reader) Read and discard a value from the given input.
void	write(ByteWriter writer, E[] array) Write a value to the given output.

Methods inherited from class io.permazen.core.type.ArrayType

compare, convert, equals, fromParseableString, getDimensions, hashCode, toParseableString

Methods inherited from class io.permazen.core.type.NonNullFieldType

validate

Methods inherited from class io.permazen.core.FieldType

fromString, genericizeForIndex, getDefaultValue, getDefaultValueObject, getEncodingSignature, getKeyRange, getName, getTypeToken, hasPrefix0x00, hasPrefix0xff, toString, toString, validateAndWrite

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Comparator

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

Constructor Detail

ObjectArrayType

public ObjectArrayType(FieldType<E> elementType)

Method Detail

read

public E[] read(ByteReader reader)

Description copied from class: FieldType

Read a value from the given input.

Specified by:

read in class FieldType<E[]>

Parameters:

reader - byte input

Returns:

field value (possibly null)

write

public void write(ByteWriter writer,
                  E[] array)

Description copied from class: FieldType

Write a value to the given output.

Specified by:

write in class FieldType<E[]>

Parameters:

writer - byte output

array - value to write (possibly null)

skip

public void skip(ByteReader reader)

Description copied from class: FieldType

Read and discard a value from the given input.

Specified by:

skip in class FieldType<E[]>

Parameters:

reader - byte input

getArrayLength

protected int getArrayLength(E[] array)

Description copied from class: ArrayType

Get the length of the given array.

Specified by:

getArrayLength in class ArrayType<E[],E>

Parameters:

array - non-null array

Returns:

array length

getArrayElement

protected E getArrayElement(E[] array,
                            int index)

Description copied from class: ArrayType

Get an element from the given array.

Specified by:

getArrayElement in class ArrayType<E[],E>

Parameters:

array - non-null array

index - index of target element in array

Returns:

array element at index index

createArray

protected E[] createArray(List<E> elements)

Description copied from class: ArrayType

Create a new array instance containing the given elements.

Specified by:

createArray in class ArrayType<E[],E>

Parameters:

elements - content for the new array

Returns:

newly created array