org.codehaus.jackson.map.module
Class SimpleDeserializers

java.lang.Object
  org.codehaus.jackson.map.module.SimpleDeserializers

All Implemented Interfaces:

Deserializers

public class SimpleDeserializers
extends Object
implements Deserializers

Simple implementation Deserializers which allows registration of deserializers based on raw (type erased class). It can work well for basic bean and scalar type deserializers, but is not a good fit for handling generic types (like Maps and Collections or array types).

Unlike SimpleSerializers, this class does not currently support generic mappings; all mappings must be to exact declared deserialization type.

Since:

1.7

Nested Class Summary

Nested classes/interfaces inherited from interface org.codehaus.jackson.map.Deserializers

Deserializers.None

Field Summary

protected HashMap<ClassKey,JsonDeserializer<?>>

_classMappings

Constructor Summary

SimpleDeserializers()

Method Summary

<T> void	addDeserializer(Class<T> forClass, JsonDeserializer<? extends T> deser)
JsonDeserializer<?>	findArrayDeserializer(ArrayType type, DeserializationConfig config, DeserializerProvider provider, BeanProperty property, TypeDeserializer elementTypeDeserializer, JsonDeserializer<?> elementDeserializer) Method called to locate constructor for specified array type.
JsonDeserializer<?>	findBeanDeserializer(JavaType type, DeserializationConfig config, DeserializerProvider provider, BeanDescription beanDesc, BeanProperty property) Method called to locate deserializer for specified value type which does not belong to any other category (not an Enum, Collection, Map, Array or tree node)
JsonDeserializer<?>	findCollectionDeserializer(CollectionType type, DeserializationConfig config, DeserializerProvider provider, BeanDescription beanDesc, BeanProperty property, TypeDeserializer elementTypeDeserializer, JsonDeserializer<?> elementDeserializer) Method called to locate constructor for specified Collection (List, Set etc) type.
JsonDeserializer<?>	findEnumDeserializer(Class<?> type, DeserializationConfig config, BeanDescription beanDesc, BeanProperty property) Method called to locate deserializer for specified Enum type.
JsonDeserializer<?>	findMapDeserializer(MapType type, DeserializationConfig config, DeserializerProvider provider, BeanDescription beanDesc, BeanProperty property, KeyDeserializer keyDeserializer, TypeDeserializer elementTypeDeserializer, JsonDeserializer<?> elementDeserializer) Method called to locate deserializer for specified Map type.
JsonDeserializer<?>	findTreeNodeDeserializer(Class<? extends JsonNode> nodeType, DeserializationConfig config, BeanProperty property) Method called to locate deserializer for specified JSON tree node type.

Methods inherited from class java.lang.Object

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

Field Detail

_classMappings

protected HashMap<ClassKey,JsonDeserializer<?>> _classMappings

Constructor Detail

SimpleDeserializers

public SimpleDeserializers()

Method Detail

addDeserializer

public <T> void addDeserializer(Class<T> forClass,
                                JsonDeserializer<? extends T> deser)

findArrayDeserializer

public JsonDeserializer<?> findArrayDeserializer(ArrayType type,
                                                 DeserializationConfig config,
                                                 DeserializerProvider provider,
                                                 BeanProperty property,
                                                 TypeDeserializer elementTypeDeserializer,
                                                 JsonDeserializer<?> elementDeserializer)

Description copied from interface: Deserializers

Method called to locate constructor for specified array type.

Deserializer for element type may be passed, if configured explicitly at higher level (by annotations, typically), but usually are not. Type deserializer for element is passed if one is needed based on contextual information (annotations on declared element class; or on field or method type is associated with).

Specified by:

findArrayDeserializer in interface Deserializers

Parameters:

type - Type of array instances to deserialize

config - Configuration in effect

provider - Provider that can be used to locate deserializer for component type (if one not provided, or needs to be overridden)

property - Property that contains array value (null for root values)

elementTypeDeserializer - If element type needs polymorphic type handling, this is the type information deserializer to use; should usually be used as is when constructing array deserializer.

elementDeserializer - Deserializer to use for elements, if explicitly defined (by using annotations, for exmple). May be null, in which case it should be resolved here (or using ResolvableDeserializer callback)

Returns:

Deserializer to use for the type; or null if this provider does not know how to construct it

findBeanDeserializer

public JsonDeserializer<?> findBeanDeserializer(JavaType type,
                                                DeserializationConfig config,
                                                DeserializerProvider provider,
                                                BeanDescription beanDesc,
                                                BeanProperty property)

Description copied from interface: Deserializers

Method called to locate deserializer for specified value type which does not belong to any other category (not an Enum, Collection, Map, Array or tree node)

Specified by:

findBeanDeserializer in interface Deserializers

Parameters:

type - Bean type to deserialize

config - Configuration in effect

