Module tools.jackson.databind

Package tools.jackson.databind.deser

Class DeserializationContextExt

java.lang.Object

tools.jackson.databind.DatabindContext

tools.jackson.databind.DeserializationContext

tools.jackson.databind.deser.DeserializationContextExt

All Implemented Interfaces:

ObjectReadContext

Direct Known Subclasses:

DeserializationContextExt.Impl

public abstract class DeserializationContextExt
extends DeserializationContext

Complete DeserializationContext implementation that adds extended API for ObjectMapper (and ObjectReader) to call, as well as implements certain parts that base class has left abstract.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	DeserializationContextExt.Impl	Actual full concrete implementation

Nested classes/interfaces inherited from interface tools.jackson.core.ObjectReadContext

ObjectReadContext.Base

Field Summary

Fields

Modifier and Type	Field	Description
protected LinkedHashMap<ObjectIdGenerator.IdKey,ReadableObjectId>	_objectIds

Fields inherited from class tools.jackson.databind.DeserializationContext

_activeView, _arrayBuilders, _attributes, _cache, _classIntrospector, _config, _currentType, _dateFormat, _delegateBindDepth, _factory, _featureFlags, _injectableValues, _objectBuffer, _parser, _readCapabilities, _schema, _streamFactory

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	DeserializationContextExt(TokenStreamFactory tsf, DeserializerFactory deserializerFactory, DeserializerCache cache, DeserializationConfig config, FormatSchema schema, InjectableValues values)	Constructor that will pass specified deserializer factory and cache: cache may be null (in which case default implementation will be used), factory cannot be null

Method Summary

Modifier and Type	Method	Description
protected Object	_unwrapAndDeserialize(JsonParser p, JavaType rootType, ValueDeserializer<Object> deser, Object valueToUpdate)
void	addPendingForwardRef(Object container)	Method to register that a forward Object Id reference has been recorded against the given container object (typically a builder).
JsonParser	assignAndReturnParser(JsonParser p)
DeserializationContextExt	assignParser(JsonParser p)
void	checkUnresolvedObjectId()	Method called to ensure that every object id encounter during processing are resolved.
protected ReadableObjectId	createReadableObjectId(ObjectIdGenerator.IdKey key)	Overridable factory method to create a new instance of ReadableObjectId or its subclass.
ValueDeserializer<Object>	deserializerInstance(Annotated ann, Object deserDef)
ReadableObjectId	findObjectId(Object id, ObjectIdGenerator<?> gen, ObjectIdResolver resolverType)	Method called to find and return entry corresponding to given Object Id: will add an entry if necessary, and never returns null
boolean	hasPendingForwardRefsFor(Object builder)	Method for checking whether the given container object has any pending unresolved forward Object Id references registered against it.
final KeyDeserializer	keyDeserializerInstance(Annotated ann, Object deserDef)
Object	readRootValue(JsonParser p, JavaType valueType, ValueDeserializer<Object> deser, Object valueToUpdate)
void	removePendingForwardRef(Object container)	Method to remove a container object from the pending forward reference tracking set, called when the forward reference has been resolved.
protected boolean	tryToResolveUnresolvedObjectId(ReadableObjectId roid)	Overridable helper method called to try to resolve otherwise unresolvable ReadableObjectId; and if this succeeds, return true to indicate problem has been resolved in some way, so that caller can avoid reporting it as an error.
void	updateObjectId(Object delegate, Object newItem)	Method called to update Object Id binding from an intermediate delegate object to the final bean produced by a delegating @JsonCreator.

Methods inherited from class tools.jackson.databind.DeserializationContext

