Package org.infinispan.protostream
Interface EnumMarshaller<E extends Enum<E>>
- All Superinterfaces:
BaseMarshaller<E>
Contract to be implemented by marshallers of
Enum
types. Translates a Java enum into an int
value
that is suitable for serializing with Protobuf. The returned integer value must be one of the values defined in the
.proto schema file. The marshaller implementation must be stateless and thread-safe.- Since:
- 1.0
- Author:
- [email protected]
-
Method Summary
Methods inherited from interface org.infinispan.protostream.BaseMarshaller
getJavaClass, getTypeName
-
Method Details
-
decode
Decodes an integer enum value read from a Protobuf encoded stream into a Java enum instance.If the numeric value is not recognized the method must return
null
to signal this to the library and allow the unrecognized data to be preserved. No exception should be thrown in this case.- Parameters:
enumValue
- the Protobuf enum value to decode- Returns:
- a Java
Enum
instance if the value is recognized ornull
otherwise.
-
encode
Encodes a JavaEnum
into its corresponding Protobuf numeric value.- Parameters:
e
- anEnum
instance- Returns:
- the corresponding numeric value from the Protobuf definition of the enum.
- Throws:
IllegalArgumentException
- if the given Enum argument is of an unexpected type or its value has no correspondence to a Protobuf enum value (this is a programming error, not a schema evolution issue).
-