provider - Provider that can be used to locate dependant deserializers if and as necessary (but note that in many cases resolution must be deferred by using ResolvableDeserializer callback)

beanDesc - Definition of the enumeration type that contains class annotations and other information typically needed for building deserializers (note: always instance of BasicBeanDescription)

Returns:

Deserializer to use for the type; or null if this provider does not know how to construct it

findCollectionDeserializer

public JsonDeserializer<?> findCollectionDeserializer(CollectionType type,
                                                      DeserializationConfig config,
                                                      DeserializerProvider provider,
                                                      BeanDescription beanDesc,
                                                      BeanProperty property,
                                                      TypeDeserializer elementTypeDeserializer,
                                                      JsonDeserializer<?> elementDeserializer)

Description copied from interface: Deserializers

Method called to locate constructor for specified Collection (List, Set etc) type.

Deserializer for element type may be passed, if configured explicitly at higher level (by annotations, typically), but usually are not. Type deserializer for element is passed if one is needed based on contextual information (annotations on declared element class; or on field or method type is associated with).

Specified by:

findCollectionDeserializer in interface Deserializers

Parameters:

type - Type of collection instances to deserialize

config - Configuration in effect

provider - Provider that can be used to locate dependant deserializers if and as necessary (but note that in many cases resolution must be deferred by using ResolvableDeserializer callback)

beanDesc - Definition of the enumeration type that contains class annotations and other information typically needed for building deserializers (note: always instance of BasicBeanDescription)

property - Property that contains array value (null for root values)

elementTypeDeserializer - If element type needs polymorphic type handling, this is the type information deserializer to use; should usually be used as is when constructing array deserializer.

elementDeserializer - Deserializer to use for elements, if explicitly defined (by using annotations, for exmple). May be null, in which case it should be resolved here (or using ResolvableDeserializer callback)

Returns:

Deserializer to use for the type; or null if this provider does not know how to construct it

findEnumDeserializer

public JsonDeserializer<?> findEnumDeserializer(Class<?> type,
                                                DeserializationConfig config,
                                                BeanDescription beanDesc,
                                                BeanProperty property)

Description copied from interface: Deserializers

Method called to locate deserializer for specified Enum type.

Specified by:

findEnumDeserializer in interface Deserializers

Parameters:

type - Type of Enum instances to deserialize

config - Configuration in effect

beanDesc - Definition of the enumeration type that contains class annotations and other information typically needed for building deserializers (note: always instance of BasicBeanDescription)

Returns:

Deserializer to use for the type; or null if this provider does not know how to construct it

findMapDeserializer

public JsonDeserializer<?> findMapDeserializer(MapType type,
                                               DeserializationConfig config,
                                               DeserializerProvider provider,
                                               BeanDescription beanDesc,
                                               BeanProperty property,
                                               KeyDeserializer keyDeserializer,
                                               TypeDeserializer elementTypeDeserializer,
                                               JsonDeserializer<?> elementDeserializer)

Description copied from interface: Deserializers

Method called to locate deserializer for specified Map type.

Deserializer for element type may be passed, if configured explicitly at higher level (by annotations, typically), but usually are not. Type deserializer for element is passed if one is needed based on contextual information (annotations on declared element class; or on field or method type is associated with).

Similarly, a KeyDeserializer may be passed, but this is only done if there is a specific configuration override (annotations) to indicate instance to use. Otherwise null is passed, and key deserializer needs to be obtained using DeserializerProvider

Specified by:

findMapDeserializer in interface Deserializers

Parameters:

type - Type of Map instances to deserialize

config - Configuration in effect

provider - Provider that can be used to locate dependant deserializers if and as necessary (but note that in many cases resolution must be deferred by using ResolvableDeserializer callback)

beanDesc - Definition of the enumeration type that contains class annotations and other information typically needed for building deserializers (note: always instance of BasicBeanDescription)

keyDeserializer - Key deserializer use, if it is defined via annotations or other configuration; null if default key deserializer for key type can be used.

elementTypeDeserializer - If element type needs polymorphic type handling, this is the type information deserializer to use; should usually be used as is when constructing array deserializer.

elementDeserializer - Deserializer to use for elements, if explicitly defined (by using annotations, for exmple). May be null, in which case it should be resolved here (or using ResolvableDeserializer callback)

Returns:

Deserializer to use for the type; or null if this provider does not know how to construct it

findTreeNodeDeserializer

public JsonDeserializer<?> findTreeNodeDeserializer(Class<? extends JsonNode> nodeType,
                                                    DeserializationConfig config,
                                                    BeanProperty property)

Description copied from interface: Deserializers

Method called to locate deserializer for specified JSON tree node type.

Specified by:

findTreeNodeDeserializer in interface Deserializers

Parameters:

nodeType - Specific type of JSON tree nodes to deserialize (subtype of JsonNode)

config - Configuration in effect

Returns:

Deserializer to use for the type; or null if this provider does not know how to construct it