DeserializationContext (jackson-databind 2.7.0 API)

java.lang.Object
- com.fasterxml.jackson.databind.DatabindContext
- - com.fasterxml.jackson.databind.DeserializationContext

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

DefaultDeserializationContext
```
public abstract class DeserializationContext
extends DatabindContext
implements Serializable
```
Context for the process of deserialization a single root-level value. Used to allow passing in configuration settings and reusable temporary objects (scrap arrays, containers).
Instance life-cycle is such that an partially configured "blueprint" object is registered with ObjectMapper (and ObjectReader, and when an actual instance is needed for deserialization, a fully configured instance will be created using a method in excented API of sub-class (DefaultDeserializationContext.createInstance(com.fasterxml.jackson.databind.DeserializationConfig, com.fasterxml.jackson.core.JsonParser, com.fasterxml.jackson.databind.InjectableValues)). Each instance is guaranteed to only be used from single-threaded context; instances may be reused iff no configuration has changed.
Defined as abstract class so that implementations must define methods for reconfiguring blueprints and creating instances.

See Also:
Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`protected ArrayBuilders`	`_arrayBuilders`
`protected ContextAttributes`	`_attributes` Lazily-constructed holder for per-call attributes.
`protected DeserializerCache`	`_cache` Object that handle details of `JsonDeserializer` caching.
`protected DeserializationConfig`	`_config` Generic deserialization processing configuration
`protected LinkedNode<JavaType>`	`_currentType` Type of `JsonDeserializer` (or, more specifically, `ContextualDeserializer`) that is being contextualized currently.
`protected DateFormat`	`_dateFormat`
`protected DeserializerFactory`	`_factory` Read-only factory instance; exposed to let owners (`ObjectMapper`, `ObjectReader`) access it.
`protected int`	`_featureFlags` Bitmap of `DeserializationFeature`s that are enabled
`protected InjectableValues`	`_injectableValues` Object used for resolving references to injectable values.
`protected ObjectBuffer`	`_objectBuffer`
`protected JsonParser`	`_parser` Currently active parser used for deserialization.
`protected Class<?>`	`_view` Currently active view, if any.

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`DeserializationContext(DeserializationContext src)` Copy-constructor for use with `copy()` by `ObjectMapper.copy()`
`protected`	`DeserializationContext(DeserializationContext src, DeserializationConfig config, JsonParser p, InjectableValues injectableValues)` Constructor used for creating actual per-call instances.
`protected`	`DeserializationContext(DeserializationContext src, DeserializerFactory factory)`
`protected`	`DeserializationContext(DeserializerFactory df)`
`protected`	`DeserializationContext(DeserializerFactory df, DeserializerCache cache)`

Method Summary

Methods
Modifier and Type	Method and Description
`protected String`	`_calcName(Class<?> cls)`
`protected String`	`_desc(String desc)`
`protected String`	`_quotedString(String desc)`
`protected String`	`_valueDesc()`
`boolean`	`canOverrideAccessModifiers()` Convenience method for accessing serialization view in use (if any); equivalent to:
`abstract void`	`checkUnresolvedObjectId()` Method called to ensure that every object id encounter during processing are resolved.
`Calendar`	`constructCalendar(Date d)` Convenience method for constructing Calendar instance set to specified time, to be modified and used by caller.
`JavaType`	`constructType(Class<?> cls)` Convenience method, functionally equivalent to:
`abstract JsonDeserializer<Object>`	`deserializerInstance(Annotated annotated, Object deserDef)`
`protected String`	`determineClassName(Object instance)`
`JsonMappingException`	`endOfInputException(Class<?> instClass)`
`Class<?>`	`findClass(String className)` Helper method that is to be used when resolving basic class name into Class instance, the reason being that it may be necessary to work around various ClassLoader limitations, as well as to handle primitive type signatures.
`JsonDeserializer<Object>`	`findContextualValueDeserializer(JavaType type, BeanProperty prop)` Method for finding a value deserializer, and creating a contextual version if necessary, for value reached via specified property.
`Object`	`findInjectableValue(Object valueId, BeanProperty forProperty, Object beanInstance)`
`KeyDeserializer`	`findKeyDeserializer(JavaType keyType, BeanProperty prop)` Convenience method, functionally same as:
`JsonDeserializer<Object>`	`findNonContextualValueDeserializer(JavaType type)` Variant that will try to locate deserializer for current type, but without performing any contextualization (unlike `findContextualValueDeserializer(com.fasterxml.jackson.databind.JavaType, com.fasterxml.jackson.databind.BeanProperty)`) or checking for need to create a `TypeDeserializer` (unlike `findRootValueDeserializer(JavaType)`.
`abstract ReadableObjectId`	`findObjectId(Object id, ObjectIdGenerator<?> generator)` Deprecated.
`abstract ReadableObjectId`	`findObjectId(Object id, ObjectIdGenerator<?> generator, ObjectIdResolver resolver)` Method called to find and return entry corresponding to given Object Id: will add an entry if necessary, and never returns null
`JsonDeserializer<Object>`	`findRootValueDeserializer(JavaType type)` Method for finding a deserializer for root-level value.
`Class<?>`	`getActiveView()` Accessor for locating currently active view, if any; returns null if no view has been set.
`AnnotationIntrospector`	`getAnnotationIntrospector()` Convenience method for accessing serialization view in use (if any); equivalent to:
`ArrayBuilders`	`getArrayBuilders()` Method for accessing object useful for building arrays of primitive types (such as int[]).
`Object`	`getAttribute(Object key)` Method for accessing attributes available in this context.
`Base64Variant`	`getBase64Variant()` Convenience method for accessing the default Base64 encoding used for decoding base64 encoded binary content.
`DeserializationConfig`	`getConfig()` Accessor to currently active configuration (both per-request configs and per-mapper config).
`JavaType`	`getContextualType()` Accessor to `JavaType` of currently contextualized `ContextualDeserializer`, if any.
`protected DateFormat`	`getDateFormat()`
`JsonFormat.Value`	`getDefaultPropertyFormat(Class<?> baseType)`
`int`	`getDeserializationFeatures()` Bulk access method for getting the bit mask of all `DeserializationFeature`s that are enabled.
`DeserializerFactory`	`getFactory()` Method for getting current `DeserializerFactory`.
`Locale`	`getLocale()` Method for accessing default Locale to use: convenience method for
`JsonNodeFactory`	`getNodeFactory()` Convenience method, functionally equivalent to:
`JsonParser`	`getParser()` Method for accessing the currently active parser.
`TimeZone`	`getTimeZone()` Method for accessing default TimeZone to use: convenience method for
`TypeFactory`	`getTypeFactory()`
`JsonDeserializer<?>`	`handlePrimaryContextualization(JsonDeserializer<?> deser, BeanProperty prop)` Deprecated.
`JsonDeserializer<?>`	`handlePrimaryContextualization(JsonDeserializer<?> deser, BeanProperty prop, JavaType type)` Method called for primary property deserializers (ones directly created to deserialize values of a POJO property), to handle details of resolving `ContextualDeserializer` with given property context.
`JsonDeserializer<?>`	`handleSecondaryContextualization(JsonDeserializer<?> deser, BeanProperty prop)` Deprecated.
`JsonDeserializer<?>`	`handleSecondaryContextualization(JsonDeserializer<?> deser, BeanProperty prop, JavaType type)` Method called for secondary property deserializers (ones NOT directly created to deal with an annotatable POJO property, but instead created as a component -- such as value deserializers for structured types, or deserializers for root values) to handle details of resolving `ContextualDeserializer` with given property context.
`boolean`	`handleUnknownProperty(JsonParser p, JsonDeserializer<?> deser, Object instanceOrClass, String propName)` Method deserializers can call to inform configured `DeserializationProblemHandler`s of an unrecognized property.
`boolean`	`hasDeserializationFeatures(int featureMask)` Bulk access method for checking that all features specified by mask are enabled.
`boolean`	`hasSomeOfFeatures(int featureMask)` Bulk access method for checking that at least one of features specified by mask is enabled.
`boolean`	`hasValueDeserializerFor(JavaType type)` Deprecated.
`boolean`	`hasValueDeserializerFor(JavaType type, AtomicReference<Throwable> cause)` Method for checking whether we could find a deserializer for given type.
`JsonMappingException`	`instantiationException(Class<?> instClass, String msg)`
`JsonMappingException`	`instantiationException(Class<?> instClass, Throwable t)` Helper method for constructing instantiation exception for specified type, to indicate problem with physically constructing instance of specified class (missing constructor, exception from constructor)
`boolean`	`isEnabled(DeserializationFeature feat)` Convenience method for checking whether specified on/off feature is enabled
`boolean`	`isEnabled(MapperFeature feature)` Convenience method for checking whether specified serialization feature is enabled or not.
`abstract KeyDeserializer`	`keyDeserializerInstance(Annotated annotated, Object deserDef)`
`ObjectBuffer`	`leaseObjectBuffer()` Method that can be used to get access to a reusable ObjectBuffer, useful for efficiently constructing Object arrays and Lists.
`JsonMappingException`	`mappingException(Class<?> targetClass)` Helper method for constructing generic mapping exception for specified type
`JsonMappingException`	`mappingException(Class<?> targetClass, JsonToken token)`
`JsonMappingException`	`mappingException(String message)` Helper method for constructing generic mapping exception with specified message and current location information
`JsonMappingException`	`mappingException(String msgTemplate, Object... args)` Helper method for constructing generic mapping exception with specified message and current location information
`Date`	`parseDate(String dateStr)` Convenience method for parsing a Date from given String, using currently configured date format (accessed using `MapperConfig.getDateFormat()`).
`<T> T`	`readPropertyValue(JsonParser p, BeanProperty prop, Class<T> type)` Convenience method that may be used by composite or container deserializers, for reading one-off values for the composite type, taking into account annotations that the property (passed to this method -- usually property that has custom serializer that called this method) has.
`<T> T`	`readPropertyValue(JsonParser p, BeanProperty prop, JavaType type)`
`<T> T`	`readValue(JsonParser p, Class<T> type)` Convenience method that may be used by composite or container deserializers, for reading one-off values contained (for sequences, it is more efficient to actually fetch deserializer once for the whole collection).
`<T> T`	`readValue(JsonParser p, JavaType type)`
`void`	`reportUnknownProperty(Object instanceOrClass, String fieldName, JsonDeserializer<?> deser)` Helper method for reporting a problem with unhandled unknown exception
`void`	`returnObjectBuffer(ObjectBuffer buf)` Method to call to return object buffer previously leased with `leaseObjectBuffer()`.
`DeserializationContext`	`setAttribute(Object key, Object value)` Method for setting per-call value of given attribute.
`JsonMappingException`	`unknownTypeException(JavaType type, String id)` Deprecated.
`JsonMappingException`	`unknownTypeException(JavaType type, String id, String extraDesc)`
`JsonMappingException`	`weirdKeyException(Class<?> keyClass, String keyValue, String msg)` Helper method for constructing exception to indicate that given JSON Object field name was not in format to be able to deserialize specified key type.
`JsonMappingException`	`weirdNumberException(Number value, Class<?> instClass, String msg)` Helper method for constructing exception to indicate that input JSON Number was not suitable for deserializing into given target type.
`JsonMappingException`	`weirdStringException(String value, Class<?> instClass, String msg)` Method that will construct an exception suitable for throwing when some String values are acceptable, but the one encountered is not.
`JsonMappingException`	`wrongTokenException(JsonParser p, JsonToken expToken, String msg0)` Helper method for indicating that the current token was expected to be another token.

Methods inherited from class com.fasterxml.jackson.databind.DatabindContext
constructSpecializedType, constructType, converterInstance, objectIdGeneratorInstance, objectIdResolverInstance

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - _cache
```
protected final DeserializerCache _cache
```
    Object that handle details of JsonDeserializer caching.
  - _factory
```
protected final DeserializerFactory _factory
```
    Read-only factory instance; exposed to let owners (ObjectMapper, ObjectReader) access it.
  - _config
```
protected final DeserializationConfig _config
```
    Generic deserialization processing configuration
  - _featureFlags
```
protected final int _featureFlags
```
    Bitmap of DeserializationFeatures that are enabled
  - _view
```
protected final Class<?> _view
```
    Currently active view, if any.
  - _parser
```
protected transient JsonParser _parser
```
    Currently active parser used for deserialization. May be different from the outermost parser when content is buffered.
  - _injectableValues
```
protected final InjectableValues _injectableValues
```
    Object used for resolving references to injectable values.
  - _arrayBuilders
```
protected transient ArrayBuilders _arrayBuilders
```
  - _objectBuffer
```
protected transient ObjectBuffer _objectBuffer
```
  - _dateFormat
```
protected transient DateFormat _dateFormat
```
  - _attributes
```
protected transient ContextAttributes _attributes
```
    Lazily-constructed holder for per-call attributes.
    
    Since:
    
    2.3
  - _currentType
```
protected LinkedNode<JavaType> _currentType
```
    Type of JsonDeserializer (or, more specifically, ContextualDeserializer) that is being contextualized currently.
    
    Since:
    
    2.5
- Constructor Detail
  - DeserializationContext
```
protected DeserializationContext(DeserializerFactory df)
```
  - DeserializationContext
```
protected DeserializationContext(DeserializerFactory df,
                      DeserializerCache cache)
```
  - DeserializationContext
```
protected DeserializationContext(DeserializationContext src,
                      DeserializerFactory factory)
```
  - DeserializationContext
```
protected DeserializationContext(DeserializationContext src,
                      DeserializationConfig config,
                      JsonParser p,
                      InjectableValues injectableValues)
```
    Constructor used for creating actual per-call instances.
  - DeserializationContext
```
protected DeserializationContext(DeserializationContext src)
```
    Copy-constructor for use with copy() by ObjectMapper.copy()
- Method Detail
  - getConfig
```
public DeserializationConfig getConfig()
```
    Description copied from class: DatabindContext
    
    Accessor to currently active configuration (both per-request configs and per-mapper config).
    
    Specified by:
    
    getConfig in class DatabindContext
  - getActiveView
```
public final Class<?> getActiveView()
```
    Description copied from class: DatabindContext
    
    Accessor for locating currently active view, if any; returns null if no view has been set.
    
    Specified by:
    
    getActiveView in class DatabindContext
  - canOverrideAccessModifiers
```
public final boolean canOverrideAccessModifiers()
```
    Description copied from class: DatabindContext
    Convenience method for accessing serialization view in use (if any); equivalent to:
```
   getConfig().canOverrideAccessModifiers();
```
    Specified by:
    
    canOverrideAccessModifiers in class DatabindContext
  - isEnabled
```
public final boolean isEnabled(MapperFeature feature)
```
    Description copied from class: DatabindContext
    Convenience method for checking whether specified serialization feature is enabled or not. Shortcut for:
```
  getConfig().isEnabled(feature);
```
    Specified by:
    
    isEnabled in class DatabindContext
  - getDefaultPropertyFormat
```
public final JsonFormat.Value getDefaultPropertyFormat(Class<?> baseType)
```
    Specified by:
    
    getDefaultPropertyFormat in class DatabindContext
  - getAnnotationIntrospector
```
public final AnnotationIntrospector getAnnotationIntrospector()
```
    Description copied from class: DatabindContext
    Convenience method for accessing serialization view in use (if any); equivalent to:
```
   getConfig().getAnnotationIntrospector();
```
    Specified by:
    
    getAnnotationIntrospector in class DatabindContext
  - getTypeFactory
```
public final TypeFactory getTypeFactory()
```
    Specified by:
    
    getTypeFactory in class DatabindContext
  - getLocale
```
public Locale getLocale()
```
    Method for accessing default Locale to use: convenience method for
```
   getConfig().getLocale();
```
    Specified by:
    
    getLocale in class DatabindContext
  - getTimeZone
```
public TimeZone getTimeZone()
```
    Method for accessing default TimeZone to use: convenience method for
```
   getConfig().getTimeZone();
```
    Specified by:
    
    getTimeZone in class DatabindContext
  - getAttribute
```
public Object getAttribute(Object key)
```
    Description copied from class: DatabindContext
    
    Method for accessing attributes available in this context. Per-call attributes have highest precedence; attributes set via ObjectReader or ObjectWriter have lower precedence.
    
    Specified by:
    
    getAttribute in class DatabindContext
    
    Parameters:
    key - Key of the attribute to get
    
    Returns:
    Value of the attribute, if any; null otherwise
  - setAttribute
```
public DeserializationContext setAttribute(Object key,
                                  Object value)
```
    Description copied from class: DatabindContext
    
    Method for setting per-call value of given attribute. This will override any previously defined value for the attribute within this context.
    
    Specified by:
    
    setAttribute in class DatabindContext
    
    Parameters:
    key - Key of the attribute to set
    value - Value to set attribute to
    
    Returns:
    This context object, to allow chaining
  - getContextualType
```
public JavaType getContextualType()
```
    Accessor to JavaType of currently contextualized ContextualDeserializer, if any. This is sometimes useful for generic JsonDeserializers that do not get passed (or do not retain) type information when being constructed: happens for example for deserializers constructed from annotations.
    
    Returns:
    Type of ContextualDeserializer being contextualized, if process is on-going; null if not.
    Since:
    
    2.5
  - getFactory
```
public DeserializerFactory getFactory()
```
    Method for getting current DeserializerFactory.
  - isEnabled
```
public final boolean isEnabled(DeserializationFeature feat)
```
    Convenience method for checking whether specified on/off feature is enabled
  - getDeserializationFeatures
```
public final int getDeserializationFeatures()
```
    Bulk access method for getting the bit mask of all DeserializationFeatures that are enabled.
    
    Since:
    
    2.6
  - hasDeserializationFeatures
```
public final boolean hasDeserializationFeatures(int featureMask)
```
    Bulk access method for checking that all features specified by mask are enabled.
    
    Since:
    
    2.3
  - hasSomeOfFeatures
```
public final boolean hasSomeOfFeatures(int featureMask)
```
    Bulk access method for checking that at least one of features specified by mask is enabled.
    
    Since:
    
    2.6
  - getParser
```
public final JsonParser getParser()
```
    Method for accessing the currently active parser. May be different from the outermost parser when content is buffered.
    Use of this method is discouraged: if code has direct access to the active parser, that should be used instead.
  - findInjectableValue
```
public final Object findInjectableValue(Object valueId,
                         BeanProperty forProperty,
                         Object beanInstance)
```
  - getBase64Variant
```
public final Base64Variant getBase64Variant()
```
    Convenience method for accessing the default Base64 encoding used for decoding base64 encoded binary content. Same as calling:
```
  getConfig().getBase64Variant();
```
  - getNodeFactory
```
public final JsonNodeFactory getNodeFactory()
```
    Convenience method, functionally equivalent to:
```
  getConfig().getNodeFactory();
 
```
  - hasValueDeserializerFor
```
@Deprecated
public boolean hasValueDeserializerFor(JavaType type)
```
    Deprecated.
  - hasValueDeserializerFor
```
public boolean hasValueDeserializerFor(JavaType type,
                              AtomicReference<Throwable> cause)
```
    Method for checking whether we could find a deserializer for given type.
    
    Parameters:
    type -
    Since:
    
    2.3
  - findContextualValueDeserializer
```
public final JsonDeserializer<Object> findContextualValueDeserializer(JavaType type,
                                                       BeanProperty prop)
                                                               throws JsonMappingException
```
    Method for finding a value deserializer, and creating a contextual version if necessary, for value reached via specified property.
    
    Throws:
    
    JsonMappingException
  - findNonContextualValueDeserializer
```
public final JsonDeserializer<Object> findNonContextualValueDeserializer(JavaType type)
                                                                  throws JsonMappingException
```
    Variant that will try to locate deserializer for current type, but without performing any contextualization (unlike findContextualValueDeserializer(com.fasterxml.jackson.databind.JavaType, com.fasterxml.jackson.databind.BeanProperty)) or checking for need to create a TypeDeserializer (unlike findRootValueDeserializer(JavaType). This method is usually called from within ResolvableDeserializer.resolve(com.fasterxml.jackson.databind.DeserializationContext), and expectation is that caller then calls either handlePrimaryContextualization(JsonDeserializer, BeanProperty, JavaType) or handleSecondaryContextualization(JsonDeserializer, BeanProperty, JavaType) at a later point, as necessary.
    
    Throws:
    
    JsonMappingException
    Since:
    
    2.5
  - findRootValueDeserializer
```
public final JsonDeserializer<Object> findRootValueDeserializer(JavaType type)
                                                         throws JsonMappingException
```
    Method for finding a deserializer for root-level value.
    
    Throws:
    
    JsonMappingException
  - findKeyDeserializer
```
public final KeyDeserializer findKeyDeserializer(JavaType keyType,
                                  BeanProperty prop)
                                          throws JsonMappingException
```
    Convenience method, functionally same as:
```
  getDeserializerProvider().findKeyDeserializer(getConfig(), prop.getType(), prop);
```
    Throws:
    
    JsonMappingException
  - findObjectId
```
public abstract ReadableObjectId findObjectId(Object id,
                            ObjectIdGenerator<?> generator,
                            ObjectIdResolver resolver)
```
    Method called to find and return entry corresponding to given Object Id: will add an entry if necessary, and never returns null
  - findObjectId
```
@Deprecated
public abstract ReadableObjectId findObjectId(Object id,
                                       ObjectIdGenerator<?> generator)
```
    Deprecated.
  - checkUnresolvedObjectId
```
public abstract void checkUnresolvedObjectId()
                                      throws UnresolvedForwardReference
```
    Method called to ensure that every object id encounter during processing are resolved.
    
    Throws:
    
    UnresolvedForwardReference
  - constructType
```
public final JavaType constructType(Class<?> cls)
```
    Convenience method, functionally equivalent to:
```
  getConfig().constructType(cls);
 
```
  - findClass
```
public Class<?> findClass(String className)
                   throws ClassNotFoundException
```
    Helper method that is to be used when resolving basic class name into Class instance, the reason being that it may be necessary to work around various ClassLoader limitations, as well as to handle primitive type signatures.
    
    Throws:
    
    ClassNotFoundException
    Since:
    
    2.6
  - leaseObjectBuffer
```
public final ObjectBuffer leaseObjectBuffer()
```
    Method that can be used to get access to a reusable ObjectBuffer, useful for efficiently constructing Object arrays and Lists. Note that leased buffers should be returned once deserializer is done, to allow for reuse during same round of deserialization.
  - returnObjectBuffer
```
public final void returnObjectBuffer(ObjectBuffer buf)
```
    Method to call to return object buffer previously leased with leaseObjectBuffer().
    
    Parameters:
    buf - Returned object buffer
  - getArrayBuilders
```
public final ArrayBuilders getArrayBuilders()
```
    Method for accessing object useful for building arrays of primitive types (such as int[]).
  - deserializerInstance
```
public abstract JsonDeserializer<Object> deserializerInstance(Annotated annotated,
                                            Object deserDef)
                                                       throws JsonMappingException
```
    Throws:
    
    JsonMappingException
  - keyDeserializerInstance
```
public abstract KeyDeserializer keyDeserializerInstance(Annotated annotated,
                                      Object deserDef)
                                                 throws JsonMappingException
```
    Throws:
    
    JsonMappingException
  - handlePrimaryContextualization
```
public JsonDeserializer<?> handlePrimaryContextualization(JsonDeserializer<?> deser,
                                                 BeanProperty prop,
                                                 JavaType type)
                                                   throws JsonMappingException
```
    Method called for primary property deserializers (ones directly created to deserialize values of a POJO property), to handle details of resolving ContextualDeserializer with given property context.
    
    Parameters:
    prop - Property for which the given primary deserializer is used; never null.
    
    Throws:
    
    JsonMappingException
    Since:
    
    2.5
  - handleSecondaryContextualization
```
public JsonDeserializer<?> handleSecondaryContextualization(JsonDeserializer<?> deser,
                                                   BeanProperty prop,
                                                   JavaType type)
                                                     throws JsonMappingException
```
    Method called for secondary property deserializers (ones NOT directly created to deal with an annotatable POJO property, but instead created as a component -- such as value deserializers for structured types, or deserializers for root values) to handle details of resolving ContextualDeserializer with given property context. Given that these deserializers are not directly related to given property (or, in case of root value property, to any property), annotations accessible may or may not be relevant.
    
    Parameters:
    prop - Property for which deserializer is used, if any; null when deserializing root values
    
    Throws:
    
    JsonMappingException
    Since:
    
    2.5
  - handlePrimaryContextualization
```
@Deprecated
public JsonDeserializer<?> handlePrimaryContextualization(JsonDeserializer<?> deser,
                                                            BeanProperty prop)
                                                   throws JsonMappingException
```
    Deprecated.
    
    Throws:
    
    JsonMappingException
  - handleSecondaryContextualization
```
@Deprecated
public JsonDeserializer<?> handleSecondaryContextualization(JsonDeserializer<?> deser,
                                                              BeanProperty prop)
                                                     throws JsonMappingException
```
    Deprecated.
    
    Throws:
    
    JsonMappingException
  - parseDate
```
public Date parseDate(String dateStr)
               throws IllegalArgumentException
```
    Convenience method for parsing a Date from given String, using currently configured date format (accessed using MapperConfig.getDateFormat()).
    Implementation will handle thread-safety issues related to date formats such that first time this method is called, date format is cloned, and cloned instance will be retained for use during this deserialization round.
    
    Throws:
    
    IllegalArgumentException
  - constructCalendar
```
public Calendar constructCalendar(Date d)
```
    Convenience method for constructing Calendar instance set to specified time, to be modified and used by caller.
  - readValue
```
public <T> T readValue(JsonParser p,
              Class<T> type)
            throws IOException
```
    Convenience method that may be used by composite or container deserializers, for reading one-off values contained (for sequences, it is more efficient to actually fetch deserializer once for the whole collection).
    NOTE: when deserializing values of properties contained in composite types, rather use readPropertyValue(JsonParser, BeanProperty, Class); this method does not allow use of contextual annotations.
    
    Throws:
    
    IOException
    Since:
    
    2.4
  - readValue
```
public <T> T readValue(JsonParser p,
              JavaType type)
            throws IOException
```
    Throws:
    
    IOException
    Since:
    
    2.4
  - readPropertyValue
```
public <T> T readPropertyValue(JsonParser p,
                      BeanProperty prop,
                      Class<T> type)
                    throws IOException
```
    Convenience method that may be used by composite or container deserializers, for reading one-off values for the composite type, taking into account annotations that the property (passed to this method -- usually property that has custom serializer that called this method) has.
    
    Throws:
    
    IOException
    Since:
    
    2.4
  - readPropertyValue
```
public <T> T readPropertyValue(JsonParser p,
                      BeanProperty prop,
                      JavaType type)
                    throws IOException
```
    Throws:
    
    IOException
    Since:
    
    2.4
  - handleUnknownProperty
```
public boolean handleUnknownProperty(JsonParser p,
                            JsonDeserializer<?> deser,
                            Object instanceOrClass,
                            String propName)
                              throws IOException,
                                     JsonProcessingException
```
    Method deserializers can call to inform configured DeserializationProblemHandlers of an unrecognized property.
    
    Throws:
    
    IOException
    
    JsonProcessingException
  - reportUnknownProperty
```
public void reportUnknownProperty(Object instanceOrClass,
                         String fieldName,
                         JsonDeserializer<?> deser)
                           throws JsonMappingException
```
    Helper method for reporting a problem with unhandled unknown exception
    
    Parameters:
    instanceOrClass - Either value being populated (if one has been instantiated), or Class that indicates type that would be (or have been) instantiated
    deser - Deserializer that had the problem, if called by deserializer (or on behalf of one)
    
    Throws:
    
    JsonMappingException
  - mappingException
```
public JsonMappingException mappingException(Class<?> targetClass)
```
    Helper method for constructing generic mapping exception for specified type
  - mappingException
```
public JsonMappingException mappingException(Class<?> targetClass,
                                    JsonToken token)
```
  - mappingException
```
public JsonMappingException mappingException(String message)
```
    Helper method for constructing generic mapping exception with specified message and current location information
  - mappingException
```
public JsonMappingException mappingException(String msgTemplate,
                                    Object... args)
```
    Helper method for constructing generic mapping exception with specified message and current location information
    
    Since:
    
    2.6
  - instantiationException
```
public JsonMappingException instantiationException(Class<?> instClass,
                                          Throwable t)
```
    Helper method for constructing instantiation exception for specified type, to indicate problem with physically constructing instance of specified class (missing constructor, exception from constructor)
  - instantiationException
```
public JsonMappingException instantiationException(Class<?> instClass,
                                          String msg)
```
  - weirdStringException
```
public JsonMappingException weirdStringException(String value,
                                        Class<?> instClass,
                                        String msg)
```
    Method that will construct an exception suitable for throwing when some String values are acceptable, but the one encountered is not.
    
    Parameters:
    value - String value from input being deserialized
    instClass - Type that String should be deserialized into
    msg - Message that describes specific problem
    Since:
    
    2.1
  - weirdNumberException
```
public JsonMappingException weirdNumberException(Number value,
                                        Class<?> instClass,
                                        String msg)
```
    Helper method for constructing exception to indicate that input JSON Number was not suitable for deserializing into given target type.
  - weirdKeyException
```
public JsonMappingException weirdKeyException(Class<?> keyClass,
                                     String keyValue,
                                     String msg)
```
    Helper method for constructing exception to indicate that given JSON Object field name was not in format to be able to deserialize specified key type.
  - wrongTokenException
```
public JsonMappingException wrongTokenException(JsonParser p,
                                       JsonToken expToken,
                                       String msg0)
```
    Helper method for indicating that the current token was expected to be another token.
  - unknownTypeException
```
@Deprecated
public JsonMappingException unknownTypeException(JavaType type,
                                                   String id)
```
    Deprecated.
    
    Helper method for constructing exception to indicate that given type id (parsed from JSON) could not be converted to a Java type.
  - unknownTypeException
```
public JsonMappingException unknownTypeException(JavaType type,
                                        String id,
                                        String extraDesc)
```
    Since:
    
    2.5
  - endOfInputException
```
public JsonMappingException endOfInputException(Class<?> instClass)
```
  - getDateFormat
```
protected DateFormat getDateFormat()
```
  - determineClassName
```
protected String determineClassName(Object instance)
```
  - _calcName
```
protected String _calcName(Class<?> cls)
```
  - _valueDesc
```
protected String _valueDesc()
```
  - _desc
```
protected String _desc(String desc)
```
  - _quotedString
```
protected String _quotedString(String desc)
```

Class DeserializationContext

Field Summary

Constructor Summary

Method Summary

Methods inherited from class com.fasterxml.jackson.databind.DatabindContext

Methods inherited from class java.lang.Object

Field Detail

_cache

_factory

_config

_featureFlags

_view

_parser

_injectableValues

_arrayBuilders

_objectBuffer

_dateFormat

_attributes

_currentType

Constructor Detail

DeserializationContext

DeserializationContext

DeserializationContext

DeserializationContext

DeserializationContext

Method Detail

getConfig

getActiveView

canOverrideAccessModifiers

isEnabled

getDefaultPropertyFormat

getAnnotationIntrospector

getTypeFactory

getLocale

getTimeZone

getAttribute

setAttribute

getContextualType

getFactory

isEnabled

getDeserializationFeatures

hasDeserializationFeatures

hasSomeOfFeatures

getParser

findInjectableValue

getBase64Variant

getNodeFactory

hasValueDeserializerFor

hasValueDeserializerFor

findContextualValueDeserializer

findNonContextualValueDeserializer

findRootValueDeserializer

findKeyDeserializer

findObjectId

findObjectId

checkUnresolvedObjectId

constructType

findClass

leaseObjectBuffer

returnObjectBuffer

getArrayBuilders

deserializerInstance

keyDeserializerInstance

handlePrimaryContextualization

handleSecondaryContextualization

handlePrimaryContextualization

handleSecondaryContextualization

parseDate

constructCalendar

readValue

readValue

readPropertyValue

readPropertyValue

handleUnknownProperty

reportUnknownProperty

mappingException

mappingException

mappingException

mappingException

instantiationException