Module tools.jackson.databind
Package tools.jackson.databind.module

Class SimpleDeserializers

java.lang.Object
tools.jackson.databind.deser.Deserializers.Base
tools.jackson.databind.module.SimpleDeserializers
All Implemented Interfaces:
Serializable, Deserializers
public class SimpleDeserializers extends Deserializers.Base implements Serializable
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.

See Also:

  • Field Details

    • _classMappings

      protected HashMap<ClassKey,ValueDeserializer<?>> _classMappings

    • _hasEnumDeserializer

      protected boolean _hasEnumDeserializer
      Flag to help find "generic" enum deserializer, if one has been registered.

  • Constructor Details

    • SimpleDeserializers

      public SimpleDeserializers()

    • SimpleDeserializers

      public SimpleDeserializers(Map<Class<?>,ValueDeserializer<?>> desers)

  • Method Details

    • addDeserializer

      public <T> SimpleDeserializers addDeserializer(Class<T> forClass, ValueDeserializer<? extends T> deser)

    • addDeserializers

      public SimpleDeserializers addDeserializers(Map<Class<?>,ValueDeserializer<?>> desers)

    • findArrayDeserializer

      public ValueDeserializer<?> findArrayDeserializer(ArrayType type, DeserializationConfig config, BeanDescription beanDesc, TypeDeserializer elementTypeDeserializer, ValueDeserializer<?> elementDeserializer)
      Description copied from interface: Deserializers
      Method called to locate deserializer 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
      Overrides:
      findArrayDeserializer in class Deserializers.Base
      Parameters:
      type - Type of array 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
      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 example). May be null, in which case it will need to be resolved by deserializer at a later point.
      Returns:
      Deserializer to use for the type; or null if this provider does not know how to construct it

    • findBeanDeserializer

      public ValueDeserializer<?> findBeanDeserializer(JavaType type, DeserializationConfig config, BeanDescription beanDesc)
      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, reference value or tree node)
      Specified by:
      findBeanDeserializer in interface Deserializers
      Overrides:
      findBeanDeserializer in class Deserializers.Base
      Parameters:
      type - Bean type to deserialize
      config - Configuration in effect
      beanDesc - Definition of the enumeration type that contains class annotations and other information typically needed for building deserializers
      Returns:
      Deserializer to use for the type; or null if this provider does not know how to construct it

    • findCollectionDeserializer

      public ValueDeserializer<?> findCollectionDeserializer(CollectionType type, DeserializationConfig config, BeanDescription beanDesc, TypeDeserializer elementTypeDeserializer, ValueDeserializer<?> elementDeserializer)
      Description copied from interface: Deserializers
      Method called to locate deserializer 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
      Overrides:
      findCollectionDeserializer in class Deserializers.Base
      Parameters:
      type - Type of collection 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
      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 example). May be null, in which case it will need to be resolved by deserializer at a later point.
      Returns:
      Deserializer to use for the type; or null if this provider does not know how to construct it

    • findCollectionLikeDeserializer

      public ValueDeserializer<?> findCollectionLikeDeserializer(CollectionLikeType type, DeserializationConfig config, BeanDescription beanDesc, TypeDeserializer elementTypeDeserializer, ValueDeserializer<?> elementDeserializer)
      Description copied from interface: Deserializers
      Method called to locate deserializer for specified "Collection-like" type (one that acts like Collection but does not implement it).

      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:
      findCollectionLikeDeserializer in interface Deserializers
      Overrides:
      findCollectionLikeDeserializer in class Deserializers.Base
      Parameters:
      type - Type of 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
      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 example). May be null, in which case it will need to be resolved by deserializer at a later point.
      Returns:
      Deserializer to use for the type; or null if this provider does not know how to construct it

    • findEnumDeserializer

      public ValueDeserializer<?> findEnumDeserializer(Class<?> type, DeserializationConfig config, BeanDescription beanDesc)
      Description copied from interface: Deserializers
      Method called to locate deserializer for specified Enum type.
      Specified by:
      findEnumDeserializer in interface Deserializers
      Overrides:
      findEnumDeserializer in class Deserializers.Base
      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
      Returns:
      Deserializer to use for the type; or null if this provider does not know how to construct it

    • findTreeNodeDeserializer

      public ValueDeserializer<?> findTreeNodeDeserializer(Class<? extends JsonNode> nodeType, DeserializationConfig config, BeanDescription beanDesc)
      Description copied from interface: Deserializers
      Method called to locate deserializer for specified JSON tree node type.
      Specified by:
      findTreeNodeDeserializer in interface Deserializers
      Overrides:
      findTreeNodeDeserializer in class Deserializers.Base
      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

    • findReferenceDeserializer

      public ValueDeserializer<?> findReferenceDeserializer(ReferenceType refType, DeserializationConfig config, BeanDescription beanDesc, TypeDeserializer contentTypeDeserializer, ValueDeserializer<?> contentDeserializer)
      Description copied from interface: Deserializers
      Method called to locate deserializer for value that is of referential type,
      Specified by:
      findReferenceDeserializer in interface Deserializers
      Overrides:
      findReferenceDeserializer in class Deserializers.Base
      Parameters:
      refType - Specific referential type to deserialize
      config - Configuration in effect
      beanDesc - Definition of the reference type that contains class annotations and other information typically needed for building deserializers
      contentTypeDeserializer - Possible type deserializer for referenced value
      contentDeserializer - Value deserializer to use for referenced value, if indicated by property annotation
      Returns:
      Deserializer to use for the type; or null if this provider does not know how to construct it

    • findMapDeserializer

      public ValueDeserializer<?> findMapDeserializer(MapType type, DeserializationConfig config, BeanDescription beanDesc, KeyDeserializer keyDeserializer, TypeDeserializer elementTypeDeserializer, ValueDeserializer<?> 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 later during resolution of map serializer constructed here.

      Specified by:
      findMapDeserializer in interface Deserializers
      Overrides:
      findMapDeserializer in class Deserializers.Base
      Parameters:
      type - Type of Map 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
      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 example). May be null, in which case it will need to be resolved by deserializer at a later point.
      Returns:
      Deserializer to use for the type; or null if this provider does not know how to construct it

    • findMapLikeDeserializer

      public ValueDeserializer<?> findMapLikeDeserializer(MapLikeType type, DeserializationConfig config, BeanDescription beanDesc, KeyDeserializer keyDeserializer, TypeDeserializer elementTypeDeserializer, ValueDeserializer<?> elementDeserializer)
      Description copied from interface: Deserializers
      Method called to locate deserializer for specified "Map-like" type (one that acts like Map but does not implement it).

      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 later during resolution, by deserializer constructed here.

      Specified by:
      findMapLikeDeserializer in interface Deserializers
      Overrides:
      findMapLikeDeserializer in class Deserializers.Base
      Parameters:
      type - Type of Map 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
      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 example). May be null, in which case it will need to be resolved by deserializer at a later point.
      Returns:
      Deserializer to use for the type; or null if this provider does not know how to construct it

    • hasDeserializerFor

      public boolean hasDeserializerFor(DeserializationConfig config, Class<?> valueType)
      Description copied from interface: Deserializers
      Method that may be called to check whether this deserializer provider would provide deserializer for values of given type, without attempting to construct (and possibly fail in some cases) actual deserializer. Mostly needed to support validation of polymorphic type ids.

      Note: implementations should take care NOT to claim supporting types that they do not recognize as this could to incorrect assumption of safe support by caller.

      Specified by:
      hasDeserializerFor in interface Deserializers