se.l4.commons.serialization

Interface Serializer<T>

Type Parameters:

T -

All Superinterfaces:

SerializerOrResolver<T>

All Known Implementing Classes:

ArraySerializer, BooleanSerializer, ByteArraySerializer, CompactDynamicSerializer, ConfigKey.ConfigKeySerializer, DelayedSerializer, DoubleSerializer, DynamicSerializer, EnumSerializer, FileSerializer, FloatSerializer, IntSerializer, ListSerializer, LongSerializer, MapAsObjectSerializer, ReflectionNonStreamingSerializer, ReflectionStreamingSerializer, SetSerializer, ShortSerializer, SimpleTypeSerializer, StringSerializer, UuidSerializer

public interface Serializer<T>
extends SerializerOrResolver<T>

Serializer for a specific class. A serializer is used to read and write objects and is usually bound to a specific class. Serializers are retrieved via a SerializerCollection.

Author:

Andreas Holstenson

Method Summary

Modifier and Type	Method and Description
default java.util.function.Function<byte[],T>	fromBytes() Create a new function that turns byte arrays into objects.
default T	fromBytes(byte[] data) Read an instance from the given byte data.
default SerializerFormatDefinition	getFormatDefinition() Get the definition that describes what this serializer can read and write.
T	read(StreamingInput in) Read an object from the specified stream.
default java.util.function.Function<T,byte[]>	toBytes() Create a new function that turns objects into byte arrays.
default byte[]	toBytes(T instance) Turn an object into a byte array.
void	write(T object, String name, StreamingOutput stream) Write and object to the specified stream.

Method Detail

read

T read(StreamingInput in)
throws IOException

Read an object from the specified stream.

Parameters:

in -

Returns:

Throws:

IOException

write

void write(T object,
           String name,
           StreamingOutput stream)
    throws IOException

Write and object to the specified stream.

Parameters:

object - object to write

name - the name it should have in the stream

stream - the stream to use

Throws:

IOException

getFormatDefinition

default SerializerFormatDefinition getFormatDefinition()

Get the definition that describes what this serializer can read and write.

Returns:

toBytes

default byte[] toBytes(T instance)

Turn an object into a byte array.

Parameters:

instance -

Returns:

toBytes

default java.util.function.Function<T,byte[]> toBytes()

Create a new function that turns objects into byte arrays.

Returns:

fromBytes

default T fromBytes(byte[] data)

Read an instance from the given byte data.

Parameters:

data -

Returns:

fromBytes

default java.util.function.Function<byte[],T> fromBytes()

Create a new function that turns byte arrays into objects.

Returns: