io.permazen.core.type

Class EnumFieldType

java.lang.Object

io.permazen.core.FieldType<T>

io.permazen.core.type.NullSafeType<EnumValue>

io.permazen.core.type.EnumFieldType

All Implemented Interfaces:

Serializable, Comparator<EnumValue>

public class EnumFieldType
extends NullSafeType<EnumValue>

The FieldType for EnumValue, which is the data type used by EnumField.

Each EnumFieldType instance has an ordered list of String identifiers; two EnumFieldType instances are not compatible unless they have identical identifier lists. The identifiers must be valid Java identifiers.

Note that whatever Enum type may be used to represent values at the Java layer is unimportant; only the ordered list of identifiers matters.

Null values are supported by this class.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static String	IDENT_PATTERN

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

inner, NOT_NULL_SENTINEL, NULL_SENTINEL

Fields inherited from class io.permazen.core.FieldType

name, NAME_PATTERN, REFERENCE_TYPE_NAME, signature, typeToken

Constructor Summary

Constructors

Constructor and Description
EnumFieldType(Class<T> enumType) Constructor that derives the type name and identifier list from the given Enum type.
EnumFieldType(List<String> idents) Primary constructor.

Method Summary

Modifier and Type	Method and Description
List<String>	getIdentifiers() Get the identifiers associated with this instance in ordinal order.
static Map<String,EnumValue>	validateIdentifiers(List<String> idents) Validate a list of enum identifiers and build a mapping from identifier to corresponding EnumValue.

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

compare, convert, equals, fromParseableString, fromString, genericizeForIndex, getInnerType, hashCode, hasPrefix0x00, hasPrefix0xff, read, skip, toParseableString, toString, write

Methods inherited from class io.permazen.core.FieldType

getDefaultValue, getDefaultValueObject, getEncodingSignature, getKeyRange, getName, getTypeToken, toString, validate, 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

Field Detail

IDENT_PATTERN

public static final String IDENT_PATTERN

See Also:

Constant Field Values

Constructor Detail

EnumFieldType

public EnumFieldType(Class<T> enumType)

Constructor that derives the type name and identifier list from the given Enum type.

Type Parameters:

T - enum type

Parameters:

enumType - Java Enum type from which to derive type name and ordered identifier list

Throws:

NullPointerException - if enumType is null

EnumFieldType

public EnumFieldType(List<String> idents)

Primary constructor.

Parameters:

idents - ordered list of identifiers

Throws:

IllegalArgumentException - if name is null or invalid

IllegalArgumentException - if idents is null or contains a duplicate or invalid identifier

Method Detail

getIdentifiers

public List<String> getIdentifiers()

Get the identifiers associated with this instance in ordinal order.

Returns:

unmodifiable, ordinally ordered list of identifiers

validateIdentifiers

public static Map<String,EnumValue> validateIdentifiers(List<String> idents)

Validate a list of enum identifiers and build a mapping from identifier to corresponding EnumValue. The returned mapping will iterate the EnumValues in ordinal order.

Parameters:

idents - enum identifiers

Returns:

ordinally ordered mapping from identifier to EnumValue

Throws:

IllegalArgumentException - if idents is null

IllegalArgumentException - if any identifier in idents is null, duplicate, or not a valid Java identifier