public abstract class DeserializationContext extends DatabindContext implements java.io.Serializable
Instance life-cycle is such that a partially configured "blueprint" object
is registered with ObjectMapper
(and ObjectReader
,
and when actual instance is needed for deserialization,
a fully configured instance will be created using a method in extended internal
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 if (and only if) no configuration has changed.
Defined as abstract class so that implementations must define methods for reconfiguring blueprints and creating instances.
Modifier and Type | Method and Description |
---|---|
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.
|
java.util.Calendar |
constructCalendar(java.util.Date d)
Convenience method for constructing Calendar instance set
to specified time, to be modified and used by caller.
|
JavaType |
constructType(java.lang.Class<?> cls)
Convenience method, functionally equivalent to:
|
abstract JsonDeserializer<java.lang.Object> |
deserializerInstance(Annotated annotated,
java.lang.Object deserDef) |
JsonMappingException |
endOfInputException(java.lang.Class<?> instClass)
Deprecated.
Since 2.8; currently no way to catch EOF at databind level
|
java.lang.Class<?> |
findClass(java.lang.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<java.lang.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.
|
java.lang.Object |
findInjectableValue(java.lang.Object valueId,
BeanProperty forProperty,
java.lang.Object beanInstance) |
KeyDeserializer |
findKeyDeserializer(JavaType keyType,
BeanProperty prop)
Convenience method, functionally same as:
|
JsonDeserializer<java.lang.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(java.lang.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<java.lang.Object> |
findRootValueDeserializer(JavaType type)
Method for finding a deserializer for root-level value.
|
java.lang.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[]).
|
java.lang.Object |
getAttribute(java.lang.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. |
JsonFormat.Value |
getDefaultPropertyFormat(java.lang.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 . |
java.util.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.
|
java.util.TimeZone |
getTimeZone()
Method for accessing default TimeZone to use: convenience method for
|
TypeFactory |
getTypeFactory() |
java.lang.Object |
handleInstantiationProblem(java.lang.Class<?> instClass,
java.lang.Object argument,
java.lang.Throwable t)
Method that deserializers should call if they fail to instantiate value
due to an exception that was thrown by constructor (or other mechanism used
to create instances).
|
java.lang.Object |
handleMissingInstantiator(java.lang.Class<?> instClass,
ValueInstantiator valueInst,
JsonParser p,
java.lang.String msg,
java.lang.Object... msgArgs)
Method that deserializers should call if they fail to instantiate value
due to lack of viable instantiator (usually creator, that is, constructor
or static factory method).
|
JavaType |
handleMissingTypeId(JavaType baseType,
TypeIdResolver idResolver,
java.lang.String extraDesc) |
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,
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. |
java.lang.Object |
handleUnexpectedToken(java.lang.Class<?> instClass,
JsonParser p)
Method that deserializers should call if the first token of the value to
deserialize is of unexpected type (that is, type of token that deserializer
cannot handle).
|
java.lang.Object |
handleUnexpectedToken(java.lang.Class<?> instClass,
JsonToken t,
JsonParser p,
java.lang.String msg,
java.lang.Object... msgArgs)
Method that deserializers should call if the first token of the value to
deserialize is of unexpected type (that is, type of token that deserializer
cannot handle).
|
boolean |
handleUnknownProperty(JsonParser p,
JsonDeserializer<?> deser,
java.lang.Object instanceOrClass,
java.lang.String propName)
Method that deserializers should call if they encounter an unrecognized
property (and once that is not explicitly designed as ignorable), to
inform possibly configured
DeserializationProblemHandler s and
let it handle the problem. |
JavaType |
handleUnknownTypeId(JavaType baseType,
java.lang.String id,
TypeIdResolver idResolver,
java.lang.String extraDesc)
Method that deserializers should call if they encounter a type id
(for polymorphic deserialization) that cannot be resolved to an
actual type; usually since there is no mapping defined.
|
java.lang.Object |
handleWeirdKey(java.lang.Class<?> keyClass,
java.lang.String keyValue,
java.lang.String msg,
java.lang.Object... msgArgs)
Method that deserializers should call if they encounter a String value
that cannot be converted to expected key of a
Map
valued property. |
java.lang.Object |
handleWeirdNativeValue(JavaType targetType,
java.lang.Object badValue,
JsonParser p) |
java.lang.Object |
handleWeirdNumberValue(java.lang.Class<?> targetClass,
java.lang.Number value,
java.lang.String msg,
java.lang.Object... msgArgs)
Method that deserializers should call if they encounter a numeric value
that cannot be converted to target property type, in cases where some
numeric values could be acceptable (either with different settings,
or different numeric value).
|
java.lang.Object |
handleWeirdStringValue(java.lang.Class<?> targetClass,
java.lang.String value,
java.lang.String msg,
java.lang.Object... msgArgs)
Method that deserializers should call if they encounter a String value
that cannot be converted to target property type, in cases where some
String values could be acceptable (either with different settings,
or different value).
|
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,
java.util.concurrent.atomic.AtomicReference<java.lang.Throwable> cause)
Method for checking whether we could find a deserializer
for given type.
|
JsonMappingException |
instantiationException(java.lang.Class<?> instClass,
java.lang.String msg0)
Helper method for constructing instantiation exception for specified type,
to indicate that instantiation failed due to missing instantiator
(creator; constructor or factory method).
|
JsonMappingException |
instantiationException(java.lang.Class<?> instClass,
java.lang.Throwable cause)
Helper method for constructing instantiation exception for specified type,
to indicate problem with physically constructing instance of
specified class (missing constructor, exception from constructor)
|
JsonMappingException |
invalidTypeIdException(JavaType baseType,
java.lang.String typeId,
java.lang.String extraDesc)
Helper method for constructing exception to indicate that given type id
could not be resolved to a valid subtype of specified base type.
|
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,
java.lang.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(java.lang.Class<?> targetClass)
Deprecated.
Since 2.8 use
handleUnexpectedToken(Class, JsonParser) instead |
JsonMappingException |
mappingException(java.lang.Class<?> targetClass,
JsonToken token)
Deprecated.
Since 2.8 use
handleUnexpectedToken(Class, JsonParser) instead |
JsonMappingException |
mappingException(java.lang.String message)
Deprecated.
Since 2.9 use more specific error reporting methods instead
|
JsonMappingException |
mappingException(java.lang.String msg,
java.lang.Object... msgArgs)
Deprecated.
Since 2.9 use more specific error reporting methods instead
|
JsonMappingException |
missingTypeIdException(JavaType baseType,
java.lang.String extraDesc) |
java.util.Date |
parseDate(java.lang.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,
java.lang.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,
java.lang.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) |
<T> T |
reportBadDefinition(JavaType type,
java.lang.String msg)
Helper method called to indicate a generic problem that stems from type
definition(s), not input data, or input/output state; typically this
means throwing a
InvalidDefinitionException . |
<T> T |
reportBadMerge(JsonDeserializer<?> deser)
Method that deserializer may call if it is called to do an update ("merge")
but deserializer operates on a non-mergeable type.
|
<T> T |
reportBadPropertyDefinition(BeanDescription bean,
BeanPropertyDefinition prop,
java.lang.String msg,
java.lang.Object... msgArgs)
Helper method called to indicate problem in POJO (serialization) definitions or settings
regarding specific property (of a type), unrelated to actual JSON content to map.
|
<T> T |
reportBadTypeDefinition(BeanDescription bean,
java.lang.String msg,
java.lang.Object... msgArgs)
Helper method called to indicate problem in POJO (serialization) definitions or settings
regarding specific Java type, unrelated to actual JSON content to map.
|
<T> T |
reportInputMismatch(BeanProperty prop,
java.lang.String msg,
java.lang.Object... msgArgs)
Helper method used to indicate a problem with input in cases where more
specific
reportXxx() method was not available. |
<T> T |
reportInputMismatch(java.lang.Class<?> targetType,
java.lang.String msg,
java.lang.Object... msgArgs)
Helper method used to indicate a problem with input in cases where more
specific
reportXxx() method was not available. |
<T> T |
reportInputMismatch(JavaType targetType,
java.lang.String msg,
java.lang.Object... msgArgs)
Helper method used to indicate a problem with input in cases where more
specific
reportXxx() method was not available. |
<T> T |
reportInputMismatch(JsonDeserializer<?> src,
java.lang.String msg,
java.lang.Object... msgArgs)
Helper method used to indicate a problem with input in cases where more
specific
reportXxx() method was not available. |
void |
reportMappingException(java.lang.String msg,
java.lang.Object... msgArgs)
Deprecated.
Since 2.9: use a more specific method, or
reportBadDefinition(JavaType, String) ,
or reportInputMismatch(com.fasterxml.jackson.databind.BeanProperty, java.lang.String, java.lang.Object...) instead |
void |
reportMissingContent(java.lang.String msg,
java.lang.Object... msgArgs)
Deprecated.
Since 2.9: not clear this ever occurs
|
<T> T |
reportTrailingTokens(java.lang.Class<?> targetType,
JsonParser p,
JsonToken trailingToken) |
void |
reportUnknownProperty(java.lang.Object instanceOrClass,
java.lang.String fieldName,
JsonDeserializer<?> deser)
|
<T> T |
reportUnresolvedObjectId(ObjectIdReader oidReader,
java.lang.Object bean) |
void |
reportWrongTokenException(java.lang.Class<?> targetType,
JsonToken expToken,
java.lang.String msg,
java.lang.Object... msgArgs)
Method for deserializers to call
when the token encountered was of type different than what should
be seen at that position, usually within a sequence of expected tokens.
|
void |
reportWrongTokenException(JavaType targetType,
JsonToken expToken,
java.lang.String msg,
java.lang.Object... msgArgs)
Method for deserializers to call
when the token encountered was of type different than what should
be seen at that position, usually within a sequence of expected tokens.
|
void |
reportWrongTokenException(JsonDeserializer<?> deser,
JsonToken expToken,
java.lang.String msg,
java.lang.Object... msgArgs)
Method for deserializers to call
when the token encountered was of type different than what should
be seen at that position, usually within a sequence of expected tokens.
|
void |
reportWrongTokenException(JsonParser p,
JsonToken expToken,
java.lang.String msg,
java.lang.Object... msgArgs)
Deprecated.
|
void |
returnObjectBuffer(ObjectBuffer buf)
Method to call to return object buffer previously leased with
leaseObjectBuffer() . |
DeserializationContext |
setAttribute(java.lang.Object key,
java.lang.Object value)
Method for setting per-call value of given attribute.
|
JsonMappingException |
unknownTypeException(JavaType type,
java.lang.String id,
java.lang.String extraDesc)
|
JsonMappingException |
weirdKeyException(java.lang.Class<?> keyClass,
java.lang.String keyValue,
java.lang.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 |
weirdNativeValueException(java.lang.Object value,
java.lang.Class<?> instClass)
Helper method for constructing exception to indicate that input JSON
token of type "native value" (see
JsonToken.VALUE_EMBEDDED_OBJECT )
is of incompatible type (and there is no delegating creator or such to use)
and can not be used to construct value of specified type (usually POJO). |
JsonMappingException |
weirdNumberException(java.lang.Number value,
java.lang.Class<?> instClass,
java.lang.String msg)
Helper method for constructing exception to indicate that input JSON
Number was not suitable for deserializing into given target type.
|
JsonMappingException |
weirdStringException(java.lang.String value,
java.lang.Class<?> instClass,
java.lang.String msg)
Helper method for constructing exception to indicate that input JSON
String was not suitable for deserializing into given target type.
|
JsonMappingException |
wrongTokenException(JsonParser p,
java.lang.Class<?> targetType,
JsonToken expToken,
java.lang.String extra) |
JsonMappingException |
wrongTokenException(JsonParser p,
JavaType targetType,
JsonToken expToken,
java.lang.String extra)
Helper method for constructing
JsonMappingException to indicate
that the token encountered was of type different than what should
be seen at that position, usually within a sequence of expected tokens. |
JsonMappingException |
wrongTokenException(JsonParser p,
JsonToken expToken,
java.lang.String msg)
Deprecated.
|
constructSpecializedType, constructType, converterInstance, objectIdGeneratorInstance, objectIdResolverInstance, reportBadDefinition, resolveSubType
public DeserializationConfig getConfig()
DatabindContext
getConfig
in class DatabindContext
public final java.lang.Class<?> getActiveView()
DatabindContext
getActiveView
in class DatabindContext
public final boolean canOverrideAccessModifiers()
DatabindContext
getConfig().canOverrideAccessModifiers();
canOverrideAccessModifiers
in class DatabindContext
public final boolean isEnabled(MapperFeature feature)
DatabindContext
getConfig().isEnabled(feature);
isEnabled
in class DatabindContext
public final JsonFormat.Value getDefaultPropertyFormat(java.lang.Class<?> baseType)
getDefaultPropertyFormat
in class DatabindContext
public final AnnotationIntrospector getAnnotationIntrospector()
DatabindContext
getConfig().getAnnotationIntrospector();
getAnnotationIntrospector
in class DatabindContext
public final TypeFactory getTypeFactory()
getTypeFactory
in class DatabindContext
public java.util.Locale getLocale()
getConfig().getLocale();
getLocale
in class DatabindContext
public java.util.TimeZone getTimeZone()
getConfig().getTimeZone();
getTimeZone
in class DatabindContext
public java.lang.Object getAttribute(java.lang.Object key)
DatabindContext
ObjectReader
or ObjectWriter
have lower
precedence.getAttribute
in class DatabindContext
key
- Key of the attribute to getpublic DeserializationContext setAttribute(java.lang.Object key, java.lang.Object value)
DatabindContext
setAttribute
in class DatabindContext
key
- Key of the attribute to setvalue
- Value to set attribute topublic JavaType getContextualType()
JavaType
of currently contextualized
ContextualDeserializer
, if any.
This is sometimes useful for generic JsonDeserializer
s that
do not get passed (or do not retain) type information when being
constructed: happens for example for deserializers constructed
from annotations.ContextualDeserializer
being contextualized,
if process is on-going; null if not.public DeserializerFactory getFactory()
DeserializerFactory
.public final boolean isEnabled(DeserializationFeature feat)
public final int getDeserializationFeatures()
DeserializationFeature
s
that are enabled.public final boolean hasDeserializationFeatures(int featureMask)
public final boolean hasSomeOfFeatures(int featureMask)
public final JsonParser getParser()
Use of this method is discouraged: if code has direct access to the active parser, that should be used instead.
public final java.lang.Object findInjectableValue(java.lang.Object valueId, BeanProperty forProperty, java.lang.Object beanInstance) throws JsonMappingException
JsonMappingException
public final Base64Variant getBase64Variant()
getConfig().getBase64Variant();
public final JsonNodeFactory getNodeFactory()
getConfig().getNodeFactory();
public boolean hasValueDeserializerFor(JavaType type, java.util.concurrent.atomic.AtomicReference<java.lang.Throwable> cause)
type
- public final JsonDeserializer<java.lang.Object> findContextualValueDeserializer(JavaType type, BeanProperty prop) throws JsonMappingException
JsonMappingException
public final JsonDeserializer<java.lang.Object> findNonContextualValueDeserializer(JavaType type) throws JsonMappingException
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.JsonMappingException
public final JsonDeserializer<java.lang.Object> findRootValueDeserializer(JavaType type) throws JsonMappingException
JsonMappingException
public final KeyDeserializer findKeyDeserializer(JavaType keyType, BeanProperty prop) throws JsonMappingException
getDeserializerProvider().findKeyDeserializer(getConfig(), prop.getType(), prop);
JsonMappingException
public abstract ReadableObjectId findObjectId(java.lang.Object id, ObjectIdGenerator<?> generator, ObjectIdResolver resolver)
public abstract void checkUnresolvedObjectId() throws UnresolvedForwardReference
UnresolvedForwardReference
public final JavaType constructType(java.lang.Class<?> cls)
getConfig().constructType(cls);
public java.lang.Class<?> findClass(java.lang.String className) throws java.lang.ClassNotFoundException
java.lang.ClassNotFoundException
public final ObjectBuffer leaseObjectBuffer()
public final void returnObjectBuffer(ObjectBuffer buf)
leaseObjectBuffer()
.buf
- Returned object bufferpublic final ArrayBuilders getArrayBuilders()
public abstract JsonDeserializer<java.lang.Object> deserializerInstance(Annotated annotated, java.lang.Object deserDef) throws JsonMappingException
JsonMappingException
public abstract KeyDeserializer keyDeserializerInstance(Annotated annotated, java.lang.Object deserDef) throws JsonMappingException
JsonMappingException
public JsonDeserializer<?> handlePrimaryContextualization(JsonDeserializer<?> deser, BeanProperty prop, JavaType type) throws JsonMappingException
ContextualDeserializer
with given property context.prop
- Property for which the given primary deserializer is used; never null.JsonMappingException
public JsonDeserializer<?> handleSecondaryContextualization(JsonDeserializer<?> deser, BeanProperty prop, JavaType type) throws JsonMappingException
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.prop
- Property for which deserializer is used, if any; null
when deserializing root valuesJsonMappingException
public java.util.Date parseDate(java.lang.String dateStr) throws java.lang.IllegalArgumentException
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.
java.lang.IllegalArgumentException
public java.util.Calendar constructCalendar(java.util.Date d)
public <T> T readValue(JsonParser p, java.lang.Class<T> type) throws java.io.IOException
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.
java.io.IOException
public <T> T readValue(JsonParser p, JavaType type) throws java.io.IOException
java.io.IOException
public <T> T readPropertyValue(JsonParser p, BeanProperty prop, java.lang.Class<T> type) throws java.io.IOException
java.io.IOException
public <T> T readPropertyValue(JsonParser p, BeanProperty prop, JavaType type) throws java.io.IOException
java.io.IOException
public boolean handleUnknownProperty(JsonParser p, JsonDeserializer<?> deser, java.lang.Object instanceOrClass, java.lang.String propName) throws java.io.IOException
DeserializationProblemHandler
s and
let it handle the problem.java.io.IOException
public java.lang.Object handleWeirdKey(java.lang.Class<?> keyClass, java.lang.String keyValue, java.lang.String msg, java.lang.Object... msgArgs) throws java.io.IOException
Map
valued property.
Default implementation will try to call DeserializationProblemHandler.handleWeirdNumberValue(com.fasterxml.jackson.databind.DeserializationContext, java.lang.Class<?>, java.lang.Number, java.lang.String)
on configured handlers, if any, to allow for recovery; if recovery does not
succeed, will throw InvalidFormatException
with given message.keyClass
- Expected type for keykeyValue
- String value from which to deserialize keymsg
- Error message template caller wants to use if exception is to be thrownmsgArgs
- Optional arguments to use for message, if anyjava.io.IOException
- To indicate unrecoverable problem, usually based on msg
public java.lang.Object handleWeirdStringValue(java.lang.Class<?> targetClass, java.lang.String value, java.lang.String msg, java.lang.Object... msgArgs) throws java.io.IOException
DeserializationProblemHandler.handleWeirdStringValue(com.fasterxml.jackson.databind.DeserializationContext, java.lang.Class<?>, java.lang.String, java.lang.String)
on configured handlers, if any, to allow for recovery; if recovery does not
succeed, will throw InvalidFormatException
with given message.targetClass
- Type of property into which incoming number should be convertedvalue
- String value from which to deserialize property valuemsg
- Error message template caller wants to use if exception is to be thrownmsgArgs
- Optional arguments to use for message, if anyjava.io.IOException
- To indicate unrecoverable problem, usually based on msg
public java.lang.Object handleWeirdNumberValue(java.lang.Class<?> targetClass, java.lang.Number value, java.lang.String msg, java.lang.Object... msgArgs) throws java.io.IOException
DeserializationProblemHandler.handleWeirdNumberValue(com.fasterxml.jackson.databind.DeserializationContext, java.lang.Class<?>, java.lang.Number, java.lang.String)
on configured handlers, if any, to allow for recovery; if recovery does not
succeed, will throw InvalidFormatException
with given message.targetClass
- Type of property into which incoming number should be convertedvalue
- Number value from which to deserialize property valuemsg
- Error message template caller wants to use if exception is to be thrownmsgArgs
- Optional arguments to use for message, if anyjava.io.IOException
- To indicate unrecoverable problem, usually based on msg
public java.lang.Object handleWeirdNativeValue(JavaType targetType, java.lang.Object badValue, JsonParser p) throws java.io.IOException
java.io.IOException
public java.lang.Object handleMissingInstantiator(java.lang.Class<?> instClass, ValueInstantiator valueInst, JsonParser p, java.lang.String msg, java.lang.Object... msgArgs) throws java.io.IOException
instClass
- Type that was to be instantiatedvalueInst
- (optional) Value instantiator to be used, if any; null if type does not
use one for instantiation (custom deserialiers don't; standard POJO deserializer does)p
- Parser that points to the JSON value to decodeinstClass
java.io.IOException
ValueInstantiator
)public java.lang.Object handleInstantiationProblem(java.lang.Class<?> instClass, java.lang.Object argument, java.lang.Throwable t) throws java.io.IOException
DeserializationProblemHandler.handleInstantiationProblem(com.fasterxml.jackson.databind.DeserializationContext, java.lang.Class<?>, java.lang.Object, java.lang.Throwable)
on configured handlers, if any, to allow for recovery; if recovery does not
succeed, will throw exception constructed with instantiationException(java.lang.Class<?>, java.lang.Throwable)
.instClass
- Type that was to be instantiatedargument
- (optional) Argument that was passed to constructor or equivalent
instantiator; often a String
.t
- Exception that caused failureinstClass
java.io.IOException
public java.lang.Object handleUnexpectedToken(java.lang.Class<?> instClass, JsonParser p) throws java.io.IOException
JsonToken.START_ARRAY
instead of
JsonToken.VALUE_NUMBER_INT
or JsonToken.VALUE_NUMBER_FLOAT
.instClass
- Type that was to be instantiatedp
- Parser that points to the JSON value to decodeinstClass
java.io.IOException
public java.lang.Object handleUnexpectedToken(java.lang.Class<?> instClass, JsonToken t, JsonParser p, java.lang.String msg, java.lang.Object... msgArgs) throws java.io.IOException
JsonToken.START_ARRAY
instead of
JsonToken.VALUE_NUMBER_INT
or JsonToken.VALUE_NUMBER_FLOAT
.instClass
- Type that was to be instantiatedt
- Token encountered that does match expectedp
- Parser that points to the JSON value to decodeinstClass
java.io.IOException
public JavaType handleUnknownTypeId(JavaType baseType, java.lang.String id, TypeIdResolver idResolver, java.lang.String extraDesc) throws java.io.IOException
DeserializationProblemHandler.handleUnknownTypeId(com.fasterxml.jackson.databind.DeserializationContext, com.fasterxml.jackson.databind.JavaType, java.lang.String, com.fasterxml.jackson.databind.jsontype.TypeIdResolver, java.lang.String)
on configured handlers, if any, to allow for recovery; if recovery does not
succeed, will throw exception constructed with invalidTypeIdException(com.fasterxml.jackson.databind.JavaType, java.lang.String, java.lang.String)
.baseType
- Base type from which resolution startsid
- Type id that could not be convertedextraDesc
- Additional problem description to add to default exception message,
if resolution fails.JavaType
that id resolves tojava.io.IOException
- To indicate unrecoverable problem, if resolution cannot
be made to workpublic JavaType handleMissingTypeId(JavaType baseType, TypeIdResolver idResolver, java.lang.String extraDesc) throws java.io.IOException
java.io.IOException
public void reportWrongTokenException(JsonDeserializer<?> deser, JsonToken expToken, java.lang.String msg, java.lang.Object... msgArgs) throws JsonMappingException
JsonMappingException
and no
recovery is attempted (via DeserializationProblemHandler
, as
problem is considered to be difficult to recover from, in general.JsonMappingException
public void reportWrongTokenException(JavaType targetType, JsonToken expToken, java.lang.String msg, java.lang.Object... msgArgs) throws JsonMappingException
JsonMappingException
and no
recovery is attempted (via DeserializationProblemHandler
, as
problem is considered to be difficult to recover from, in general.JsonMappingException
public void reportWrongTokenException(java.lang.Class<?> targetType, JsonToken expToken, java.lang.String msg, java.lang.Object... msgArgs) throws JsonMappingException
JsonMappingException
and no
recovery is attempted (via DeserializationProblemHandler
, as
problem is considered to be difficult to recover from, in general.JsonMappingException
public <T> T reportUnresolvedObjectId(ObjectIdReader oidReader, java.lang.Object bean) throws JsonMappingException
JsonMappingException
public <T> T reportInputMismatch(BeanProperty prop, java.lang.String msg, java.lang.Object... msgArgs) throws JsonMappingException
reportXxx()
method was not available.JsonMappingException
public <T> T reportInputMismatch(JsonDeserializer<?> src, java.lang.String msg, java.lang.Object... msgArgs) throws JsonMappingException
reportXxx()
method was not available.JsonMappingException
public <T> T reportInputMismatch(java.lang.Class<?> targetType, java.lang.String msg, java.lang.Object... msgArgs) throws JsonMappingException
reportXxx()
method was not available.JsonMappingException
public <T> T reportInputMismatch(JavaType targetType, java.lang.String msg, java.lang.Object... msgArgs) throws JsonMappingException
reportXxx()
method was not available.JsonMappingException
public <T> T reportTrailingTokens(java.lang.Class<?> targetType, JsonParser p, JsonToken trailingToken) throws JsonMappingException
JsonMappingException
@Deprecated public void reportWrongTokenException(JsonParser p, JsonToken expToken, java.lang.String msg, java.lang.Object... msgArgs) throws JsonMappingException
JsonMappingException
@Deprecated public void reportUnknownProperty(java.lang.Object instanceOrClass, java.lang.String fieldName, JsonDeserializer<?> deser) throws JsonMappingException
handleUnknownProperty(com.fasterxml.jackson.core.JsonParser, com.fasterxml.jackson.databind.JsonDeserializer<?>, java.lang.Object, java.lang.String)
insteadinstanceOrClass
- Either value being populated (if one has been
instantiated), or Class that indicates type that would be (or
have been) instantiateddeser
- Deserializer that had the problem, if called by deserializer
(or on behalf of one)JsonMappingException
@Deprecated public void reportMissingContent(java.lang.String msg, java.lang.Object... msgArgs) throws JsonMappingException
JsonMappingException
public <T> T reportBadTypeDefinition(BeanDescription bean, java.lang.String msg, java.lang.Object... msgArgs) throws JsonMappingException
JsonMappingException
.JsonMappingException
public <T> T reportBadPropertyDefinition(BeanDescription bean, BeanPropertyDefinition prop, java.lang.String msg, java.lang.Object... msgArgs) throws JsonMappingException
JsonMappingException
.JsonMappingException
public <T> T reportBadDefinition(JavaType type, java.lang.String msg) throws JsonMappingException
DatabindContext
InvalidDefinitionException
.reportBadDefinition
in class DatabindContext
JsonMappingException
public <T> T reportBadMerge(JsonDeserializer<?> deser) throws JsonMappingException
MapperFeature.IGNORE_MERGE_FOR_UNMERGEABLE
is enabled,
this method will simply return null; otherwise InvalidDefinitionException
will be thrown.JsonMappingException
public JsonMappingException wrongTokenException(JsonParser p, JavaType targetType, JsonToken expToken, java.lang.String extra)
JsonMappingException
to indicate
that the token encountered was of type different than what should
be seen at that position, usually within a sequence of expected tokens.
Note that most of the time this method should NOT be directly called;
instead, reportWrongTokenException(com.fasterxml.jackson.databind.JsonDeserializer<?>, com.fasterxml.jackson.core.JsonToken, java.lang.String, java.lang.Object...)
should be called and will
call this method as necessary.public JsonMappingException wrongTokenException(JsonParser p, java.lang.Class<?> targetType, JsonToken expToken, java.lang.String extra)
@Deprecated public JsonMappingException wrongTokenException(JsonParser p, JsonToken expToken, java.lang.String msg)
public JsonMappingException weirdKeyException(java.lang.Class<?> keyClass, java.lang.String keyValue, java.lang.String msg)
handleWeirdKey(java.lang.Class<?>, java.lang.String, java.lang.String, java.lang.Object...)
should be called which will call this method
if necessary.public JsonMappingException weirdStringException(java.lang.String value, java.lang.Class<?> instClass, java.lang.String msg)
handleWeirdStringValue(java.lang.Class<?>, java.lang.String, java.lang.String, java.lang.Object...)
should be called which will call this method
if necessary.value
- String value from input being deserializedinstClass
- Type that String should be deserialized intomsg
- Message that describes specific problempublic JsonMappingException weirdNumberException(java.lang.Number value, java.lang.Class<?> instClass, java.lang.String msg)
handleWeirdNumberValue(java.lang.Class<?>, java.lang.Number, java.lang.String, java.lang.Object...)
should be called which will call this method
if necessary.public JsonMappingException weirdNativeValueException(java.lang.Object value, java.lang.Class<?> instClass)
JsonToken.VALUE_EMBEDDED_OBJECT
)
is of incompatible type (and there is no delegating creator or such to use)
and can not be used to construct value of specified type (usually POJO).
Note that most of the time this method should NOT be called; instead,
handleWeirdNativeValue(com.fasterxml.jackson.databind.JavaType, java.lang.Object, com.fasterxml.jackson.core.JsonParser)
should be called which will call this methodpublic JsonMappingException instantiationException(java.lang.Class<?> instClass, java.lang.Throwable cause)
Note that most of the time this method should NOT be called; instead,
handleInstantiationProblem(java.lang.Class<?>, java.lang.Object, java.lang.Throwable)
should be called which will call this method
if necessary.
public JsonMappingException instantiationException(java.lang.Class<?> instClass, java.lang.String msg0)
Note that most of the time this method should NOT be called; instead,
handleMissingInstantiator(java.lang.Class<?>, com.fasterxml.jackson.databind.deser.ValueInstantiator, com.fasterxml.jackson.core.JsonParser, java.lang.String, java.lang.Object...)
should be called which will call this method
if necessary.
public JsonMappingException invalidTypeIdException(JavaType baseType, java.lang.String typeId, java.lang.String extraDesc)
DatabindContext
Note that most of the time this method should NOT be called directly: instead,
method handleUnknownTypeId()
should be called which will call this method
if necessary.
public JsonMappingException missingTypeIdException(JavaType baseType, java.lang.String extraDesc)
@Deprecated public JsonMappingException unknownTypeException(JavaType type, java.lang.String id, java.lang.String extraDesc)
handleUnknownTypeId(com.fasterxml.jackson.databind.JavaType, java.lang.String, com.fasterxml.jackson.databind.jsontype.TypeIdResolver, java.lang.String)
instead@Deprecated public JsonMappingException endOfInputException(java.lang.Class<?> instClass)
@Deprecated public void reportMappingException(java.lang.String msg, java.lang.Object... msgArgs) throws JsonMappingException
reportBadDefinition(JavaType, String)
,
or reportInputMismatch(com.fasterxml.jackson.databind.BeanProperty, java.lang.String, java.lang.Object...)
insteadreportXxx
is applicable -- but only in that case.JsonMappingException
@Deprecated public JsonMappingException mappingException(java.lang.String message)
handleXxx
methods, or reportMappingException(String, Object...)
instead.@Deprecated public JsonMappingException mappingException(java.lang.String msg, java.lang.Object... msgArgs)
handleXxx
methods, or reportMappingException(String, Object...)
instead.@Deprecated public JsonMappingException mappingException(java.lang.Class<?> targetClass)
handleUnexpectedToken(Class, JsonParser)
instead@Deprecated public JsonMappingException mappingException(java.lang.Class<?> targetClass, JsonToken token)
handleUnexpectedToken(Class, JsonParser)
instead"Copyright © 2010 - 2020 Adobe Systems Incorporated. All Rights Reserved"