public final class DeserializationConfig extends MapperConfigBase<DeserializationFeature,DeserializationConfig> implements Serializable
ObjectMapper
, which
passes an immutable instance to be used for deserialization process.
Note that instances are considered immutable and as such no copies should need to be created for sharing; all copying is done with "fluent factory" methods.
Modifier and Type | Field and Description |
---|---|
protected CoercionConfigs |
_coercionConfigs |
protected ConstructorDetector |
_ctorDetector |
protected int |
_deserFeatures
Set of
DeserializationFeature s enabled. |
protected int |
_formatReadFeatures
States of
FormatFeature s to enable/disable. |
protected int |
_formatReadFeaturesToChange
Bitflag of
FormatFeature s to enable/disable |
protected JsonNodeFactory |
_nodeFactory
Factory used for constructing
JsonNode instances. |
protected int |
_parserFeatures
States of
JsonParser.Feature s to enable/disable. |
protected int |
_parserFeaturesToChange
Bitflag of
JsonParser.Feature s to enable/disable |
protected LinkedNode<DeserializationProblemHandler> |
_problemHandlers
Linked list that contains all registered problem handlers.
|
_attributes, _configOverrides, _datatypeFeatures, _mixIns, _rootName, _rootNames, _subtypeResolver, _view, EMPTY_OVERRIDE
_base, _mapperFeatures, EMPTY_FORMAT, EMPTY_INCLUDE
Modifier | Constructor and Description |
---|---|
|
DeserializationConfig(BaseSettings base,
SubtypeResolver str,
SimpleMixInResolver mixins,
RootNameLookup rootNames,
ConfigOverrides configOverrides,
CoercionConfigs coercionConfigs,
DatatypeFeatures datatypeFeatures)
Constructor used by ObjectMapper to create default configuration object instance.
|
protected |
DeserializationConfig(DeserializationConfig src,
ContextAttributes attrs) |
protected |
DeserializationConfig(DeserializationConfig src,
DatatypeFeatures datatypeFeatures) |
protected |
DeserializationConfig(DeserializationConfig src,
SimpleMixInResolver mixins) |
protected |
DeserializationConfig(DeserializationConfig src,
SubtypeResolver str,
SimpleMixInResolver mixins,
RootNameLookup rootNames,
ConfigOverrides configOverrides,
CoercionConfigs coercionConfigs)
Copy-constructor used for making a copy used by new
ObjectMapper . |
Modifier and Type | Method and Description |
---|---|
protected DeserializationConfig |
_with(DatatypeFeatures dtFeatures) |
protected DeserializationConfig |
_withBase(BaseSettings newBase) |
protected DeserializationConfig |
_withMapperFeatures(long mapperFeatures) |
CoercionAction |
findCoercionAction(LogicalType targetType,
Class<?> targetClass,
CoercionInputShape inputShape)
General-purpose accessor for finding what to do when specified coercion
from shape that is now always allowed to be coerced from is requested.
|
CoercionAction |
findCoercionFromBlankString(LogicalType targetType,
Class<?> targetClass,
CoercionAction actionIfBlankNotAllowed)
More specialized accessor called in case of input being a blank
String (one consisting of only white space characters with length of at least one).
|
TypeDeserializer |
findTypeDeserializer(JavaType baseType)
Helper method that is needed to properly handle polymorphic referenced
types, such as types referenced by
AtomicReference ,
or various "optional" types. |
protected BaseSettings |
getBaseSettings() |
ConstructorDetector |
getConstructorDetector() |
int |
getDeserializationFeatures()
Bulk access method for getting the bit mask of all
DeserializationFeature s
that are enabled. |
JsonNodeFactory |
getNodeFactory() |
LinkedNode<DeserializationProblemHandler> |
getProblemHandlers()
Method for getting head of the problem handler chain.
|
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.
|
com.fasterxml.jackson.core.JsonParser |
initialize(com.fasterxml.jackson.core.JsonParser p)
Method called by
ObjectMapper and ObjectReader
to modify those JsonParser.Feature settings
that have been configured via this config instance. |
com.fasterxml.jackson.core.JsonParser |
initialize(com.fasterxml.jackson.core.JsonParser p,
com.fasterxml.jackson.core.FormatSchema schema) |
BeanDescription |
introspect(JavaType type)
Method that will introspect full bean properties for the purpose
of building a bean deserializer
|
BeanDescription |
introspectForBuilder(JavaType type)
Deprecated.
Since 2.12 - use variant that takes both builder and value type
|
BeanDescription |
introspectForBuilder(JavaType builderType,
BeanDescription valueTypeDesc) |
BeanDescription |
introspectForCreation(JavaType type)
Method that will introspect subset of bean properties needed to
construct bean instance.
|
boolean |
isEnabled(DatatypeFeature feature)
Accessor for checking whether give
DatatypeFeature
is enabled or not. |
boolean |
isEnabled(DeserializationFeature feature)
Accessor for checking whether give
DeserializationFeature
is enabled or not. |
boolean |
isEnabled(com.fasterxml.jackson.core.JsonParser.Feature f,
com.fasterxml.jackson.core.JsonFactory factory) |
boolean |
requiresFullValue()
Convenience method equivalent to:
isEnabled(DeserializationFeature.FAIL_ON_TRAILING_TOKENS)
|
boolean |
useRootWrapping()
Accessor for checking whether configuration indicates that
"root wrapping" (use of an extra property/name pair at root level)
is expected or not.
|
DeserializationConfig |
with(ConstructorDetector ctorDetector) |
DeserializationConfig |
with(ContextAttributes attrs)
Method for constructing an instance that has specified
contextual attributes.
|
DeserializationConfig |
with(DeserializationFeature feature)
Fluent factory method that will construct and return a new configuration
object instance with specified features enabled.
|
DeserializationConfig |
with(DeserializationFeature first,
DeserializationFeature... features)
Fluent factory method that will construct and return a new configuration
object instance with specified features enabled.
|
DeserializationConfig |
with(com.fasterxml.jackson.core.FormatFeature feature)
Fluent factory method that will construct and return a new configuration
object instance with specified features enabled.
|
DeserializationConfig |
with(JsonNodeFactory f)
Fluent factory method that will construct a new instance with
specified
JsonNodeFactory |
DeserializationConfig |
with(com.fasterxml.jackson.core.JsonParser.Feature feature)
Fluent factory method that will construct and return a new configuration
object instance with specified features enabled.
|
DeserializationConfig |
with(SubtypeResolver str)
Method for constructing and returning a new instance with different
SubtypeResolver
to use. |
DeserializationConfig |
withFeatures(DeserializationFeature... features)
Fluent factory method that will construct and return a new configuration
object instance with specified features enabled.
|
DeserializationConfig |
withFeatures(com.fasterxml.jackson.core.FormatFeature... features)
Fluent factory method that will construct and return a new configuration
object instance with specified features enabled.
|
DeserializationConfig |
withFeatures(com.fasterxml.jackson.core.JsonParser.Feature... features)
Fluent factory method that will construct and return a new configuration
object instance with specified features enabled.
|
DeserializationConfig |
withHandler(DeserializationProblemHandler h)
Method that can be used to add a handler that can (try to)
resolve non-fatal deserialization problems.
|
DeserializationConfig |
withNoProblemHandlers()
Method for removing all configured problem handlers; usually done to replace
existing handler(s) with different one(s)
|
DeserializationConfig |
without(DeserializationFeature feature)
Fluent factory method that will construct and return a new configuration
object instance with specified feature disabled.
|
DeserializationConfig |
without(DeserializationFeature first,
DeserializationFeature... features)
Fluent factory method that will construct and return a new configuration
object instance with specified features disabled.
|
DeserializationConfig |
without(com.fasterxml.jackson.core.FormatFeature feature)
Fluent factory method that will construct and return a new configuration
object instance with specified feature disabled.
|
DeserializationConfig |
without(com.fasterxml.jackson.core.JsonParser.Feature feature)
Fluent factory method that will construct and return a new configuration
object instance with specified feature disabled.
|
DeserializationConfig |
withoutFeatures(DeserializationFeature... features)
Fluent factory method that will construct and return a new configuration
object instance with specified features disabled.
|
DeserializationConfig |
withoutFeatures(com.fasterxml.jackson.core.FormatFeature... features)
Fluent factory method that will construct and return a new configuration
object instance with specified features disabled.
|
DeserializationConfig |
withoutFeatures(com.fasterxml.jackson.core.JsonParser.Feature... features)
Fluent factory method that will construct and return a new configuration
object instance with specified features disabled.
|
DeserializationConfig |
withRootName(PropertyName rootName)
Method for constructing and returning a new instance with different
root name to use (none, if null).
|
DeserializationConfig |
withView(Class<?> view)
Method for constructing and returning a new instance with different
view to use.
|
_datatypeFeatures, copy, findConfigOverride, findMixInClassFor, findRootName, findRootName, getActiveView, getAttributes, getConfigOverride, getDefaultInclusion, getDefaultMergeable, getDefaultMergeable, getDefaultPropertyFormat, getDefaultPropertyIgnorals, getDefaultPropertyIgnorals, getDefaultPropertyInclusion, getDefaultPropertyInclusion, getDefaultPropertyInclusions, getDefaultSetterInfo, getDefaultVisibilityChecker, getDefaultVisibilityChecker, getFullRootName, getRootName, getSubtypeResolver, mixInCount, with, with, with, with, with, with, with, with, with, with, with, with, with, with, with, withAppendedAnnotationIntrospector, withAttribute, withAttributes, withFeatures, withInsertedAnnotationIntrospector, without, without, withoutAttribute, withoutFeatures, withRootName
canOverrideAccessModifiers, collectFeatureDefaults, compileString, constructSpecializedType, constructType, constructType, getAccessorNaming, getAnnotationIntrospector, getBase64Variant, getClassIntrospector, getDateFormat, getDefaultInclusion, getDefaultPropertyInclusion, getDefaultTyper, getHandlerInstantiator, getLocale, getPolymorphicTypeValidator, getPropertyNamingStrategy, getTimeZone, getTypeFactory, hasExplicitTimeZone, hasMapperFeatures, introspectClassAnnotations, introspectClassAnnotations, introspectDirectClassAnnotations, introspectDirectClassAnnotations, isAnnotationProcessingEnabled, isEnabled, shouldSortPropertiesAlphabetically, typeIdResolverInstance, typeResolverBuilderInstance
protected final LinkedNode<DeserializationProblemHandler> _problemHandlers
protected final JsonNodeFactory _nodeFactory
JsonNode
instances.protected final CoercionConfigs _coercionConfigs
protected final ConstructorDetector _ctorDetector
protected final int _deserFeatures
DeserializationFeature
s enabled.protected final int _parserFeatures
JsonParser.Feature
s to enable/disable.protected final int _parserFeaturesToChange
JsonParser.Feature
s to enable/disableprotected final int _formatReadFeatures
FormatFeature
s to enable/disable.protected final int _formatReadFeaturesToChange
FormatFeature
s to enable/disablepublic DeserializationConfig(BaseSettings base, SubtypeResolver str, SimpleMixInResolver mixins, RootNameLookup rootNames, ConfigOverrides configOverrides, CoercionConfigs coercionConfigs, DatatypeFeatures datatypeFeatures)
protected DeserializationConfig(DeserializationConfig src, SubtypeResolver str, SimpleMixInResolver mixins, RootNameLookup rootNames, ConfigOverrides configOverrides, CoercionConfigs coercionConfigs)
ObjectMapper
.protected DeserializationConfig(DeserializationConfig src, ContextAttributes attrs)
protected DeserializationConfig(DeserializationConfig src, SimpleMixInResolver mixins)
protected DeserializationConfig(DeserializationConfig src, DatatypeFeatures datatypeFeatures)
protected BaseSettings getBaseSettings()
protected final DeserializationConfig _withBase(BaseSettings newBase)
_withBase
in class MapperConfigBase<DeserializationFeature,DeserializationConfig>
protected final DeserializationConfig _withMapperFeatures(long mapperFeatures)
_withMapperFeatures
in class MapperConfigBase<DeserializationFeature,DeserializationConfig>
protected final DeserializationConfig _with(DatatypeFeatures dtFeatures)
_with
in class MapperConfigBase<DeserializationFeature,DeserializationConfig>
public DeserializationConfig with(SubtypeResolver str)
MapperConfigBase
SubtypeResolver
to use.
NOTE: make sure to register new instance with ObjectMapper
if directly calling this method.
with
in class MapperConfigBase<DeserializationFeature,DeserializationConfig>
public DeserializationConfig withRootName(PropertyName rootName)
MapperConfigBase
Note that when a root name is set to a non-Empty String, this will automatically force use
of root element wrapping with given name. If empty String passed, will
disable root name wrapping; and if null used, will instead use
SerializationFeature
to determine if to use wrapping, and annotation
(or default name) for actual root name to use.
withRootName
in class MapperConfigBase<DeserializationFeature,DeserializationConfig>
rootName
- to use: if null, means "use default" (clear setting);
if empty String ("") means that no root name wrapping is used;
otherwise defines root name to use.public DeserializationConfig withView(Class<?> view)
MapperConfigBase
withView
in class MapperConfigBase<DeserializationFeature,DeserializationConfig>
public DeserializationConfig with(ContextAttributes attrs)
MapperConfigBase
with
in class MapperConfigBase<DeserializationFeature,DeserializationConfig>
public DeserializationConfig with(DeserializationFeature feature)
public DeserializationConfig with(DeserializationFeature first, DeserializationFeature... features)
public DeserializationConfig withFeatures(DeserializationFeature... features)
public DeserializationConfig without(DeserializationFeature feature)
public DeserializationConfig without(DeserializationFeature first, DeserializationFeature... features)
public DeserializationConfig withoutFeatures(DeserializationFeature... features)
public DeserializationConfig with(com.fasterxml.jackson.core.JsonParser.Feature feature)
public DeserializationConfig withFeatures(com.fasterxml.jackson.core.JsonParser.Feature... features)
public DeserializationConfig without(com.fasterxml.jackson.core.JsonParser.Feature feature)
public DeserializationConfig withoutFeatures(com.fasterxml.jackson.core.JsonParser.Feature... features)
public DeserializationConfig with(com.fasterxml.jackson.core.FormatFeature feature)
public DeserializationConfig withFeatures(com.fasterxml.jackson.core.FormatFeature... features)
public DeserializationConfig without(com.fasterxml.jackson.core.FormatFeature feature)
public DeserializationConfig withoutFeatures(com.fasterxml.jackson.core.FormatFeature... features)
public DeserializationConfig with(JsonNodeFactory f)
JsonNodeFactory
public DeserializationConfig with(ConstructorDetector ctorDetector)
public DeserializationConfig withHandler(DeserializationProblemHandler h)
public DeserializationConfig withNoProblemHandlers()
public com.fasterxml.jackson.core.JsonParser initialize(com.fasterxml.jackson.core.JsonParser p)
ObjectMapper
and ObjectReader
to modify those JsonParser.Feature
settings
that have been configured via this config instance.public com.fasterxml.jackson.core.JsonParser initialize(com.fasterxml.jackson.core.JsonParser p, com.fasterxml.jackson.core.FormatSchema schema)
public boolean useRootWrapping()
MapperConfig
useRootWrapping
in class MapperConfig<DeserializationConfig>
public final boolean isEnabled(DeserializationFeature feature)
DeserializationFeature
is enabled or not.feature
- Feature to checkpublic final boolean isEnabled(com.fasterxml.jackson.core.JsonParser.Feature f, com.fasterxml.jackson.core.JsonFactory factory)
public final boolean hasDeserializationFeatures(int featureMask)
public final boolean hasSomeOfFeatures(int featureMask)
public final int getDeserializationFeatures()
DeserializationFeature
s
that are enabled.public final boolean requiresFullValue()
isEnabled(DeserializationFeature.FAIL_ON_TRAILING_TOKENS)
public final boolean isEnabled(DatatypeFeature feature)
DatatypeFeature
is enabled or not.feature
- Feature to checkpublic LinkedNode<DeserializationProblemHandler> getProblemHandlers()
public final JsonNodeFactory getNodeFactory()
public ConstructorDetector getConstructorDetector()
public BeanDescription introspect(JavaType type)
type
- Type of class to be introspectedpublic BeanDescription introspectForCreation(JavaType type)
public BeanDescription introspectForBuilder(JavaType builderType, BeanDescription valueTypeDesc)
@Deprecated public BeanDescription introspectForBuilder(JavaType type)
public TypeDeserializer findTypeDeserializer(JavaType baseType) throws JsonMappingException
AtomicReference
,
or various "optional" types.JsonMappingException
public CoercionAction findCoercionAction(LogicalType targetType, Class<?> targetClass, CoercionInputShape inputShape)
targetType
- Logical target type of coerciontargetClass
- Physical target type of coercioninputShape
- Input shape to coerce frompublic CoercionAction findCoercionFromBlankString(LogicalType targetType, Class<?> targetClass, CoercionAction actionIfBlankNotAllowed)
actionIfBlankNotAllowed
, otherwise returns action for
CoercionInputShape.EmptyString
.targetType
- Logical target type of coerciontargetClass
- Physical target type of coercionactionIfBlankNotAllowed
- Return value to use in case "blanks as empty"
is not allowedCopyright © 2008–2022 FasterXML. All rights reserved.