public abstract class DeserializerFactory extends Object
DeserializerProvider
to obtain actual
JsonDeserializer
instances from multiple distinct factories.
Since there are multiple broad categories of deserializers, there are multiple factory methods:
createArrayDeserializer(org.codehaus.jackson.map.DeserializationConfig, org.codehaus.jackson.map.DeserializerProvider, org.codehaus.jackson.map.type.ArrayType, org.codehaus.jackson.map.BeanProperty)
)
and the other for other Java containers like List
s
and Set
s (createCollectionDeserializer(DeserializationConfig, DeserializerProvider, CollectionType, BeanProperty)
)
Map
s
(createMapDeserializer(org.codehaus.jackson.map.DeserializationConfig, org.codehaus.jackson.map.DeserializerProvider, org.codehaus.jackson.map.type.MapType, org.codehaus.jackson.map.BeanProperty)
), and another for POJOs
(createBeanDeserializer(DeserializationConfig, DeserializerProvider, JavaType, BeanProperty)
.
JsonNode
) properties there is
createTreeDeserializer(DeserializationConfig, DeserializerProvider, JavaType, BeanProperty)
Enum
) there is
createEnumDeserializer(DeserializationConfig, DeserializerProvider, JavaType, BeanProperty)
createBeanDeserializer(DeserializationConfig, DeserializerProvider, JavaType, BeanProperty)
is used.
All above methods take 2 type arguments, except for the first one which takes just a single argument.
Modifier and Type | Class and Description |
---|---|
static class |
DeserializerFactory.Config
Configuration settings container class for bean deserializer factory
|
Modifier and Type | Field and Description |
---|---|
protected static Deserializers[] |
NO_DESERIALIZERS |
Constructor and Description |
---|
DeserializerFactory() |
Modifier and Type | Method and Description |
---|---|
abstract JsonDeserializer<?> |
createArrayDeserializer(DeserializationConfig config,
DeserializerProvider p,
ArrayType type,
BeanProperty property)
Method called to create (or, for completely immutable deserializers,
reuse) a deserializer that can convert JSON content into values of
specified Java type.
|
abstract JsonDeserializer<Object> |
createBeanDeserializer(DeserializationConfig config,
DeserializerProvider p,
JavaType type,
BeanProperty property)
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.
|
abstract JsonDeserializer<?> |
createCollectionDeserializer(DeserializationConfig config,
DeserializerProvider p,
CollectionType type,
BeanProperty property) |
abstract JsonDeserializer<?> |
createCollectionLikeDeserializer(DeserializationConfig config,
DeserializerProvider p,
CollectionLikeType type,
BeanProperty property) |
abstract JsonDeserializer<?> |
createEnumDeserializer(DeserializationConfig config,
DeserializerProvider p,
JavaType type,
BeanProperty property) |
KeyDeserializer |
createKeyDeserializer(DeserializationConfig config,
JavaType type,
BeanProperty property)
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.
|
abstract JsonDeserializer<?> |
createMapDeserializer(DeserializationConfig config,
DeserializerProvider p,
MapType type,
BeanProperty property) |
abstract JsonDeserializer<?> |
createMapLikeDeserializer(DeserializationConfig config,
DeserializerProvider p,
MapLikeType type,
BeanProperty property) |
abstract JsonDeserializer<?> |
createTreeDeserializer(DeserializationConfig config,
DeserializerProvider p,
JavaType type,
BeanProperty property)
Method called to create and return a deserializer that can construct
JsonNode(s) from JSON content.
|
TypeDeserializer |
findTypeDeserializer(DeserializationConfig config,
JavaType baseType,
BeanProperty property)
Method called to find and create a type information deserializer for given base type,
if one is needed.
|
abstract ValueInstantiator |
findValueInstantiator(DeserializationConfig config,
BasicBeanDescription beanDesc)
Method that is to find all creators (constructors, factory methods)
for the bean type to deserialize.
|
abstract DeserializerFactory.Config |
getConfig() |
abstract JavaType |
mapAbstractType(DeserializationConfig config,
JavaType type)
Method that can be called to try to resolve an abstract type
(interface, abstract class) into a concrete type, or at least
something "more concrete" (abstract class instead of interface).
|
DeserializerFactory |
withAbstractTypeResolver(AbstractTypeResolver resolver)
Convenience method for creating a new factory instance with additional
AbstractTypeResolver . |
DeserializerFactory |
withAdditionalDeserializers(Deserializers additional)
Convenience method for creating a new factory instance with additional deserializer
provider.
|
DeserializerFactory |
withAdditionalKeyDeserializers(KeyDeserializers additional)
Convenience method for creating a new factory instance with additional
KeyDeserializers . |
abstract DeserializerFactory |
withConfig(DeserializerFactory.Config config)
Method used for creating a new instance of this factory, but with different
configuration.
|
DeserializerFactory |
withDeserializerModifier(BeanDeserializerModifier modifier)
Convenience method for creating a new factory instance with additional
BeanDeserializerModifier . |
DeserializerFactory |
withValueInstantiators(ValueInstantiators instantiators)
Convenience method for creating a new factory instance with additional
ValueInstantiators . |
protected static final Deserializers[] NO_DESERIALIZERS
public abstract DeserializerFactory.Config getConfig()
public abstract DeserializerFactory withConfig(DeserializerFactory.Config config)
Note that custom sub-classes must override implementation
of this method, as it usually requires instantiating a new instance of
factory type. Check out javadocs for
BeanDeserializerFactory
for more details.
public final DeserializerFactory withAdditionalDeserializers(Deserializers additional)
public final DeserializerFactory withAdditionalKeyDeserializers(KeyDeserializers additional)
KeyDeserializers
.public final DeserializerFactory withDeserializerModifier(BeanDeserializerModifier modifier)
BeanDeserializerModifier
.public final DeserializerFactory withAbstractTypeResolver(AbstractTypeResolver resolver)
AbstractTypeResolver
.public final DeserializerFactory withValueInstantiators(ValueInstantiators instantiators)
ValueInstantiators
.public abstract JavaType mapAbstractType(DeserializationConfig config, JavaType type) throws JsonMappingException
JsonMappingException
public abstract ValueInstantiator findValueInstantiator(DeserializationConfig config, BasicBeanDescription beanDesc) throws JsonMappingException
JsonMappingException
public abstract JsonDeserializer<Object> createBeanDeserializer(DeserializationConfig config, DeserializerProvider p, JavaType type, BeanProperty property) throws JsonMappingException
type
- Type to be deserializedp
- Provider that can be called to create deserializers for
contained member typesJsonMappingException
public abstract JsonDeserializer<?> createArrayDeserializer(DeserializationConfig config, DeserializerProvider p, ArrayType type, BeanProperty property) throws JsonMappingException
type
- Type to be deserializedp
- Provider that can be called to create deserializers for
contained member typesJsonMappingException
public abstract JsonDeserializer<?> createCollectionDeserializer(DeserializationConfig config, DeserializerProvider p, CollectionType type, BeanProperty property) throws JsonMappingException
JsonMappingException
public abstract JsonDeserializer<?> createCollectionLikeDeserializer(DeserializationConfig config, DeserializerProvider p, CollectionLikeType type, BeanProperty property) throws JsonMappingException
JsonMappingException
public abstract JsonDeserializer<?> createEnumDeserializer(DeserializationConfig config, DeserializerProvider p, JavaType type, BeanProperty property) throws JsonMappingException
JsonMappingException
public abstract JsonDeserializer<?> createMapDeserializer(DeserializationConfig config, DeserializerProvider p, MapType type, BeanProperty property) throws JsonMappingException
JsonMappingException
public abstract JsonDeserializer<?> createMapLikeDeserializer(DeserializationConfig config, DeserializerProvider p, MapLikeType type, BeanProperty property) throws JsonMappingException
JsonMappingException
public abstract JsonDeserializer<?> createTreeDeserializer(DeserializationConfig config, DeserializerProvider p, JavaType type, BeanProperty property) throws JsonMappingException
JsonMappingException
public KeyDeserializer createKeyDeserializer(DeserializationConfig config, JavaType type, BeanProperty property) throws JsonMappingException
JsonMappingException
public TypeDeserializer findTypeDeserializer(DeserializationConfig config, JavaType baseType, BeanProperty property) throws JsonMappingException
Note that this method is usually only directly called for values of container (Collection, array, Map) types and root values, but not for bean property values.
baseType
- Declared base type of the value to deserializer (actual
deserializer type will be this type or its subtype)JsonMappingException