me.zeroeightsix.fiber.api.serialization

Class JanksonSerializer

java.lang.Object

me.zeroeightsix.fiber.api.serialization.JanksonSerializer

All Implemented Interfaces:

Serializer<blue.endless.jankson.JsonObject>

public class JanksonSerializer
extends java.lang.Object
implements Serializer<blue.endless.jankson.JsonObject>

Constructor Summary

Constructors

Constructor and Description
JanksonSerializer()
JanksonSerializer(Marshaller<blue.endless.jankson.JsonElement> marshaller, boolean compress)

Method Summary

Modifier and Type	Method and Description
blue.endless.jankson.JsonObject	deserialize(ConfigTree tree, java.io.InputStream stream) Deserializes data from an InputStream into a config tree.
blue.endless.jankson.JsonObject	deserialize(ConfigTree tree, blue.endless.jankson.JsonObject element) Deserializes an intermediate element into a config tree.
static Marshaller<blue.endless.jankson.JsonElement>	extendDefaultMarshaller(Marshaller<blue.endless.jankson.JsonElement> marshaller)
FiberId	getIdentifier()
blue.endless.jankson.JsonObject	serialize(ConfigTree tree) Serializes a config tree.
void	serialize(ConfigTree tree, blue.endless.jankson.JsonObject additionalData, java.io.OutputStream out) Serializes a config tree and writes it to an OutputStream.

Methods inherited from class java.lang.Object

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

Methods inherited from interface me.zeroeightsix.fiber.api.serialization.Serializer

serialize

Constructor Detail

JanksonSerializer

public JanksonSerializer()

JanksonSerializer

public JanksonSerializer(@Nonnull
                         Marshaller<blue.endless.jankson.JsonElement> marshaller,
                         boolean compress)

Method Detail

deserialize

public blue.endless.jankson.JsonObject deserialize(ConfigTree tree,
                                                   java.io.InputStream stream)
                                            throws java.io.IOException,
                                                   FiberException

Description copied from interface: Serializer

Deserializes data from an InputStream into a config tree.

If the serialized tree has elements not present in the actual node, they will be collected as a separate data structure and returned.

Specified by:

deserialize in interface Serializer<blue.endless.jankson.JsonObject>

Parameters:

tree - the node to deserialize

stream - the serialized data for the node

Returns:

the unprocessed elements, in the same format as the input data

Throws:

java.io.IOException

FiberException

deserialize

public blue.endless.jankson.JsonObject deserialize(ConfigTree tree,
                                                   blue.endless.jankson.JsonObject element)
                                            throws FiberException

Description copied from interface: Serializer

Deserializes an intermediate element into a config tree.

If the serialized tree has elements not present in the actual node, they will be collected as a separate data structure and returned.

Specified by:

deserialize in interface Serializer<blue.endless.jankson.JsonObject>

Parameters:

tree - the node to deserialize

element - the serialized data for the node

Returns:

the unprocessed elements, in the same format as the input data

Throws:

FiberException

serialize

public void serialize(ConfigTree tree,
                      @Nullable
                      blue.endless.jankson.JsonObject additionalData,
                      java.io.OutputStream out)
               throws java.io.IOException

Description copied from interface: Serializer

Serializes a config tree and writes it to an OutputStream.

The caller may pass in additional data to be appended to the serialized tree. In case of conflict between the serialized tree and the additional data (eg. map representation with conflicting keys), the conflicting data from the serialized tree gets overwritten.

The additionalData may be used with the leftovers from Serializer.deserialize(ConfigTree, InputStream) to inject back unrecognized nodes.

Specified by:

serialize in interface Serializer<blue.endless.jankson.JsonObject>

Parameters:

tree - the node to serialize

additionalData - data to append to the serialized tree

out - the stream to which the serialized data is to be written

Throws:

java.io.IOException

serialize

public blue.endless.jankson.JsonObject serialize(ConfigTree tree)

Description copied from interface: Serializer

Serializes a config tree.

Specified by:

serialize in interface Serializer<blue.endless.jankson.JsonObject>

Parameters:

tree - the node to serialize

Returns:

the serialized data for the node

getIdentifier

public FiberId getIdentifier()

Specified by:

getIdentifier in interface Serializer<blue.endless.jankson.JsonObject>

extendDefaultMarshaller

public static Marshaller<blue.endless.jankson.JsonElement> extendDefaultMarshaller(Marshaller<blue.endless.jankson.JsonElement> marshaller)