Class FunctionalObjectSerializer<T>

java.lang.Object

eu.cloudnetservice.driver.network.rpc.defaults.object.serializers.FunctionalObjectSerializer<T>

Type Parameters:

T - the type of data to write/read from the buffer.

All Implemented Interfaces:

ObjectSerializer<T>

public final class FunctionalObjectSerializer<T>
extends Object
implements ObjectSerializer<T>

An object serializer instance which passes the read and write calls to the functional providers previously added.

Since:

4.0

Field Summary

Fields

Modifier and Type	Field	Description
private final Function<DataBuf,T>	reader
private final BiConsumer<DataBuf.Mutable,T>	writer

Constructor Summary

Constructors

Modifier	Constructor	Description
private	FunctionalObjectSerializer(@NonNull Function<DataBuf,T> reader, @NonNull BiConsumer<DataBuf.Mutable,T> writer)	Constructs a new functional object serializer instance.

Method Summary

Modifier and Type	Method	Description
static <T> @NonNull FunctionalObjectSerializer<T>	of(@NonNull Function<DataBuf,T> reader, @NonNull BiConsumer<DataBuf.Mutable,T> writer)	Constructs a new functional object serializer instance.
T	read(@NonNull DataBuf source, @NonNull Type type, @NonNull ObjectMapper caller)	Reads the object from the buffer.
void	write(DataBuf.Mutable dataBuf, T object, @NonNull Type type, @NonNull ObjectMapper caller)	Writes the given object into the given buffer for network transfer and later deserialization.

Methods inherited from class java.lang.Object

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

Methods inherited from interface eu.cloudnetservice.driver.network.rpc.object.ObjectSerializer

preReadCheckAccepts, preWriteCheckAccepts

Field Details

reader

private final Function<DataBuf,T> reader

writer

private final BiConsumer<DataBuf.Mutable,T> writer

Constructor Details

FunctionalObjectSerializer

private FunctionalObjectSerializer(@NonNull
 @NonNull Function<DataBuf,T> reader,
 @NonNull
 @NonNull BiConsumer<DataBuf.Mutable,T> writer)

Constructs a new functional object serializer instance.

Parameters:

reader - the reader to read the content from the buffer.

writer - the writer which writes the given data to the buffer.

Throws:

NullPointerException - if either the writer or reader is null.

Method Details

of

@NonNull
public static <T>
@NonNull FunctionalObjectSerializer<T> of(@NonNull
 @NonNull Function<DataBuf,T> reader,
 @NonNull
 @NonNull BiConsumer<DataBuf.Mutable,T> writer)

Constructs a new functional object serializer instance.

Parameters:

reader - the reader to read the content from the buffer.

writer - the writer which writes the given data to the buffer.

Returns:

the created functional object serializer instance.

Throws:

NullPointerException - if either the writer or reader is null.

read

@Nullable
public T read(@NonNull
 @NonNull DataBuf source,
 @NonNull
 @NonNull Type type,
 @NonNull
 @NonNull ObjectMapper caller)

Reads the object from the buffer. This method should only read the content from the buffer which was written to it previously, never more as the given buffer is not a slice of the buffer representing the object being read. Although this method returns an object, the returned object must always match the given type during object construction. The object return type is just a helper, but the return value will be cast to the given type resulting in errors if provided with the wrong type of object.

Specified by:

read in interface ObjectSerializer<T>

Parameters:

source - the buffer to read the object from.

type - the type of the object to read.

caller - the mapper to which this serializer is registered and from which the deserialize request call came.

Returns:

the deserialized object of the serializer type T, or null if not readable.

write

public void write(@NonNull
 DataBuf.Mutable dataBuf,
 @Nullable
 T object,
 @NonNull
 @NonNull Type type,
 @NonNull
 @NonNull ObjectMapper caller)

Writes the given object into the given buffer for network transfer and later deserialization.

Specified by:

write in interface ObjectSerializer<T>

Parameters:

dataBuf - the buffer to write the data to.

object - the object to serialize.

type - the raw type of the object.

caller - the object mapper to which this serializer belongs and which requested the serialisation.