Jackson 3.0.1 · tools.jackson.databind.deser.DeserializerFactory

Abstract class that defines API used by DeserializationContext to construct actual ValueDeserializer instances (which are then cached by context and/or dedicated cache).

Since there are multiple broad categories of deserializers, there are multiple factory methods:

For JSON "Array" type, we need 2 methods: one to deal with expected Java arrays (createArrayDeserializer) and the other for other Java containers like java.util.Lists and java.util.Sets (createCollectionDeserializer). Actually there is also a third method for "Collection-like" types; things like Scala collections that act like JDK collections but do not implement same interfaces.
For JSON "Object" type, we need 2 methods: one to deal with expected Java java.util.Maps (createMapDeserializer), and another for POJOs (createBeanDeserializer. As an additional twist there is also a callback for "Map-like" types, mostly to make it possible to support Scala Maps (which are NOT JDK Map compatible).
For Tree Model (tools.jackson.databind.JsonNode) properties there is createTreeDeserializer
For enumerated types (java.lang.Enum) there is createEnumDeserializer
For all other types, createBeanDeserializer is used.

Modifier and Type	Field and Description
protected static final Deserializers[]	NO_DESERIALIZERS

Constructor Summary

Access	Constructor and Description
public	DeserializerFactory()

Method Summary

Modifier and Type	Method and Description
public abstract ValueDeserializer<?>	createArrayDeserializer(DeserializationContext ctxt, ArrayType Type to be deserialized type, BeanDescription.Supplier beanDescRef) Method called to create (or, for completely immutable deserializers, reuse) a deserializer that can convert JSON content into values of specified Java type.
public abstract ValueDeserializer<Object>	createBeanDeserializer(DeserializationContext ctxt, JavaType Type to be deserialized type, BeanDescription.Supplier beanDescRef) Method called to create (or, for completely immutable deserializers, reuse) a deserializer that can convert JSON content into values of specified Java "bean" (POJO) type.
public abstract ValueDeserializer<Object>	createBuilderBasedDeserializer(DeserializationContext ctxt, JavaType type, BeanDescription.Supplier beanDescRef, Class<?> builderClass) Method called to create a deserializer that will use specified Builder class for building value instances.
public abstract ValueDeserializer<?>	createCollectionDeserializer(DeserializationContext ctxt, CollectionType type, BeanDescription.Supplier beanDescRef)
public abstract ValueDeserializer<?>	createCollectionLikeDeserializer(DeserializationContext ctxt, CollectionLikeType type, BeanDescription.Supplier beanDescRef)
public abstract ValueDeserializer<?>	createEnumDeserializer(DeserializationContext ctxt, JavaType type, BeanDescription.Supplier beanDescRef)
public abstract KeyDeserializer	Returns: Key deserializer to use for specified type, if one found; null if not (and default key deserializer should be used) createKeyDeserializer(DeserializationContext ctxt, JavaType type) Method called to find if factory knows how to create a key deserializer for specified type; currently this means checking if a module has registered possible deserializers.
public abstract ValueDeserializer<?>	createMapDeserializer(DeserializationContext ctxt, MapType type, BeanDescription.Supplier beanDescRef)
public abstract ValueDeserializer<?>	createMapLikeDeserializer(DeserializationContext ctxt, MapLikeType type, BeanDescription.Supplier beanDescRef)
public abstract ValueDeserializer<?>	createReferenceDeserializer(DeserializationContext ctxt, ReferenceType type, BeanDescription.Supplier beanDescRef)
public abstract ValueDeserializer<?>	createTreeDeserializer(DeserializationConfig config, JavaType type, BeanDescription.Supplier beanDescRef) Method called to create and return a deserializer that can construct JsonNode(s) from JSON content.
public abstract ValueInstantiator	findValueInstantiator(DeserializationContext ctxt, BeanDescription.Supplier beanDescRef) Method that is to find all creators (constructors, factory methods) for the bean type to deserialize.
public abstract boolean	hasExplicitDeserializerFor(DatabindContext ctxt, Class<?> valueType) Method that can be used to check if databind module has explicitly declared deserializer for given (likely JDK) type, explicit meaning that there is specific deserializer for given type as opposed to auto-generated "Bean" deserializer.
public abstract DeserializerFactory	withAdditionalDeserializers(Deserializers additional) Convenience method for creating a new factory instance with additional deserializer provider.
public abstract DeserializerFactory	withAdditionalKeyDeserializers(KeyDeserializers additional) Convenience method for creating a new factory instance with additional `KeyDeserializers`.
public abstract DeserializerFactory	withDeserializerModifier(ValueDeserializerModifier modifier) Convenience method for creating a new factory instance with additional `ValueDeserializerModifier`.
public abstract DeserializerFactory	withValueInstantiators(ValueInstantiators instantiators) Convenience method for creating a new factory instance with additional `ValueInstantiators`.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

NO_DESERIALIZERS	back to summary
protected static final Deserializers[] NO_DESERIALIZERS

Constructor Detail

DeserializerFactory	back to summary
public DeserializerFactory()

Method Detail

createArrayDeserializer	back to summary
public abstract ValueDeserializer<?> createArrayDeserializer(DeserializationContext ctxt, ArrayType type, BeanDescription.Supplier beanDescRef) Method called to create (or, for completely immutable deserializers, reuse) a deserializer that can convert JSON content into values of specified Java type. Parameters type:ArrayType Type to be deserialized

createArrayDeserializer

back to summary

public abstract ValueDeserializer<?> createArrayDeserializer(DeserializationContext ctxt, ArrayType type, BeanDescription.Supplier beanDescRef)

Method called to create (or, for completely immutable deserializers, reuse) a deserializer that can convert JSON content into values of specified Java type.

Parameters

type:ArrayType: Type to be deserialized

createBeanDeserializer	back to summary
public abstract ValueDeserializer<Object> createBeanDeserializer(DeserializationContext ctxt, JavaType type, BeanDescription.Supplier beanDescRef) Method called to create (or, for completely immutable deserializers, reuse) a deserializer that can convert JSON content into values of specified Java "bean" (POJO) type. At this point it is known that the type is not otherwise recognized as one of structured types (array, Collection, Map) or a well-known JDK type (enum, primitives/wrappers, String); this method only gets called if other options are exhausted. This also means that this method can be overridden to add support for custom types. Parameters type:JavaType Type to be deserialized

createBeanDeserializer

back to summary

public abstract ValueDeserializer<Object> createBeanDeserializer(DeserializationContext ctxt, JavaType type, BeanDescription.Supplier beanDescRef)

Method called to create (or, for completely immutable deserializers, reuse) a deserializer that can convert JSON content into values of specified Java "bean" (POJO) type. At this point it is known that the type is not otherwise recognized as one of structured types (array, Collection, Map) or a well-known JDK type (enum, primitives/wrappers, String); this method only gets called if other options are exhausted. This also means that this method can be overridden to add support for custom types.

Parameters

type:JavaType: Type to be deserialized

createBuilderBasedDeserializer	back to summary
public abstract ValueDeserializer<Object> createBuilderBasedDeserializer(DeserializationContext ctxt, JavaType type, BeanDescription.Supplier beanDescRef, Class<?> builderClass) Method called to create a deserializer that will use specified Builder class for building value instances.

createCollectionDeserializer	back to summary
public abstract ValueDeserializer<?> createCollectionDeserializer(DeserializationContext ctxt, CollectionType type, BeanDescription.Supplier beanDescRef)

createCollectionLikeDeserializer	back to summary
public abstract ValueDeserializer<?> createCollectionLikeDeserializer(DeserializationContext ctxt, CollectionLikeType type, BeanDescription.Supplier beanDescRef)

createEnumDeserializer	back to summary
public abstract ValueDeserializer<?> createEnumDeserializer(DeserializationContext ctxt, JavaType type, BeanDescription.Supplier beanDescRef)

createKeyDeserializer	back to summary
public abstract KeyDeserializer createKeyDeserializer(DeserializationContext ctxt, JavaType type) Method called to find if factory knows how to create a key deserializer for specified type; currently this means checking if a module has registered possible deserializers. Returns:KeyDeserializer Key deserializer to use for specified type, if one found; null if not (and default key deserializer should be used)

createKeyDeserializer

back to summary

public abstract KeyDeserializer createKeyDeserializer(DeserializationContext ctxt, JavaType type)

Method called to find if factory knows how to create a key deserializer for specified type; currently this means checking if a module has registered possible deserializers.

Returns:KeyDeserializer: Key deserializer to use for specified type, if one found; null if not (and default key deserializer should be used)

createMapDeserializer	back to summary
public abstract ValueDeserializer<?> createMapDeserializer(DeserializationContext ctxt, MapType type, BeanDescription.Supplier beanDescRef)

createMapLikeDeserializer	back to summary
public abstract ValueDeserializer<?> createMapLikeDeserializer(DeserializationContext ctxt, MapLikeType type, BeanDescription.Supplier beanDescRef)

createReferenceDeserializer	back to summary
public abstract ValueDeserializer<?> createReferenceDeserializer(DeserializationContext ctxt, ReferenceType type, BeanDescription.Supplier beanDescRef)

createTreeDeserializer	back to summary
public abstract ValueDeserializer<?> createTreeDeserializer(DeserializationConfig config, JavaType type, BeanDescription.Supplier beanDescRef) Method called to create and return a deserializer that can construct JsonNode(s) from JSON content.

findValueInstantiator	back to summary
public abstract ValueInstantiator findValueInstantiator(DeserializationContext ctxt, BeanDescription.Supplier beanDescRef) Method that is to find all creators (constructors, factory methods) for the bean type to deserialize.

hasExplicitDeserializerFor back to summary

hasExplicitDeserializerFor	back to summary
public abstract boolean hasExplicitDeserializerFor(DatabindContext ctxt, Class<?> valueType) Method that can be used to check if databind module has explicitly declared deserializer for given (likely JDK) type, explicit meaning that there is specific deserializer for given type as opposed to auto-generated "Bean" deserializer. Factory itself will check for known JDK-provided types, but registered `tools.jackson.databind.JacksonModule`s are also called to see if they might provide explicit deserializer. Main use for this method is with Safe Default Typing (and generally Safe Polymorphic Deserialization), during which it is good to be able to check that given raw type is explicitly supported and as such "known type" (as opposed to potentially dangerous "gadget type" which could be exploited). This matches `Deserializers.Base.hasDeserializerFor(Class)` method, which is the mechanism used to determine if a `Module` might provide an explicit deserializer instead of core databind.

public abstract boolean hasExplicitDeserializerFor(DatabindContext ctxt, Class<?> valueType)

Method that can be used to check if databind module has explicitly declared deserializer for given (likely JDK) type, explicit meaning that there is specific deserializer for given type as opposed to auto-generated "Bean" deserializer. Factory itself will check for known JDK-provided types, but registered tools.jackson.databind.JacksonModules are also called to see if they might provide explicit deserializer.

Main use for this method is with Safe Default Typing (and generally Safe Polymorphic Deserialization), during which it is good to be able to check that given raw type is explicitly supported and as such "known type" (as opposed to potentially dangerous "gadget type" which could be exploited).

This matches Deserializers.Base.hasDeserializerFor(Class) method, which is the mechanism used to determine if a Module might provide an explicit deserializer instead of core databind.

withAdditionalDeserializers	back to summary
public abstract DeserializerFactory withAdditionalDeserializers(Deserializers additional) Convenience method for creating a new factory instance with additional deserializer provider.

withAdditionalKeyDeserializers	back to summary
public abstract DeserializerFactory withAdditionalKeyDeserializers(KeyDeserializers additional) Convenience method for creating a new factory instance with additional `KeyDeserializers`.

withDeserializerModifier	back to summary
public abstract DeserializerFactory withDeserializerModifier(ValueDeserializerModifier modifier) Convenience method for creating a new factory instance with additional `ValueDeserializerModifier`.

withValueInstantiators	back to summary
public abstract DeserializerFactory withValueInstantiators(ValueInstantiators instantiators) Convenience method for creating a new factory instance with additional `ValueInstantiators`.

public abstract Class DeserializerFactory

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail