org.codehaus.jackson.map.deser

类 StdDeserializerProvider

java.lang.Object

org.codehaus.jackson.map.DeserializerProvider

org.codehaus.jackson.map.deser.StdDeserializerProvider

public class StdDeserializerProvider
extends DeserializerProvider

Default DeserializerProvider implementation. Handles low-level caching (non-root) aspects of deserializer handling; all construction details are delegated to configured DeserializerFactory instance that the provider owns.

嵌套类概要

嵌套类

限定符和类型	类和说明
protected static class	StdDeserializerProvider.WrappedDeserializer Simple deserializer that will call configured type deserializer, passing in configured data deserializer, and exposing it all as a simple deserializer.

字段概要

字段

限定符和类型	字段和说明
protected ConcurrentHashMap<JavaType,JsonDeserializer<Object>>	_cachedDeserializers We will also cache some dynamically constructed deserializers; specifically, ones that are expensive to construct.
protected DeserializerFactory	_factory Factory responsible for constructing actual deserializers, if not one of pre-configured types.
protected HashMap<JavaType,JsonDeserializer<Object>>	_incompleteDeserializers During deserializer construction process we may need to keep track of partially completed deserializers, to resolve cyclic dependencies.
protected RootNameLookup	_rootNames

构造器概要

构造器

构造器和说明
StdDeserializerProvider() Default constructor.
StdDeserializerProvider(DeserializerFactory f)

方法概要

方法

限定符和类型	方法和说明
protected JsonDeserializer<Object>	_createAndCache2(DeserializationConfig config, JavaType type, BeanProperty property) Method that handles actual construction (via factory) and caching (both intermediate and eventual)
protected JsonDeserializer<Object>	_createAndCacheValueDeserializer(DeserializationConfig config, JavaType type, BeanProperty property) Method that will try to create a deserializer for given type, and resolve and cache it if necessary
protected JsonDeserializer<Object>	_createDeserializer(DeserializationConfig config, JavaType type, BeanProperty property)
protected JsonDeserializer<Object>	_findCachedDeserializer(JavaType type)
protected KeyDeserializer	_handleUnknownKeyDeserializer(JavaType type)
protected JsonDeserializer<Object>	_handleUnknownValueDeserializer(JavaType type)
protected void	_resolveDeserializer(DeserializationConfig config, ResolvableDeserializer ser)
int	cachedDeserializersCount() Method that can be used to determine how many deserializers this provider is caching currently (if it does caching: default implementation does) Exact count depends on what kind of deserializers get cached; default implementation caches only dynamically constructed deserializers, but not eagerly constructed standard deserializers (which is different from how serializer provider works).
SerializedString	findExpectedRootName(DeserializationConfig config, JavaType type) Method that can be used to try find expected root name for given type
KeyDeserializer	findKeyDeserializer(DeserializationConfig config, JavaType type, BeanProperty property) Method called to get hold of a deserializer to use for deserializing keys for Map.
JsonDeserializer<Object>	findTypedValueDeserializer(DeserializationConfig config, JavaType type, BeanProperty property) Method called to locate deserializer for given type, as well as matching type deserializer (if one is needed); and if type deserializer is needed, construct a "wrapped" deserializer that can extract and use type information for calling actual deserializer.
JsonDeserializer<Object>	findValueDeserializer(DeserializationConfig config, JavaType propertyType, BeanProperty property) Method called to get hold of a deserializer for a value of given type; or if no such deserializer can be found, a default handler (which may do a best-effort generic serialization or just simply throw an exception when invoked).
void	flushCachedDeserializers() Method that will drop all dynamically constructed deserializers (ones that are counted as result value for cachedDeserializersCount()).
boolean	hasValueDeserializerFor(DeserializationConfig config, JavaType type) Method that can be called to find out whether a deserializer can be found for given type
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).
DeserializerProvider	withAbstractTypeResolver(AbstractTypeResolver resolver)
DeserializerProvider	withAdditionalDeserializers(Deserializers d) Method that is to configure DeserializerFactory that provider has to use specified deserializer provider, with highest precedence (that is, additional providers have higher precedence than default one or previously added ones)
DeserializerProvider	withAdditionalKeyDeserializers(KeyDeserializers d)
DeserializerProvider	withDeserializerModifier(BeanDeserializerModifier modifier)
StdDeserializerProvider	withFactory(DeserializerFactory factory) Method that sub-classes need to override, to ensure that fluent-factory methods will produce proper sub-type.
DeserializerProvider	withValueInstantiators(ValueInstantiators instantiators) Method that will construct a new instance with specified additional value instantiators (i.e. does NOT replace existing ones)

