|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.codehaus.jackson.map.DeserializerFactory
org.codehaus.jackson.map.deser.BasicDeserializerFactory
org.codehaus.jackson.map.deser.BeanDeserializerFactory
org.codehaus.jackson.map.deser.CustomDeserializerFactory
SerializerFactory
(see methods
like SerializerFactory.withAdditionalSerializers(Serializers)
)
and through new Module API. As such, this class is not the best way
to add custom functionality, and will likely be removed from 2.0 release
@Deprecated public class CustomDeserializerFactory
Deserializer factory implementation that allows for configuring
mapping between types and deserializers to use, by using
multiple types of overrides. Existing mappings established by
BeanDeserializerFactory
(and its super class,
BasicDeserializerFactory
) are used if no overrides are
defined.
Unlike base deserializer factories, this factory is stateful because of configuration settings. It is thread-safe, however, as long as all configuration as done before using the factory -- a single instance can be shared between providers and mappers.
Configurations currently available are:
The way custom deserializer factory instances are hooked to
ObjectMapper
is usually by constructing an instance of
DeserializerProvider
(most commonly
StdDeserializerProvider
) with custom deserializer factory,
and setting ObjectMapper
to use it.
Nested Class Summary |
---|
Nested classes/interfaces inherited from class org.codehaus.jackson.map.deser.BeanDeserializerFactory |
---|
BeanDeserializerFactory.ConfigImpl |
Nested classes/interfaces inherited from class org.codehaus.jackson.map.DeserializerFactory |
---|
DeserializerFactory.Config |
Field Summary | |
---|---|
protected HashMap<ClassKey,JsonDeserializer<Object>> |
_directClassMappings
Deprecated. Direct mappings that are used for exact class and interface type matches. |
protected HashMap<ClassKey,Class<?>> |
_mixInAnnotations
Deprecated. Mapping that defines how to apply mix-in annotations: key is the type to received additional annotations, and value is the type that has annotations to "mix in". |
Fields inherited from class org.codehaus.jackson.map.deser.BeanDeserializerFactory |
---|
_factoryConfig, instance |
Fields inherited from class org.codehaus.jackson.map.deser.BasicDeserializerFactory |
---|
_arrayDeserializers, optionalHandlers |
Fields inherited from class org.codehaus.jackson.map.DeserializerFactory |
---|
NO_DESERIALIZERS |
Constructor Summary | |
---|---|
|
CustomDeserializerFactory()
Deprecated. |
protected |
CustomDeserializerFactory(DeserializerFactory.Config config)
Deprecated. |
Method Summary | ||
---|---|---|
void |
addMixInAnnotationMapping(Class<?> destinationClass,
Class<?> classWithMixIns)
Deprecated. Method to use for adding mix-in annotations that Class classWithMixIns contains into class
destinationClass . |
|
|
addSpecificMapping(Class<T> forClass,
JsonDeserializer<? extends T> deser)
Deprecated. Method used to add a mapping for specific type -- and only that type -- to use specified deserializer. |
|
JsonDeserializer<?> |
createArrayDeserializer(DeserializationConfig config,
DeserializerProvider p,
ArrayType type,
BeanProperty property)
Deprecated. Method called to create (or, for completely immutable deserializers, reuse) a deserializer that can convert JSON content into values of specified Java type. |
|
JsonDeserializer<Object> |
createBeanDeserializer(DeserializationConfig config,
DeserializerProvider p,
JavaType type,
BeanProperty property)
Deprecated. Method that DeserializerProvider s call to create a new
deserializer for types other than Collections, Maps, arrays and
enums. |
|
JsonDeserializer<?> |
createEnumDeserializer(DeserializationConfig config,
DeserializerProvider p,
JavaType enumType,
BeanProperty property)
Deprecated. Factory method for constructing serializers of Enum types. |
|
DeserializerFactory |
withConfig(DeserializerFactory.Config config)
Deprecated. Method used by module registration functionality, to construct a new bean deserializer factory with different configuration settings. |
Methods inherited from class org.codehaus.jackson.map.DeserializerFactory |
---|
createArrayDeserializer, createBeanDeserializer, createCollectionDeserializer, createEnumDeserializer, createMapDeserializer, createTreeDeserializer, findTypeDeserializer, withAbstractTypeResolver, withAdditionalDeserializers, withAdditionalKeyDeserializers, withDeserializerModifier |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
protected HashMap<ClassKey,JsonDeserializer<Object>> _directClassMappings
protected HashMap<ClassKey,Class<?>> _mixInAnnotations
Annotations associated with the value classes will be used to override annotations of the key class, associated with the same field or method. They can be further masked by sub-classes: you can think of it as injecting annotations between the target class and its sub-classes (or interfaces)
Constructor Detail |
---|
public CustomDeserializerFactory()
protected CustomDeserializerFactory(DeserializerFactory.Config config)
Method Detail |
---|
public DeserializerFactory withConfig(DeserializerFactory.Config config)
BeanDeserializerFactory
withConfig
in class BeanDeserializerFactory
public <T> void addSpecificMapping(Class<T> forClass, JsonDeserializer<? extends T> deser)
Note that both class and interfaces can be mapped, since the type is derived from method declarations; and hence may be abstract types and interfaces. This is different from custom serialization where only class types can be directly mapped.
forClass
- Class to deserialize using specific deserializer.deser
- Deserializer to use for the class. Declared type for
deserializer may be more specific (sub-class) than declared class
to map, since that will still be compatible (deserializer produces
sub-class which is assignable to field/method)public void addMixInAnnotationMapping(Class<?> destinationClass, Class<?> classWithMixIns)
classWithMixIns
contains into class
destinationClass
. Mixing in is done when introspecting
class annotations and properties.
Annotations from classWithMixIns
(and its supertypes)
will override
anything destinationClass
(and its super-types)
has already.
destinationClass
- Class to modify by adding annotationsclassWithMixIns
- Class that contains annotations to addpublic JsonDeserializer<Object> createBeanDeserializer(DeserializationConfig config, DeserializerProvider p, JavaType type, BeanProperty property) throws JsonMappingException
BeanDeserializerFactory
DeserializerProvider
s call to create a new
deserializer for types other than Collections, Maps, arrays and
enums.
createBeanDeserializer
in class BeanDeserializerFactory
p
- Provider that can be called to create deserializers for
contained member typestype
- Type to be deserialized
JsonMappingException
public JsonDeserializer<?> createArrayDeserializer(DeserializationConfig config, DeserializerProvider p, ArrayType type, BeanProperty property) throws JsonMappingException
DeserializerFactory
createArrayDeserializer
in class BasicDeserializerFactory
p
- Provider that can be called to create deserializers for
contained member typestype
- Type to be deserialized
JsonMappingException
public JsonDeserializer<?> createEnumDeserializer(DeserializationConfig config, DeserializerProvider p, JavaType enumType, BeanProperty property) throws JsonMappingException
BasicDeserializerFactory
Enum
types.
createEnumDeserializer
in class BasicDeserializerFactory
JsonMappingException
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |