com.esotericsoftware.kryo.serializers

Class TaggedFieldSerializer<T>

java.lang.Object

com.esotericsoftware.kryo.Serializer<T>

com.esotericsoftware.kryo.serializers.FieldSerializer<T>

com.esotericsoftware.kryo.serializers.TaggedFieldSerializer<T>

All Implemented Interfaces:

java.util.Comparator<FieldSerializer.CachedField>

public class TaggedFieldSerializer<T>
extends FieldSerializer<T>

Serializes objects using direct field assignment for fields that have been tagged. Fields without the TaggedFieldSerializer.Tag annotation are not serialized. New tagged fields can be added without invalidating previously serialized bytes. If any tagged field is removed, previously serialized bytes are invalidated. Instead of removing fields, apply the Deprecated annotation and they will still be deserialized but won't be serialized. If fields are public, bytecode generation will be used instead of reflection.

Author:

Nathan Sweet

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	TaggedFieldSerializer.Tag If true, this field will not be serialized.

Nested classes/interfaces inherited from class com.esotericsoftware.kryo.serializers.FieldSerializer

FieldSerializer.CachedField<X>, FieldSerializer.Optional

Constructor Summary

Constructors

Constructor and Description
TaggedFieldSerializer(Kryo kryo, java.lang.Class type)

Method Summary

Methods

Modifier and Type	Method and Description
T	read(Kryo kryo, Input input, java.lang.Class<T> type) Reads bytes and returns a new object of the specified concrete type.
void	removeField(java.lang.String fieldName) Removes a field so that it won't be serialized.
void	write(Kryo kryo, Output output, T object) Writes the bytes for the object to the output.

Methods inherited from class com.esotericsoftware.kryo.serializers.FieldSerializer

compare, copy, getField, getFields, getType, setFieldsAsAccessible, setFieldsCanBeNull, setFixedFieldTypes, setIgnoreSyntheticFields

Methods inherited from class com.esotericsoftware.kryo.Serializer

getAcceptsNull, isImmutable, setAcceptsNull, setGenerics, setImmutable

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Comparator

equals

Constructor Detail

TaggedFieldSerializer

public TaggedFieldSerializer(Kryo kryo,
                     java.lang.Class type)

Method Detail

removeField

public void removeField(java.lang.String fieldName)

Description copied from class: FieldSerializer

Removes a field so that it won't be serialized.

Overrides:

removeField in class FieldSerializer<T>

write

public void write(Kryo kryo,
         Output output,
         T object)

Description copied from class: Serializer

Writes the bytes for the object to the output.

This method should not be called directly, instead this serializer can be passed to Kryo write methods that accept a serialier.

Overrides:

write in class FieldSerializer<T>

object - May be null if Serializer.getAcceptsNull() is true.

read

public T read(Kryo kryo,
     Input input,
     java.lang.Class<T> type)

Description copied from class: Serializer

Reads bytes and returns a new object of the specified concrete type.

Before Kryo can be used to read child objects, Kryo.reference(Object) must be called with the parent object to ensure it can be referenced by the child objects. Any serializer that uses Kryo to read a child object may need to be reentrant.

This method should not be called directly, instead this serializer can be passed to Kryo read methods that accept a serialier.

Overrides:

read in class FieldSerializer<T>

Returns:

May be null if Serializer.getAcceptsNull() is true.