从类继承的方法 java.lang.Object

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

字段详细资料

_cachedDeserializers

protected final ConcurrentHashMap<JavaType,JsonDeserializer<Object>> _cachedDeserializers

We will also cache some dynamically constructed deserializers; specifically, ones that are expensive to construct. This currently means bean and Enum deserializers; array, List and Map deserializers will not be cached.

Given that we don't expect much concurrency for additions (should very quickly converge to zero after startup), let's explicitly define a low concurrency setting.

_incompleteDeserializers

protected final HashMap<JavaType,JsonDeserializer<Object>> _incompleteDeserializers

During deserializer construction process we may need to keep track of partially completed deserializers, to resolve cyclic dependencies. This is the map used for storing deserializers before they are fully complete.

_rootNames

protected final RootNameLookup _rootNames

_factory

protected DeserializerFactory _factory

Factory responsible for constructing actual deserializers, if not one of pre-configured types.

构造器详细资料

StdDeserializerProvider

public StdDeserializerProvider()

Default constructor. Equivalent to calling

   new StdDeserializerProvider(BeanDeserializerFactory.instance);

StdDeserializerProvider

public StdDeserializerProvider(DeserializerFactory f)

方法详细资料

withAdditionalDeserializers

public DeserializerProvider withAdditionalDeserializers(Deserializers d)

从类复制的说明: DeserializerProvider

Method that is to configure DeserializerFactory that provider has to use specified deserializer provider, with highest precedence (that is, additional providers have higher precedence than default one or previously added ones)

指定者:

withAdditionalDeserializers 在类中 DeserializerProvider

withAdditionalKeyDeserializers

public DeserializerProvider withAdditionalKeyDeserializers(KeyDeserializers d)

指定者:

withAdditionalKeyDeserializers 在类中 DeserializerProvider

withDeserializerModifier

public DeserializerProvider withDeserializerModifier(BeanDeserializerModifier modifier)

指定者:

withDeserializerModifier 在类中 DeserializerProvider

withAbstractTypeResolver

public DeserializerProvider withAbstractTypeResolver(AbstractTypeResolver resolver)

指定者:

withAbstractTypeResolver 在类中 DeserializerProvider

withValueInstantiators

public DeserializerProvider withValueInstantiators(ValueInstantiators instantiators)

从类复制的说明: DeserializerProvider

Method that will construct a new instance with specified additional value instantiators (i.e. does NOT replace existing ones)

指定者:

withValueInstantiators 在类中 DeserializerProvider

withFactory

public StdDeserializerProvider withFactory(DeserializerFactory factory)

从类复制的说明: DeserializerProvider

Method that sub-classes need to override, to ensure that fluent-factory methods will produce proper sub-type.

指定者:

withFactory 在类中 DeserializerProvider

mapAbstractType

public JavaType mapAbstractType(DeserializationConfig config,
                       JavaType type)
                         throws JsonMappingException

从类复制的说明: DeserializerProvider

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). Will either return passed type, or a more specific type.

指定者:

mapAbstractType 在类中 DeserializerProvider

抛出:

JsonMappingException

findExpectedRootName

public SerializedString findExpectedRootName(DeserializationConfig config,
                                    JavaType type)
                                      throws JsonMappingException

从类复制的说明: DeserializerProvider

Method that can be used to try find expected root name for given type

指定者:

findExpectedRootName 在类中 DeserializerProvider

抛出:

JsonMappingException

findValueDeserializer

public JsonDeserializer<Object> findValueDeserializer(DeserializationConfig config,
                                             JavaType propertyType,
                                             BeanProperty property)
                                               throws JsonMappingException

从类复制的说明: DeserializerProvider

Method called to get hold of a deserializer for a value of given type; or if no such deserializer can be found, a default handler (which may do a best-effort generic serialization or just simply throw an exception when invoked).