_getDateFormat, _isCompatible, _shapeForToken, bufferAsCopyOfValue, bufferForInputBuffering, bufferForInputBuffering, canOverrideAccessModifiers, classIntrospector, constructCalendar, constructSpecializedType, constructType, createArrayNode, createObjectNode, enterDelegateBindPending, exitDelegateBindPending, extractScalarFromObject, findClass, findCoercionAction, findCoercionFromBlankString, findContextualValueDeserializer, findInjectableValue, findKeyDeserializer, findNonContextualValueDeserializer, findPropertyContentTypeDeserializer, findPropertyTypeDeserializer, findRootName, findRootName, findRootValueDeserializer, findTypeDeserializer, findTypeDeserializer, flushCachedDeserializers, getActiveView, getAnnotationIntrospector, getArrayBuilders, getAttribute, getBase64Variant, getConfig, getContextualType, getDatatypeFeatures, getDefaultPropertyFormat, getDeserializationFeatures, getFormatReadFeatures, getLocale, getNodeFactory, getParser, getSchema, getStreamReadFeatures, getTimeZone, getTypeFactory, handleBadMerge, handleInstantiationProblem, handleMissingInstantiator, handleMissingTypeId, handleNullForPrimitives, handlePrimaryContextualization, handleSecondaryContextualization, handleUnexpectedToken, handleUnexpectedToken, handleUnexpectedToken, handleUnknownProperty, handleUnknownTypeId, handleWeirdKey, handleWeirdNativeValue, handleWeirdNumberValue, handleWeirdStringValue, hasDeserializationFeatures, hasExplicitDeserializerFor, hasSomeOfFeatures, instantiationException, instantiationException, introspectBeanDescription, introspectBeanDescriptionForBuilder, introspectBeanDescriptionForCreation, introspectBeanDescriptionForCreation, invalidTypeIdException, isDelegateBindPending, isEnabled, isEnabled, isEnabled, isEnabled, lazyIntrospectBeanDescriptionForBuilder, lazyIntrospectBeanDescriptionForCreation, leaseObjectBuffer, missingInjectableValueException, missingTypeIdException, parseDate, readPropertyValue, readPropertyValue, readTree, readTreeAsValue, readTreeAsValue, readValue, readValue, readValue, readValue, reportBadCoercion, reportBadDefinition, reportBadPropertyDefinition, reportBadPropertyDefinition, reportBadTypeDefinition, reportInputMismatch, reportInputMismatch, reportInputMismatch, reportInputMismatch, reportPropertyInputMismatch, reportPropertyInputMismatch, reportTrailingTokens, reportUnresolvedObjectId, reportWrongTokenException, reportWrongTokenException, reportWrongTokenException, returnObjectBuffer, setAttribute, streamReadConstraints, tokenStreamFactory, weirdKeyException, weirdNativeValueException, weirdNumberException, weirdStringException, wrongTokenException, wrongTokenException

Methods inherited from class tools.jackson.databind.DatabindContext

_colonConcat, _desc, _format, _quotedString, _throwNotASubtype, _throwSubtypeClassNotAllowed, _throwSubtypeNameNotAllowed, _truncate, canonicalizeString, constructType, converterInstance, introspectBeanDescription, introspectClassAnnotations, introspectClassAnnotations, introspectDirectClassAnnotations, isAnnotationProcessingEnabled, lazyIntrospectBeanDescription, objectIdGeneratorInstance, objectIdResolverInstance, reportBadDefinition, reportBadTypeDefinition, resolveAndValidateSubType, resolveSubType

Methods inherited from class java.lang.Object

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

Methods inherited from interface tools.jackson.core.ObjectReadContext

createParser, createParser, createParser, createParser, createParser, treeAsTokens

Field Details

_objectIds

protected transient LinkedHashMap<ObjectIdGenerator.IdKey,ReadableObjectId> _objectIds

Constructor Details

DeserializationContextExt

protected DeserializationContextExt(TokenStreamFactory tsf,
 DeserializerFactory deserializerFactory,
 DeserializerCache cache,
 DeserializationConfig config,
 FormatSchema schema,
 InjectableValues values)

Constructor that will pass specified deserializer factory and cache: cache may be null (in which case default implementation will be used), factory cannot be null

Method Details

assignParser

public DeserializationContextExt assignParser(JsonParser p)

assignAndReturnParser

public JsonParser assignAndReturnParser(JsonParser p)

findObjectId

public ReadableObjectId findObjectId(Object id,
 ObjectIdGenerator<?> gen,
 ObjectIdResolver resolverType)

Description copied from class: DeserializationContext

Method called to find and return entry corresponding to given Object Id: will add an entry if necessary, and never returns null

Specified by:

