net.sf.mmm.util.lang.base.datatype.adapter.jackson

Class DatatypeJsonDeserializer<T>

java.lang.Object

com.fasterxml.jackson.databind.JsonDeserializer<T>

net.sf.mmm.util.lang.base.datatype.adapter.jackson.DatatypeJsonDeserializer<T>

Type Parameters:

T - is the generic type of the Datatype to serialize.

public class DatatypeJsonDeserializer<T>
extends com.fasterxml.jackson.databind.JsonDeserializer<T>

This is a generic implementation of JsonDeserializer based on DatatypeDescriptorManager so every Datatype supported by DatatypeDescriptorManager can be deserialized from JSON.

Since:

6.0.0

Author:

Joerg Hohwiller (hohwille at users.sourceforge.net)

See Also:

DatatypeJsonSerializer

Nested Class Summary

Nested classes/interfaces inherited from class com.fasterxml.jackson.databind.JsonDeserializer

com.fasterxml.jackson.databind.JsonDeserializer.None

Field Summary

Fields

Modifier and Type	Field and Description
private Class<T>	datatype The class reflecting the datatype to deserialize.
private DatatypeDescriptorManager	datatypeDescriptorManager

Constructor Summary

Constructors

Constructor and Description
DatatypeJsonDeserializer(Class<T> datatype) The constructor.
DatatypeJsonDeserializer(Class<T> datatype, DatatypeDescriptorManager datatypeDescriptorManager) The constructor.

Method Summary

Modifier and Type	Method and Description
T	deserialize(com.fasterxml.jackson.core.JsonParser parser, com.fasterxml.jackson.databind.DeserializationContext context)
<V> V	deserializeGeneric(com.fasterxml.jackson.core.JsonParser parser, com.fasterxml.jackson.databind.DeserializationContext context, Class<V> type, com.fasterxml.jackson.databind.JsonNode parentNode, DatatypeSegmentDescriptor<?,?> segment) Generic and recursive implementation of deserialize(JsonParser, DeserializationContext).
protected <V> V	getValue(com.fasterxml.jackson.databind.JsonNode valueNode, Class<V> type) Gets and converts the value of the given JsonNode.
protected <V> V	getValue(com.fasterxml.jackson.databind.JsonNode node, String fieldName, Class<V> type, boolean required) Gets and converts the specified value from the given JsonNode.
void	setDatatypeDescriptorManager(DatatypeDescriptorManager datatypeDescriptorManager)

Methods inherited from class com.fasterxml.jackson.databind.JsonDeserializer

deserialize, deserializeWithType, findBackReference, getDelegatee, getEmptyValue, getKnownPropertyNames, getNullValue, getObjectIdReader, handledType, isCachable, replaceDelegatee, unwrappingDeserializer

Methods inherited from class java.lang.Object

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

Field Detail

datatype

private final Class<T> datatype

The class reflecting the datatype to deserialize.

datatypeDescriptorManager

private DatatypeDescriptorManager datatypeDescriptorManager

See Also:

setDatatypeDescriptorManager(DatatypeDescriptorManager)

Constructor Detail

DatatypeJsonDeserializer

public DatatypeJsonDeserializer(Class<T> datatype)

The constructor.

Parameters:

datatype - is the class reflecting the datatype to deserialize.

DatatypeJsonDeserializer

public DatatypeJsonDeserializer(Class<T> datatype,
                                DatatypeDescriptorManager datatypeDescriptorManager)

The constructor.

Parameters:

datatype - is the class reflecting the datatype to deserialize.

datatypeDescriptorManager - is the DatatypeDescriptorManager instance to use.

Method Detail

setDatatypeDescriptorManager

@Inject
public void setDatatypeDescriptorManager(DatatypeDescriptorManager datatypeDescriptorManager)

Parameters:

datatypeDescriptorManager - is the DatatypeDescriptorManager to Inject.

getValue

protected <V> V getValue(com.fasterxml.jackson.databind.JsonNode node,
                         String fieldName,
                         Class<V> type,
                         boolean required)

Gets and converts the specified value from the given JsonNode.

Type Parameters:

V - is the generic type of the requested value.

Parameters:

node - is the JsonNode containing the value as child.

fieldName - is the field name of the requested value.

type - is the Class reflecting the requested type to convert to.

required - - true if the value is mandatory and an exception will be thrown if the value is not present, false otherwise.

Returns:

the requested and converted value. May be null if not set and required is false.

getValue

protected <V> V getValue(com.fasterxml.jackson.databind.JsonNode valueNode,
                         Class<V> type)

Gets and converts the value of the given JsonNode.

Type Parameters:

V - is the generic type of the requested value.

Parameters:

valueNode - is the JsonNode containing the value.

type - is the Class reflecting the requested type to convert to.

Returns:

the requested and converted value. May be null if not set.

deserializeGeneric

public <V> V deserializeGeneric(com.fasterxml.jackson.core.JsonParser parser,
                                com.fasterxml.jackson.databind.DeserializationContext context,
                                Class<V> type,
                                com.fasterxml.jackson.databind.JsonNode parentNode,
                                DatatypeSegmentDescriptor<?,?> segment)
                         throws IOException

Generic and recursive implementation of deserialize(JsonParser, DeserializationContext).

Type Parameters:

V - is the generic type of the expected value to deserialize.

Parameters:

parser - is the JsonParser.

context - is the DeserializationContext.

type - is the Class reflecting the expected type of the value to deserialize.

parentNode - is the JsonNode that has already been parsed (recursive call) or null if the value has to be read from JsonParser.

segment - is the DatatypeSegmentDescriptor with the segment to deserialize as child of parentNode (recursive call) or null if the value has to be read from JsonParser.

Returns:

the deserialized value.

Throws:

IOException - if reading from JsonParser causes an I/O problem.

deserialize

public T deserialize(com.fasterxml.jackson.core.JsonParser parser,
                     com.fasterxml.jackson.databind.DeserializationContext context)
              throws IOException,
                     com.fasterxml.jackson.core.JsonProcessingException

Specified by:

deserialize in class com.fasterxml.jackson.databind.JsonDeserializer<T>

Throws:

IOException

com.fasterxml.jackson.core.JsonProcessingException