org.codehaus.jackson.map
Class DeserializationConfig

java.lang.Object
  extended by org.codehaus.jackson.map.DeserializationConfig

public class DeserializationConfig
extends java.lang.Object

Object that contains baseline configuration for deserialization process. An instance is owned by ObjectMapper, which makes a copy that is passed during serialization process to DeserializerProvider and DeserializerFactory.

Note: although configuration settings can be changed at any time (for factories and instances), they are not guaranteed to have effect if called after constructing relevant mapper or deserializer instance. This because some objects may be configured, constructed and cached first time they are needed.


Nested Class Summary
static class DeserializationConfig.Feature
          Enumeration that defines togglable features that guide the serialization feature.
 
Field Summary
protected  ClassIntrospector<? extends BeanDescription> _classIntrospector
          Introspector used to figure out Bean properties needed for bean serialization and deserialization.
protected  java.text.DateFormat _dateFormat
          Custom date format to use for de-serialization.
protected  int _featureFlags
          Bitset that contains all enabled features
protected  LinkedNode<DeserializationProblemHandler> _problemHandlers
          Linked list that contains all registered problem handlers.
protected static java.text.DateFormat DEFAULT_DATE_FORMAT
           
protected static int DEFAULT_FEATURE_FLAGS
          Bitfield (set of flags) of all Features that are enabled by default.
 
Constructor Summary
  DeserializationConfig(ClassIntrospector<? extends BeanDescription> intr)
           
protected DeserializationConfig(DeserializationConfig src)
           
 
Method Summary
 void addHandler(DeserializationProblemHandler h)
          Method that can be used to add a handler that can (try to) resolve non-fatal deserialization problems.
 DeserializationConfig createUnshared()
          Method that is called to create a non-shared copy of the configuration to be used for a deserialization operation.
 void disable(DeserializationConfig.Feature f)
          Method for disabling specified feature.
 void enable(DeserializationConfig.Feature f)
          Method for enabling specified feature.
 void fromAnnotations(java.lang.Class<?> annotatedClass)
          Method that checks class annotations that the argument Object has, and modifies settings of this configuration object accordingly, similar to how those annotations would affect actual value classes annotated with them, but with global scope.
 Base64Variant getBase64Variant()
          Method called during deserialization if Base64 encoded content needs to be decoded.
 java.text.DateFormat getDateFormat()
           
 LinkedNode<DeserializationProblemHandler> getProblemHandlers()
          Method for getting head of the problem handler chain.
<T extends BeanDescription>
T
introspect(java.lang.Class<?> cls)
          Method that will introspect full bean properties for the purpose of building a bean deserializer
<T extends BeanDescription>
T
introspectClassAnnotations(java.lang.Class<?> cls)
          Accessor for getting bean description that only contains class annotations: useful if no getter/setter/creator information is needed.
<T extends BeanDescription>
T
introspectForCreation(java.lang.Class<?> cls)
          Method that will introspect subset of bean properties needed to construct bean instance.
 boolean isEnabled(DeserializationConfig.Feature f)
          Method for checking whether given feature is enabled or not
 void set(DeserializationConfig.Feature f, boolean state)
          Method for enabling or disabling specified feature.
 void setDateFormat(java.text.DateFormat df)
          Method that will set the textual deserialization to use for deserializing Dates (and Calendars).
 void setIntrospector(ClassIntrospector<? extends BeanDescription> i)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

DEFAULT_FEATURE_FLAGS

protected static final int DEFAULT_FEATURE_FLAGS
Bitfield (set of flags) of all Features that are enabled by default.


DEFAULT_DATE_FORMAT

protected static final java.text.DateFormat DEFAULT_DATE_FORMAT

_classIntrospector

protected ClassIntrospector<? extends BeanDescription> _classIntrospector
Introspector used to figure out Bean properties needed for bean serialization and deserialization. Overridable so that it is possible to change low-level details of introspection, like adding new annotation types.


_featureFlags

protected int _featureFlags
Bitset that contains all enabled features


_problemHandlers

protected LinkedNode<DeserializationProblemHandler> _problemHandlers
Linked list that contains all registered problem handlers. Implementation as front-added linked list allows for sharing of the list (tail) without copying the list.


_dateFormat

protected java.text.DateFormat _dateFormat
Custom date format to use for de-serialization. If specified, will be used instead of StdDateFormat.

Note that the configured format object will be cloned once per deserialization process (first time it is needed)

Constructor Detail

DeserializationConfig

public DeserializationConfig(ClassIntrospector<? extends BeanDescription> intr)

DeserializationConfig

protected DeserializationConfig(DeserializationConfig src)
Method Detail

createUnshared

public DeserializationConfig createUnshared()
Method that is called to create a non-shared copy of the configuration to be used for a deserialization operation. Note that if sub-classing and sub-class has additional instance methods, this method must be overridden to produce proper sub-class instance.


fromAnnotations

public void fromAnnotations(java.lang.Class<?> annotatedClass)
Method that checks class annotations that the argument Object has, and modifies settings of this configuration object accordingly, similar to how those annotations would affect actual value classes annotated with them, but with global scope. Note that not all annotations have global significance, and thus only subset of Jackson annotations will have any effect.

Ones that are known to have effect are:

Parameters:
annotatedClass - Class of which class annotations to use for changing configuration settings

addHandler

public void addHandler(DeserializationProblemHandler h)
Method that can be used to add a handler that can (try to) resolve non-fatal deserialization problems.


isEnabled

public final boolean isEnabled(DeserializationConfig.Feature f)
Method for checking whether given feature is enabled or not


getBase64Variant

public Base64Variant getBase64Variant()
Method called during deserialization if Base64 encoded content needs to be decoded. Default version just returns default Jackson uses, which is modified-mime which does not add linefeeds (because those would have to be escaped in Json strings).


getProblemHandlers

public LinkedNode<DeserializationProblemHandler> getProblemHandlers()
Method for getting head of the problem handler chain. May be null, if no handlers have been added.


getDateFormat

public java.text.DateFormat getDateFormat()

introspect

public <T extends BeanDescription> T introspect(java.lang.Class<?> cls)
Method that will introspect full bean properties for the purpose of building a bean deserializer


introspectForCreation

public <T extends BeanDescription> T introspectForCreation(java.lang.Class<?> cls)
Method that will introspect subset of bean properties needed to construct bean instance.


introspectClassAnnotations

public <T extends BeanDescription> T introspectClassAnnotations(java.lang.Class<?> cls)
Accessor for getting bean description that only contains class annotations: useful if no getter/setter/creator information is needed.


enable

public void enable(DeserializationConfig.Feature f)
Method for enabling specified feature.


disable

public void disable(DeserializationConfig.Feature f)
Method for disabling specified feature.


set

public void set(DeserializationConfig.Feature f,
                boolean state)
Method for enabling or disabling specified feature.


setDateFormat

public void setDateFormat(java.text.DateFormat df)
Method that will set the textual deserialization to use for deserializing Dates (and Calendars). If null is passed, will use StdDateFormat.


setIntrospector

public void setIntrospector(ClassIntrospector<? extends BeanDescription> i)