findObjectId in class DeserializationContext

createReadableObjectId

protected ReadableObjectId createReadableObjectId(ObjectIdGenerator.IdKey key)

Overridable factory method to create a new instance of ReadableObjectId or its subclass. It is meant to be overridden when custom ReadableObjectId is needed for tryToResolveUnresolvedObjectId(tools.jackson.databind.deser.ReadableObjectId). Default implementation simply constructs default ReadableObjectId with given key.

Parameters:

key - The key to associate with the new ReadableObjectId

Returns:

New ReadableObjectId instance

updateObjectId

public void updateObjectId(Object delegate,
 Object newItem)
                    throws JacksonException

Description copied from class: DeserializationContext

Method called to update Object Id binding from an intermediate delegate object to the final bean produced by a delegating @JsonCreator. This is needed because when using @JsonIdentityInfo with delegating creators, the Object Id gets initially bound to the delegate (intermediate) object, but needs to point to the final converted bean.

Implemented by DeserializationContextExt.

Specified by:

updateObjectId in class DeserializationContext

Parameters:

delegate - The intermediate delegate object that was originally bound

newItem - The final bean produced by the delegating creator

Throws:

JacksonException

addPendingForwardRef

public void addPendingForwardRef(Object container)

Description copied from class: DeserializationContext

Method to register that a forward Object Id reference has been recorded against the given container object (typically a builder). Called by ObjectIdReferenceProperty when an unresolved forward reference is caught. Enables O(1) checking via DeserializationContext.hasPendingForwardRefsFor(java.lang.Object).

Implemented by DeserializationContextExt.

Specified by:

addPendingForwardRef in class DeserializationContext

Parameters:

container - The container/builder object the forward ref was registered against

removePendingForwardRef

public void removePendingForwardRef(Object container)

Description copied from class: DeserializationContext

Method to remove a container object from the pending forward reference tracking set, called when the forward reference has been resolved.

Implemented by DeserializationContextExt.

Specified by:

removePendingForwardRef in class DeserializationContext

Parameters:

container - The container/builder object to remove

hasPendingForwardRefsFor

public boolean hasPendingForwardRefsFor(Object builder)

Description copied from class: DeserializationContext

Method for checking whether the given container object has any pending unresolved forward Object Id references registered against it. Used by Builder-based deserialization to detect forward references that would be lost after building (since they point to the builder, not the built object).

Implemented by DeserializationContextExt.

Specified by:

hasPendingForwardRefsFor in class DeserializationContext

Parameters:

builder - The builder/container object to check

Returns:

true if there are pending forward references against this object

checkUnresolvedObjectId

public void checkUnresolvedObjectId()
                             throws UnresolvedForwardReference

Description copied from class: DeserializationContext

Method called to ensure that every object id encounter during processing are resolved.

Specified by:

checkUnresolvedObjectId in class DeserializationContext

Throws:

UnresolvedForwardReference

tryToResolveUnresolvedObjectId

protected boolean tryToResolveUnresolvedObjectId(ReadableObjectId roid)

Overridable helper method called to try to resolve otherwise unresolvable ReadableObjectId; and if this succeeds, return true to indicate problem has been resolved in some way, so that caller can avoid reporting it as an error.

Default implementation simply calls ReadableObjectId.tryToResolveUnresolved(tools.jackson.databind.DeserializationContext) and returns whatever it returns.

deserializerInstance

public ValueDeserializer<Object> deserializerInstance(Annotated ann,
 Object deserDef)

Specified by:

deserializerInstance in class DeserializationContext

keyDeserializerInstance

public final KeyDeserializer keyDeserializerInstance(Annotated ann,
 Object deserDef)

Specified by:

keyDeserializerInstance in class DeserializationContext

readRootValue

public Object readRootValue(JsonParser p,
 JavaType valueType,
 ValueDeserializer<Object> deser,
 Object valueToUpdate)
                     throws JacksonException

Throws:

JacksonException

_unwrapAndDeserialize

protected Object _unwrapAndDeserialize(JsonParser p,
 JavaType rootType,
 ValueDeserializer<Object> deser,
 Object valueToUpdate)
                                throws JacksonException

Throws:

JacksonException