net.sergeych.biserializer

Class BiDeserializer

java.lang.Object

net.sergeych.biserializer.BiDeserializer

public class BiDeserializer
extends java.lang.Object

Binder deserializer. Provides deserializing objects prepared by BiSerializer. Provides deserialization context helpers, withContext(Object, ContextBlock) and getContext().

It is important to understand that each instance has a shared copy of BiMapper to be used in the deserialization. It is important because there are different mappers for fidderent occasions, for example DefaultBiMapper and BossBiMapper.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	BiDeserializer.ContextBlock<E extends java.lang.Throwable> A lambda to call with context, could throw an exception of set type.

Constructor Summary

Constructors

Constructor and Description
BiDeserializer() Construct deserializer with DefaultBiMapper
BiDeserializer(BiMapper mapper) Construct deserializer for a given class mapper

Method Summary

Modifier and Type	Method and Description
<T,U> T	deserialize(U object) Deserialize some object if need.
<T> java.util.List<T>	deserializeCollection(java.util.Collection<?> collection) Deserialize a collection.
void	deserializeInPlace(java.util.Map map) Modify a map by deserializing it's values in place.
<T> T	getContext() Get the current context, if any.
<T> T	getContextOrThrow() Get context or throw exception if none is set.
<T,E extends java.lang.Throwable> void	withContext(T contextValue, BiDeserializer.ContextBlock<E> block) Set the deserilaziation context and executes the BiDeserializer.ContextBlock.perform().

Methods inherited from class java.lang.Object

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

Constructor Detail

BiDeserializer

public BiDeserializer(BiMapper mapper)

Construct deserializer for a given class mapper

Parameters:

mapper -

BiDeserializer

public BiDeserializer()

Construct deserializer with DefaultBiMapper

Method Detail

deserialize

public <T,U> T deserialize(U object)

Deserialize some object if need. E.g. if the object is a simple type supported by most notations, e.g. numbers, strings, it is left unchanged, but if it is a collection or a Map it will be processed to deserialize its content. See BiMapper.deserializeObject(Object) for details

Type Parameters:

T -

U -

Parameters:

object - to deserialize

Returns:

restored object

deserializeCollection

public <T> java.util.List<T> deserializeCollection(java.util.Collection<?> collection)

Deserialize a collection. Utility method that deserialize every object and return the result as an ArrayList.

Type Parameters:

T -

Parameters:

collection -

Returns:

deserializeInPlace

public void deserializeInPlace(java.util.Map map)

Modify a map by deserializing it's values in place. Saves memory.

Parameters:

map -

getContext

public final <T> T getContext()

Get the current context, if any. To set a context, use withContext(Object, ContextBlock)

Type Parameters:

T -

Returns:

current context of null if not set.

getContextOrThrow

public final <T> T getContextOrThrow()

Get context or throw exception if none is set. See withContext(Object, ContextBlock) for details.

Type Parameters:

T -

Returns:

context

Throws:

java.lang.IllegalArgumentException

withContext

public <T,E extends java.lang.Throwable> void withContext(T contextValue,
                                                          BiDeserializer.ContextBlock<E> block)
                                                   throws E extends java.lang.Throwable

Set the deserilaziation context and executes the BiDeserializer.ContextBlock.perform(). Context is any object that will be retured by the getContext() while executing the block. After this call the context will be resotred to it's previous state, or set to null if no context was set.

It is safe and even recommended to set different context to simplify deserialization logic.

Any exception of specified class thrown by the block will be retransmitted outside.

Type Parameters:

T - context type

E - exception type that could be thrown from the block

Parameters:

contextValue - any object to be a current deserialization context

block - to perform with that context

Throws:

E - if the BiDeserializer.ContextBlock.perform() thows it.

E extends java.lang.Throwable