Class EnumIO<E extends Enum<E>>

java.lang.Object

io.protostuff.runtime.EnumIO<E>

All Implemented Interfaces:

PolymorphicSchema.Factory

Direct Known Subclasses:

EnumIO.ByName, EnumIO.ByNumber

public abstract class EnumIO<E extends Enum<E>>
extends Object
implements PolymorphicSchema.Factory

Determines how enums are serialized/deserialized. Default is BY_NUMBER. To enable BY_NAME, set the property "protostuff.runtime.enums_by_name=true".

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	EnumIO.ByName<E extends Enum<E>>	Reads the enum by its name.
static final class	EnumIO.ByNumber<E extends Enum<E>>	Reads the enum by its number.

Field Summary

Fields

Modifier and Type	Field	Description
private static final Field	__elementTypeFromEnumSet
private static final Field	__keyTypeFromEnumMap
private final String[]	alias
final Class<E>	enumClass	The enum class.
private MapSchema.MessageFactory	enumMapFactory
private CollectionSchema.MessageFactory	enumSetFactory
final ArraySchemas.Base	genericElementSchema
final IdStrategy	strategy
private final int[]	tag
private final Map<String,E>	valueByAliasMap
private final Map<Integer,E>	valueByTagMap

Constructor Summary

Constructors

Constructor	Description
EnumIO(Class<E> enumClass, IdStrategy strategy)

Method Summary

Modifier and Type	Method	Description
String	getAlias(Enum<?> element)
E	getByAlias(String alias)
E	getByTag(int tag)
(package private) static Class<?>	getElementTypeFromEnumSet(Object enumSet)	Retrieves the enum key type from the EnumMap via reflection.
MapSchema.MessageFactory	getEnumMapFactory()	Returns the factory for an EnumMap (lazy).
CollectionSchema.MessageFactory	getEnumSetFactory()	Returns the factory for an EnumSet (lazy).
(package private) static Class<?>	getKeyTypeFromEnumMap(Object enumMap)	Retrieves the enum key type from the EnumMap via reflection.
int	getTag(Enum<?> element)
(package private) static EnumIO<? extends Enum<?>>	newEnumIO(Class<?> enumClass, IdStrategy strategy)
<V> EnumMap<E,V>	newEnumMap()	Returns an empty EnumMap.
private static <E extends Enum<E>> MapSchema.MessageFactory	newEnumMapFactory(EnumIO<E> eio)
EnumSet<E>	newEnumSet()	Returns an empty EnumSet.
private static <E extends Enum<E>> CollectionSchema.MessageFactory	newEnumSetFactory(EnumIO<E> eio)
PolymorphicSchema	newSchema(Class<?> typeClass, IdStrategy strategy, PolymorphicSchema.Handler handler)
abstract E	readFrom(Input input)	Read the enum from the input.
static void	transfer(Pipe pipe, Input input, Output output, int number, boolean repeated, IdStrategy strategy)	Transfers the Enum from the input to the output.
void	writeTo(Output output, int number, boolean repeated, Enum<?> e)	Writes the Enum to the output.

Methods inherited from class Object

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

Field Details

__keyTypeFromEnumMap

private static final Field __keyTypeFromEnumMap

__elementTypeFromEnumSet

private static final Field __elementTypeFromEnumSet

enumClass

public final Class<E extends Enum<E>> enumClass

The enum class.

strategy

public final IdStrategy strategy

genericElementSchema

public final ArraySchemas.Base genericElementSchema

enumSetFactory

private volatile CollectionSchema.MessageFactory enumSetFactory

enumMapFactory

private volatile MapSchema.MessageFactory enumMapFactory

alias

private final String[] alias

tag

private final int[] tag

valueByAliasMap

private final Map<String, E extends Enum<E>> valueByAliasMap

valueByTagMap

private final Map<Integer, E extends Enum<E>> valueByTagMap

Constructor Details

EnumIO

public EnumIO(Class<E> enumClass,
 IdStrategy strategy)

Method Details

getKeyTypeFromEnumMap

static Class<?> getKeyTypeFromEnumMap(Object enumMap)

Retrieves the enum key type from the EnumMap via reflection. This is used by ObjectSchema.

getElementTypeFromEnumSet

static Class<?> getElementTypeFromEnumSet(Object enumSet)

Retrieves the enum key type from the EnumMap via reflection. This is used by ObjectSchema.

newEnumIO

static EnumIO<? extends Enum<?>> newEnumIO(Class<?> enumClass,
 IdStrategy strategy)

writeTo

public void writeTo(Output output,
 int number,
 boolean repeated,
 Enum<?> e)
             throws IOException

Writes the Enum to the output.

Throws:

IOException

transfer

public static void transfer(Pipe pipe,
 Input input,
 Output output,
 int number,
 boolean repeated,
 IdStrategy strategy)
                     throws IOException

Transfers the Enum from the input to the output.

Throws:

IOException

newEnumSetFactory

private static <E extends Enum<E>>
CollectionSchema.MessageFactory newEnumSetFactory(EnumIO<E> eio)

newEnumMapFactory

private static <E extends Enum<E>>
MapSchema.MessageFactory newEnumMapFactory(EnumIO<E> eio)

newSchema

public PolymorphicSchema newSchema(Class<?> typeClass,
 IdStrategy strategy,
 PolymorphicSchema.Handler handler)

Specified by:

newSchema in interface PolymorphicSchema.Factory

getTag

public int getTag(Enum<?> element)

getAlias

public String getAlias(Enum<?> element)

getByTag

public E getByTag(int tag)

getByAlias

public E getByAlias(String alias)

getEnumSetFactory

public CollectionSchema.MessageFactory getEnumSetFactory()

Returns the factory for an EnumSet (lazy).

getEnumMapFactory

public MapSchema.MessageFactory getEnumMapFactory()

Returns the factory for an EnumMap (lazy).

newEnumSet

public EnumSet<E> newEnumSet()

Returns an empty EnumSet.

newEnumMap

public <V> EnumMap<E,V> newEnumMap()

Returns an empty EnumMap.

readFrom

public abstract E readFrom(Input input)
                    throws IOException

Read the enum from the input.

Throws:

IOException