org.codehaus.jackson.map.deser
Class BeanDeserializerFactory

java.lang.Object
  org.codehaus.jackson.map.DeserializerFactory
      org.codehaus.jackson.map.deser.BasicDeserializerFactory
          org.codehaus.jackson.map.deser.BeanDeserializerFactory

Direct Known Subclasses:

CustomDeserializerFactory

public class BeanDeserializerFactory
extends BasicDeserializerFactory

Concrete deserializer factory class that adds full Bean deserializer construction logic using class introspection.

Since there is no caching, this factory is stateless and a globally shared singleton instance (instance) can be used by DeserializerProviders).

Nested Class Summary

static class

BeanDeserializerFactory.ConfigImpl Standard configuration settings container class implementation.

Nested classes/interfaces inherited from class org.codehaus.jackson.map.DeserializerFactory

DeserializerFactory.Config

Field Summary

protected DeserializerFactory.Config	_factoryConfig Configuration settings for this factory; immutable instance (just like this factory), new version created via copy-constructor (fluent-style)
static BeanDeserializerFactory	instance Globally shareable thread-safe instance which has no additional custom deserializers registered

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

BeanDeserializerFactory()
Deprecated.

BeanDeserializerFactory(DeserializerFactory.Config config)

Method Summary

protected void	_addDeserializerConstructors(DeserializationConfig config, BasicBeanDescription beanDesc, VisibilityChecker<?> vchecker, AnnotationIntrospector intr, CreatorContainer creators)
protected void	_addDeserializerFactoryMethods(DeserializationConfig config, BasicBeanDescription beanDesc, VisibilityChecker<?> vchecker, AnnotationIntrospector intr, CreatorContainer creators)
protected JsonDeserializer<?>	_findCustomArrayDeserializer(ArrayType type, DeserializationConfig config, DeserializerProvider provider, BeanProperty property, TypeDeserializer elementTypeDeserializer, JsonDeserializer<?> elementDeserializer)
protected JsonDeserializer<Object>	_findCustomBeanDeserializer(JavaType type, DeserializationConfig config, DeserializerProvider provider, BasicBeanDescription beanDesc, BeanProperty property)
protected JsonDeserializer<?>	_findCustomCollectionDeserializer(CollectionType type, DeserializationConfig config, DeserializerProvider provider, BasicBeanDescription beanDesc, BeanProperty property, TypeDeserializer elementTypeDeserializer, JsonDeserializer<?> elementDeserializer)
protected JsonDeserializer<?>	_findCustomEnumDeserializer(Class<?> type, DeserializationConfig config, BasicBeanDescription beanDesc, BeanProperty property)
protected JsonDeserializer<?>	_findCustomMapDeserializer(MapType type, DeserializationConfig config, DeserializerProvider provider, BasicBeanDescription beanDesc, BeanProperty property, KeyDeserializer keyDeserializer, TypeDeserializer elementTypeDeserializer, JsonDeserializer<?> elementDeserializer)
protected JsonDeserializer<?>	_findCustomTreeNodeDeserializer(Class<? extends JsonNode> type, DeserializationConfig config, BeanProperty property)
protected void	addBeanProps(DeserializationConfig config, BasicBeanDescription beanDesc, BeanDeserializerBuilder builder) Method called to figure out settable properties for the bean deserializer to use.
protected void	addReferenceProperties(DeserializationConfig config, BasicBeanDescription beanDesc, BeanDeserializerBuilder builder) Method that will find if bean has any managed- or back-reference properties, and if so add them to bean, to be linked during resolution phase.
JsonDeserializer<Object>	buildBeanDeserializer(DeserializationConfig config, JavaType type, BasicBeanDescription beanDesc, BeanProperty property) Method that is to actually build a bean deserializer instance.
JsonDeserializer<Object>	buildThrowableDeserializer(DeserializationConfig config, JavaType type, BasicBeanDescription beanDesc, BeanProperty property)
protected SettableAnyProperty	constructAnySetter(DeserializationConfig config, BasicBeanDescription beanDesc, AnnotatedMethod setter) Method called to construct fallback SettableAnyProperty for handling unknown bean properties, given a method that has been designated as such setter.
protected BeanDeserializerBuilder	constructBeanDeserializerBuilder(BasicBeanDescription beanDesc) Overridable method that constructs a BeanDeserializerBuilder which is used to accumulate information needed to create deserializer instance.
protected SettableBeanProperty	constructSettableProperty(DeserializationConfig config, BasicBeanDescription beanDesc, String name, AnnotatedField field)
protected SettableBeanProperty	constructSettableProperty(DeserializationConfig config, BasicBeanDescription beanDesc, String name, AnnotatedMethod setter) Method that will construct a regular bean property setter using the given setter method.
protected SettableBeanProperty	constructSetterlessProperty(DeserializationConfig config, BasicBeanDescription beanDesc, String name, AnnotatedMethod getter) Method that will construct a regular bean property setter using the given setter method.
JsonDeserializer<Object>	createBeanDeserializer(DeserializationConfig config, DeserializerProvider p, JavaType type, BeanProperty property) Method that DeserializerProviders call to create a new deserializer for types other than Collections, Maps, arrays and enums.
protected CreatorContainer	findDeserializerCreators(DeserializationConfig config, BasicBeanDescription beanDesc) Method that is to find all creators (constructors, factory methods) for the bean type to deserialize.
DeserializerFactory.Config	getConfig()
protected boolean	isIgnorableType(DeserializationConfig config, BasicBeanDescription beanDesc, Class<?> type, Map<Class<?>,Boolean> ignoredTypes) Helper method that will check whether given raw type is marked as always ignorable (for purpose of ignoring properties with type)
protected boolean	isPotentialBeanType(Class<?> type) Helper method used to skip processing for types that we know can not be (i.e.
DeserializerFactory	withConfig(DeserializerFactory.Config config) 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.deser.BasicDeserializerFactory

constructCreatorProperty, constructEnumResolver, createArrayDeserializer, createCollectionDeserializer, createEnumDeserializer, createMapDeserializer, createTreeDeserializer, findDeserializerFromAnnotation, findMapCreators, findPropertyContentTypeDeserializer, findPropertyTypeDeserializer, findTypeDeserializer, modifyTypeByAnnotation, resolveType

Methods inherited from class org.codehaus.jackson.map.DeserializerFactory

createArrayDeserializer, createBeanDeserializer, createCollectionDeserializer, createEnumDeserializer, createMapDeserializer, createTreeDeserializer, findTypeDeserializer, withAdditionalDeserializers, withDeserializerModifier

Methods inherited from class java.lang.Object

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

Field Detail

instance

public static final BeanDeserializerFactory instance

Globally shareable thread-safe instance which has no additional custom deserializers registered

_factoryConfig

protected final DeserializerFactory.Config _factoryConfig

Configuration settings for this factory; immutable instance (just like this factory), new version created via copy-constructor (fluent-style)

Since:

1.7

Constructor Detail

BeanDeserializerFactory

@Deprecated
public BeanDeserializerFactory()

Deprecated.

BeanDeserializerFactory

public BeanDeserializerFactory(DeserializerFactory.Config config)

Since:

1.7

Method Detail

getConfig

public final DeserializerFactory.Config getConfig()

Specified by:

getConfig in class DeserializerFactory

withConfig

public DeserializerFactory withConfig(DeserializerFactory.Config config)

Method used by module registration functionality, to construct a new bean deserializer factory with different configuration settings.

Specified by:

withConfig in class BasicDeserializerFactory

Since:

1.7

_findCustomArrayDeserializer

protected JsonDeserializer<?> _findCustomArrayDeserializer(ArrayType type,
                                                           DeserializationConfig config,
                                                           DeserializerProvider provider,
                                                           BeanProperty property,
                                                           TypeDeserializer elementTypeDeserializer,
                                                           JsonDeserializer<?> elementDeserializer)
                                                    throws JsonMappingException

Specified by:

_findCustomArrayDeserializer in class BasicDeserializerFactory

Throws:

JsonMappingException

_findCustomCollectionDeserializer

protected JsonDeserializer<?> _findCustomCollectionDeserializer(CollectionType type,
                                                                DeserializationConfig config,
                                                                DeserializerProvider provider,
                                                                BasicBeanDescription beanDesc,
                                                                BeanProperty property,
                                                                TypeDeserializer elementTypeDeserializer,
                                                                JsonDeserializer<?> elementDeserializer)
                                                         throws JsonMappingException

Specified by:

_findCustomCollectionDeserializer in class BasicDeserializerFactory

Throws:

JsonMappingException

_findCustomEnumDeserializer

protected JsonDeserializer<?> _findCustomEnumDeserializer(Class<?> type,
                                                          DeserializationConfig config,
                                                          BasicBeanDescription beanDesc,
                                                          BeanProperty property)
                                                   throws JsonMappingException

Specified by:

_findCustomEnumDeserializer in class BasicDeserializerFactory

Throws:

JsonMappingException

_findCustomMapDeserializer

protected JsonDeserializer<?> _findCustomMapDeserializer(MapType type,
                                                         DeserializationConfig config,
                                                         DeserializerProvider provider,
                                                         BasicBeanDescription beanDesc,
                                                         BeanProperty property,
                                                         KeyDeserializer keyDeserializer,
                                                         TypeDeserializer elementTypeDeserializer,
                                                         JsonDeserializer<?> elementDeserializer)
                                                  throws JsonMappingException

Specified by:

_findCustomMapDeserializer in class BasicDeserializerFactory

Throws:

JsonMappingException

_findCustomTreeNodeDeserializer

protected JsonDeserializer<?> _findCustomTreeNodeDeserializer(Class<? extends JsonNode> type,
                                                              DeserializationConfig config,
                                                              BeanProperty property)
                                                       throws JsonMappingException

Specified by:

_findCustomTreeNodeDeserializer in class BasicDeserializerFactory

Throws:

JsonMappingException

_findCustomBeanDeserializer

protected JsonDeserializer<Object> _findCustomBeanDeserializer(JavaType type,
                                                               DeserializationConfig config,
                                                               DeserializerProvider provider,
                                                               BasicBeanDescription beanDesc,
                                                               BeanProperty property)
                                                        throws JsonMappingException

Throws:

JsonMappingException

createBeanDeserializer

public JsonDeserializer<Object> createBeanDeserializer(DeserializationConfig config,
                                                       DeserializerProvider p,
                                                       JavaType type,
                                                       BeanProperty property)
                                                throws JsonMappingException

Method that DeserializerProviders call to create a new deserializer for types other than Collections, Maps, arrays and enums.

Overrides:

createBeanDeserializer in class BasicDeserializerFactory

p - Provider that can be called to create deserializers for contained member types

type - Type to be deserialized

Throws:

JsonMappingException

buildBeanDeserializer

public JsonDeserializer<Object> buildBeanDeserializer(DeserializationConfig config,
                                                      JavaType type,
                                                      BasicBeanDescription beanDesc,
                                                      BeanProperty property)
                                               throws JsonMappingException

Method that is to actually build a bean deserializer instance. All basic sanity checks have been done to know that what we have may be a valid bean type, and that there are no default simple deserializers.

Throws:

JsonMappingException

buildThrowableDeserializer

public JsonDeserializer<Object> buildThrowableDeserializer(DeserializationConfig config,
                                                           JavaType type,
                                                           BasicBeanDescription beanDesc,
                                                           BeanProperty property)
                                                    throws JsonMappingException

Throws:

JsonMappingException

constructBeanDeserializerBuilder

protected BeanDeserializerBuilder constructBeanDeserializerBuilder(BasicBeanDescription beanDesc)

Overridable method that constructs a BeanDeserializerBuilder which is used to accumulate information needed to create deserializer instance.

Since:

1.7

findDeserializerCreators

protected CreatorContainer findDeserializerCreators(DeserializationConfig config,
                                                    BasicBeanDescription beanDesc)
                                             throws JsonMappingException

Method that is to find all creators (constructors, factory methods) for the bean type to deserialize.

Throws:

JsonMappingException

Since:

1.7

_addDeserializerConstructors

protected void _addDeserializerConstructors(DeserializationConfig config,
                                            BasicBeanDescription beanDesc,
                                            VisibilityChecker<?> vchecker,
                                            AnnotationIntrospector intr,
                                            CreatorContainer creators)
                                     throws JsonMappingException

Throws:

JsonMappingException

_addDeserializerFactoryMethods

protected void _addDeserializerFactoryMethods(DeserializationConfig config,
                                              BasicBeanDescription beanDesc,
                                              VisibilityChecker<?> vchecker,
                                              AnnotationIntrospector intr,
                                              CreatorContainer creators)
                                       throws JsonMappingException

Throws:

JsonMappingException

addBeanProps

protected void addBeanProps(DeserializationConfig config,
                            BasicBeanDescription beanDesc,
                            BeanDeserializerBuilder builder)
                     throws JsonMappingException

Method called to figure out settable properties for the bean deserializer to use.

Note: designed to be overridable, and effort is made to keep interface similar between versions.

Throws:

JsonMappingException

addReferenceProperties

protected void addReferenceProperties(DeserializationConfig config,
                                      BasicBeanDescription beanDesc,
                                      BeanDeserializerBuilder builder)
                               throws JsonMappingException

Method that will find if bean has any managed- or back-reference properties, and if so add them to bean, to be linked during resolution phase.

Throws:

JsonMappingException

Since:

1.6

constructAnySetter

protected SettableAnyProperty constructAnySetter(DeserializationConfig config,
                                                 BasicBeanDescription beanDesc,
                                                 AnnotatedMethod setter)
                                          throws JsonMappingException

Method called to construct fallback SettableAnyProperty for handling unknown bean properties, given a method that has been designated as such setter.

Throws:

JsonMappingException

constructSettableProperty

protected SettableBeanProperty constructSettableProperty(DeserializationConfig config,
                                                         BasicBeanDescription beanDesc,
                                                         String name,
                                                         AnnotatedMethod setter)
                                                  throws JsonMappingException

Method that will construct a regular bean property setter using the given setter method.

Parameters:

setter - Method to use to set property value; or null if none. Null only for "setterless" properties

Returns:

Property constructed, if any; or null to indicate that there should be no property based on given definitions.

Throws:

JsonMappingException

constructSettableProperty

protected SettableBeanProperty constructSettableProperty(DeserializationConfig config,
                                                         BasicBeanDescription beanDesc,
                                                         String name,
                                                         AnnotatedField field)
                                                  throws JsonMappingException

Throws:

JsonMappingException

constructSetterlessProperty

protected SettableBeanProperty constructSetterlessProperty(DeserializationConfig config,
                                                           BasicBeanDescription beanDesc,
                                                           String name,
                                                           AnnotatedMethod getter)
                                                    throws JsonMappingException

Method that will construct a regular bean property setter using the given setter method.

Parameters:

getter - Method to use to get property value to modify, null if none. Non-null for "setterless" properties.

Throws:

JsonMappingException

isPotentialBeanType

protected boolean isPotentialBeanType(Class<?> type)

Helper method used to skip processing for types that we know can not be (i.e. are never consider to be) beans: things like primitives, Arrays, Enums, and proxy types.

Note that usually we shouldn't really be getting these sort of types anyway; but better safe than sorry.

isIgnorableType

protected boolean isIgnorableType(DeserializationConfig config,
                                  BasicBeanDescription beanDesc,
                                  Class<?> type,
                                  Map<Class<?>,Boolean> ignoredTypes)

Helper method that will check whether given raw type is marked as always ignorable (for purpose of ignoring properties with type)