Note: this method is only called for value types; not for keys. Key deserializers can be accessed using DeserializerProvider.findKeyDeserializer(org.codehaus.jackson.map.DeserializationConfig, org.codehaus.jackson.type.JavaType, org.codehaus.jackson.map.BeanProperty).

指定者:

findValueDeserializer 在类中 DeserializerProvider

参数:

config - Deserialization configuration

propertyType - Declared type of the value to deserializer (obtained using 'setter' method signature and/or type annotations

property - Object that represents accessor for property value; field, setter method or constructor parameter.

抛出:

JsonMappingException - if there are fatal problems with accessing suitable deserializer; including that of not finding any serializer

findTypedValueDeserializer

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

从类复制的说明: DeserializerProvider

Method called to locate deserializer for given type, as well as matching type deserializer (if one is needed); and if type deserializer is needed, construct a "wrapped" deserializer that can extract and use type information for calling actual deserializer.

Since this method is only called for root elements, no referral information is taken.

指定者:

findTypedValueDeserializer 在类中 DeserializerProvider

抛出:

JsonMappingException

findKeyDeserializer

public KeyDeserializer findKeyDeserializer(DeserializationConfig config,
                                  JavaType type,
                                  BeanProperty property)
                                    throws JsonMappingException

从类复制的说明: DeserializerProvider

Method called to get hold of a deserializer to use for deserializing keys for Map.

指定者:

findKeyDeserializer 在类中 DeserializerProvider

抛出:

JsonMappingException - if there are fatal problems with accessing suitable key deserializer; including that of not finding any serializer

hasValueDeserializerFor

public boolean hasValueDeserializerFor(DeserializationConfig config,
                              JavaType type)

Method that can be called to find out whether a deserializer can be found for given type

指定者:

hasValueDeserializerFor 在类中 DeserializerProvider

cachedDeserializersCount

public int cachedDeserializersCount()

从类复制的说明: DeserializerProvider

Method that can be used to determine how many deserializers this provider is caching currently (if it does caching: default implementation does) Exact count depends on what kind of deserializers get cached; default implementation caches only dynamically constructed deserializers, but not eagerly constructed standard deserializers (which is different from how serializer provider works).

The main use case for this method is to allow conditional flushing of deserializer cache, if certain number of entries is reached.

指定者:

cachedDeserializersCount 在类中 DeserializerProvider

flushCachedDeserializers

public void flushCachedDeserializers()

Method that will drop all dynamically constructed deserializers (ones that are counted as result value for cachedDeserializersCount()). This can be used to remove memory usage (in case some deserializers are only used once or so), or to force re-construction of deserializers after configuration changes for mapper than owns the provider.

指定者:

flushCachedDeserializers 在类中 DeserializerProvider

从以下版本开始:

1.4

_findCachedDeserializer

protected JsonDeserializer<Object> _findCachedDeserializer(JavaType type)

_createAndCacheValueDeserializer

protected JsonDeserializer<Object> _createAndCacheValueDeserializer(DeserializationConfig config,
                                                        JavaType type,
                                                        BeanProperty property)
                                                             throws JsonMappingException

Method that will try to create a deserializer for given type, and resolve and cache it if necessary

参数:

config - Configuration

type - Type of property to deserializer

property - Property (field, setter, ctor arg) to use deserializer for

抛出:

JsonMappingException

_createAndCache2

protected JsonDeserializer<Object> _createAndCache2(DeserializationConfig config,
                                        JavaType type,
                                        BeanProperty property)
                                             throws JsonMappingException

Method that handles actual construction (via factory) and caching (both intermediate and eventual)

抛出:

JsonMappingException

_createDeserializer

protected JsonDeserializer<Object> _createDeserializer(DeserializationConfig config,
                                           JavaType type,
                                           BeanProperty property)
                                                throws JsonMappingException

抛出:

JsonMappingException

_resolveDeserializer

protected void _resolveDeserializer(DeserializationConfig config,
                        ResolvableDeserializer ser)
                             throws JsonMappingException

抛出:

JsonMappingException

_handleUnknownValueDeserializer

protected JsonDeserializer<Object> _handleUnknownValueDeserializer(JavaType type)
                                                            throws JsonMappingException

抛出:

JsonMappingException

_handleUnknownKeyDeserializer

protected KeyDeserializer _handleUnknownKeyDeserializer(JavaType type)
                                                 throws JsonMappingException

抛出:

JsonMappingException