jackson-databind 2.16.0 · com.fasterxml.jackson.databind.deser.BeanDeserializerBase

Field Summary

Modifier and Type	Field and Description
protected SettableAnyProperty	_anySetter Fallback setter used for handling any properties that are not mapped to regular setters.
protected JsonDeserializer<Object>	_arrayDelegateDeserializer Deserializer that is used iff array-delegate-based creator is to be used for deserializing from JSON Object.
protected final Map<String, SettableBeanProperty>	_backRefs We may also have one or more back reference fields (usually zero or one).
protected final BeanPropertyMap	_beanProperties Mapping of property names to properties, built when all properties to use have been successfully resolved.
protected final JavaType	_beanType Declared type of the bean this deserializer handles.
protected JsonDeserializer<Object>	_delegateDeserializer Deserializer that is used iff delegate-based creator is to be used for deserializing from JSON Object.
protected ExternalTypeHandler	_externalTypeIdHandler Handler that we need if any of properties uses external type id.
protected final Set<String>	_ignorableProps In addition to properties that are set, we will also keep track of recognized but ignorable properties: these will be skipped without errors or warnings.
protected final boolean	_ignoreAllUnknown Flag that can be set to ignore and skip unknown properties.
protected final Set<String>	_includableProps Keep track of the the properties that needs to be specifically included.
protected final ValueInjector[]	_injectables List of `ValueInjector`s, if any injectable values are expected by the bean; otherwise null.
protected final boolean	_needViewProcesing Flag that indicates that some aspect of deserialization depends on active view used (if any)
protected boolean	_nonStandardCreation Flag that is set to mark cases where deserialization from Object value using otherwise "standard" property binding will need to use non-default creation method: namely, either "full" delegation (array-delegation does not apply), or properties-based Creator method is used.
protected final ObjectIdReader	_objectIdReader If an Object Id is to be used for value handled by this deserializer, this reader is used for handling.
protected PropertyBasedCreator	_propertyBasedCreator If the bean needs to be instantiated using constructor or factory method that takes one or more named properties as argument(s), this creator is used for instantiation.
protected final JsonFormat.Shape	_serializationShape Requested shape from bean class annotations.
protected transient HashMap<ClassKey, JsonDeserializer<Object>>	_subDeserializers Lazily constructed map used to contain deserializers needed for polymorphic subtypes.
protected UnwrappedPropertyHandler	_unwrappedPropertyHandler If one of properties has "unwrapped" value, we need separate helper object
protected final ValueInstantiator	_valueInstantiator Object that handles details of constructing initial bean value (to which bind data to), unless instance is passed (via updateValue())
protected boolean	_vanillaProcessing Flag that indicates that no "special features" whatsoever are enabled, so the simplest processing is possible.
private static final long	serialVersionUID Hides com.fasterxml.jackson.databind.deser.std.StdDeserializer.serialVersionUID.
protected static final PropertyName	TEMP_PROPERTY_NAME

Inherited from com.fasterxml.jackson.databind.deser.std.StdDeserializer:: _valueClass _valueType F_MASK_ACCEPT_ARRAYS F_MASK_INT_COERCIONS

Access	Constructor and Description
protected	BeanDeserializerBase(BeanDeserializerBuilder builder, BeanDescription beanDesc, BeanPropertyMap properties, Map<String, SettableBeanProperty> backRefs, Set<String> ignorableProps, boolean ignoreAllUnknown, Set<String> includableProps, boolean hasViews) Constructor used when initially building a deserializer instance, given a `BeanDeserializerBuilder` that contains configuration.
protected	BeanDeserializerBase(BeanDeserializerBase src)
protected	BeanDeserializerBase(BeanDeserializerBase src, boolean ignoreAllUnknown)
protected	BeanDeserializerBase(BeanDeserializerBase src, NameTransformer unwrapper)
public	BeanDeserializerBase(BeanDeserializerBase src, ObjectIdReader oir)
public	BeanDeserializerBase(BeanDeserializerBase src, Set<String> ignorableProps, Set<String> includableProps)
protected	BeanDeserializerBase(BeanDeserializerBase src, BeanPropertyMap beanProps)
protected	BeanDeserializerBase(BeanDeserializerBase src, Set<String> ignorableProps) Deprecated

Method Summary

Modifier and Type	Method and Description
protected Object	_convertObjectId(JsonParser p, DeserializationContext ctxt, Object rawId, JsonDeserializer<Object> idDeser) Helper method we need to do necessary conversion from whatever native object id type is, into declared type that Jackson internals expect.
protected final JsonDeserializer<Object>	_delegateDeserializer()
protected abstract Object	_deserializeUsingPropertyBased(final JsonParser p, final DeserializationContext ctxt)
private JsonDeserializer<Object>	_findDelegateDeserializer(DeserializationContext ctxt, JavaType delegateType, AnnotatedWithParams delegateCreator)
protected NameTransformer	_findPropertyUnwrapper(DeserializationContext ctxt, SettableBeanProperty prop) Helper method called to see if given property might be so-called unwrapped property: these require special handling.
protected JsonDeserializer<Object>	_findSubclassDeserializer(DeserializationContext ctxt, Object bean, TokenBuffer unknownTokens) Helper method called to (try to) locate deserializer for given sub-type of type that this deserializer handles.
protected BeanDeserializerBase	_handleByNameInclusion(DeserializationContext ctxt, AnnotationIntrospector intr, BeanDeserializerBase contextual, AnnotatedMember accessor)
protected Object	_handleTypedObjectId(JsonParser p, DeserializationContext ctxt, Object pojo, Object rawId) Offlined method called to handle "native" Object Id that has been read and known to be associated with given deserialized POJO.
protected void	_replaceProperty(BeanPropertyMap props, SettableBeanProperty[] creatorProps, SettableBeanProperty origProp, SettableBeanProperty newProp)
protected SettableBeanProperty	_resolvedObjectIdProperty(DeserializationContext ctxt, SettableBeanProperty prop) Method that wraps given property with `ObjectIdReferenceProperty` in case where object id resolution is required.
protected SettableBeanProperty	_resolveInnerClassValuedProperty(DeserializationContext ctxt, SettableBeanProperty prop) Helper method that will handle gruesome details of dealing with properties that have non-static inner class as value...
protected SettableBeanProperty	_resolveManagedReferenceProperty(DeserializationContext ctxt, SettableBeanProperty prop) Helper method called to see if given property is part of 'managed' property pair (managed + back reference), and if so, handle resolution details.
protected SettableBeanProperty	_resolveMergeAndNullSettings(DeserializationContext ctxt, SettableBeanProperty prop, PropertyMetadata propMetadata)
protected abstract BeanDeserializerBase	asArrayDeserializer() Fluent factory for creating a variant that can handle POJO output as a JSON Array.
public JsonDeserializer<?>	createContextual(DeserializationContext Deserialization context to access configuration, additional deserializers that may be needed by this deserializer ctxt, BeanProperty Method, field or constructor parameter that represents the property (and is used to assign deserialized value). Should be available; but there may be cases where caller cannot provide it and null is passed instead (in which case impls usually pass 'this' deserializer as is) property) Implements com.fasterxml.jackson.databind.deser.ContextualDeserializer.createContextual. Although most of post-processing is done in resolve(), we only get access to referring property's annotations here; and this is needed to support per-property ObjectIds.
public Iterator<SettableBeanProperty>	creatorProperties() Accessor for finding properties that represents values to pass through property-based creator method (constructor or factory method)
public Object	deserializeFromArray(JsonParser p, DeserializationContext ctxt) Deprecated Since 2.11 Should not be used: was never meant to be called by code other than sub-classes (implementations), and implementations details differ
public Object	deserializeFromBoolean(JsonParser p, DeserializationContext ctxt) Method called to deserialize POJO value from a JSON boolean value (true, false)
public Object	deserializeFromDouble(JsonParser p, DeserializationContext ctxt) Method called to deserialize POJO value from a JSON floating-point number.
public Object	deserializeFromEmbedded(JsonParser p, DeserializationContext ctxt)
public Object	deserializeFromNumber(JsonParser p, DeserializationContext ctxt)
public abstract Object	deserializeFromObject(JsonParser p, DeserializationContext ctxt) General version used when handling needs more advanced features.
protected Object	deserializeFromObjectId(JsonParser p, DeserializationContext ctxt) Method called in cases where it looks like we got an Object Id to parse and use as a reference.
protected Object	deserializeFromObjectUsingNonDefault(JsonParser p, DeserializationContext ctxt)
public Object	deserializeFromString(JsonParser p, DeserializationContext ctxt)
protected Object	deserializeWithObjectId(JsonParser p, DeserializationContext ctxt) Alternative deserialization method used when we expect to see Object Id; if so, we will need to ensure that the Id is seen before anything else, to ensure that it is available for solving references, even if JSON itself is not ordered that way.
public Object	deserializeWithType(JsonParser p, DeserializationContext ctxt, TypeDeserializer Deserializer to use for handling type information typeDeserializer) Overrides com.fasterxml.jackson.databind.deser.std.StdDeserializer.deserializeWithType. Base implementation that does not assume specific type inclusion mechanism.
public SettableBeanProperty	findBackReference(String logicalName) Overrides com.fasterxml.jackson.databind.JsonDeserializer.findBackReference. Method needed by `BeanDeserializerFactory` to properly link managed- and back-reference pairs.
protected JsonDeserializer<Object>	findConvertingDeserializer(DeserializationContext ctxt, SettableBeanProperty prop) Helper method that can be used to see if specified property is annotated to indicate use of a converter for property value (in case of container types, it is container type itself, not key or content type).
public SettableBeanProperty	findProperty(PropertyName propertyName)
public SettableBeanProperty	findProperty(String propertyName) Accessor for finding the property with given name, if POJO has one.
public SettableBeanProperty	findProperty(int propertyIndex) Alternate find method that tries to locate a property with given `property index`.
public final Class<?>	getBeanClass() Deprecated Since 2.3, use `handledType()` instead
public AccessPattern	getEmptyAccessPattern() Overrides com.fasterxml.jackson.databind.JsonDeserializer.getEmptyAccessPattern. This method may be called in conjunction with calls to `getEmptyValue(DeserializationContext)`, to check whether it needs to be called just once (static values), or each time empty value is needed.
public Object	getEmptyValue(DeserializationContext ctxt) Overrides com.fasterxml.jackson.databind.JsonDeserializer.getEmptyValue. Method called to determine value to be used for "empty" values (most commonly when deserializing from empty JSON Strings).
public Collection<Object>	getKnownPropertyNames() Overrides com.fasterxml.jackson.databind.JsonDeserializer.getKnownPropertyNames. Method that will either return null to indicate that type being deserializers has no concept of properties; or a collection of identifiers for which `toString` will give external property name.
public AccessPattern	getNullAccessPattern() Overrides com.fasterxml.jackson.databind.JsonDeserializer.getNullAccessPattern. Implements com.fasterxml.jackson.databind.deser.NullValueProvider.getNullAccessPattern. This method may be called in conjunction with calls to `getNullValue(DeserializationContext)`, to check whether it needs to be called just once (static values), or each time empty value is needed.
public ObjectIdReader	getObjectIdReader() Overrides com.fasterxml.jackson.databind.JsonDeserializer.getObjectIdReader. Overridden to return true for those instances that are handling value for which Object Identity handling is enabled (either via value type or referring property).
public int	getPropertyCount() Accessor for checking number of deserialized properties.
public ValueInstantiator	getValueInstantiator() Overrides com.fasterxml.jackson.databind.deser.std.StdDeserializer.getValueInstantiator. Implements com.fasterxml.jackson.databind.deser.ValueInstantiator.Gettable.getValueInstantiator.
public JavaType	getValueType() Overrides com.fasterxml.jackson.databind.deser.std.StdDeserializer.getValueType. Exact structured type this deserializer handles, if known.
public Class<?>	handledType() Overrides com.fasterxml.jackson.databind.deser.std.StdDeserializer.handledType. Method for accessing concrete physical type of values this deserializer produces.
protected void	handleIgnoredProperty(JsonParser p, DeserializationContext ctxt, Object beanOrClass, String propName) Method called when an explicitly ignored property (one specified with a name to match, either by property annotation or class annotation) is encountered.
protected Object	handlePolymorphic(JsonParser (optional) If not null, parser that has more properties to handle (in addition to buffered properties); if null, all properties are passed in buffer p, DeserializationContext ctxt, Object bean, TokenBuffer unknownTokens) Deprecated use `handlePolymorphic(JsonParser, DeserializationContext, StreamReadConstraints, Object, TokenBuffer)` Method called in cases where we may have polymorphic deserialization case: that is, type of Creator-constructed bean is not the type of deserializer itself.
protected Object	handlePolymorphic(JsonParser (optional) If not null, parser that has more properties to handle (in addition to buffered properties); if null, all properties are passed in buffer p, DeserializationContext ctxt, StreamReadConstraints streamReadConstraints, Object bean, TokenBuffer unknownTokens) Method called in cases where we may have polymorphic deserialization case: that is, type of Creator-constructed bean is not the type of deserializer itself.
protected Object	handleUnknownProperties(DeserializationContext ctxt, Object bean, TokenBuffer unknownTokens) Method called to handle set of one or more unknown properties, stored in their entirety in given `TokenBuffer` (as field entries, name and value).
protected void	handleUnknownProperty(JsonParser Parser that points to value of the unknown property p, DeserializationContext Context for deserialization; allows access to the parser, error reporting functionality ctxt, Object Instance that is being populated by this deserializer, or if not known, Class that would be instantiated. If null, will assume type is what `getValueClass` returns. beanOrClass, String Name of the property that cannot be mapped propName) Overrides com.fasterxml.jackson.databind.deser.std.StdDeserializer.handleUnknownProperty. Method called when a JSON property is encountered that has not matching setter, any-setter or field, and thus cannot be assigned.
protected void	handleUnknownVanilla(JsonParser p, DeserializationContext ctxt, Object Either POJO instance (if constructed), or builder (in case of builder-based approach), that has property we haven't been able to handle yet. beanOrBuilder, String propName) Helper method called for an unknown property, when using "vanilla" processing.
public boolean	hasProperty(String propertyName)
public boolean	hasViews()
protected void	injectValues(DeserializationContext ctxt, Object bean)
public boolean	isCachable() Overrides com.fasterxml.jackson.databind.JsonDeserializer.isCachable. Method called to see if deserializer instance is cachable and usable for other properties of same type (type for which instance was created).
public boolean	Returns: True if this deserializer should match property names without considering casing; false if case has to match exactly. isCaseInsensitive() Accessor for checking whether this deserializer is operating in case-insensitive manner.
public LogicalType	logicalType() Overrides com.fasterxml.jackson.databind.JsonDeserializer.logicalType. Method for accessing logical type of values this deserializer produces.
public Iterator<SettableBeanProperty>	properties() Accessor for iterating over properties this deserializer uses; with the exception that properties passed via Creator methods (specifically, "property-based constructor") are not included, but can be accessed separate by calling `creatorProperties`
public void	replaceProperty(SettableBeanProperty Property to replace original, SettableBeanProperty Property to replace it with replacement) Method that can be used to replace an existing property with a modified one.
public void	resolve(DeserializationContext Context to use for accessing configuration, resolving secondary deserializers ctxt) Implements com.fasterxml.jackson.databind.deser.ResolvableDeserializer.resolve. Method called to finalize setup of this deserializer, after deserializer itself has been registered.
public Boolean	supportsUpdate(DeserializationConfig config) Overrides com.fasterxml.jackson.databind.JsonDeserializer.supportsUpdate. Introspection method that may be called to see whether deserializer supports update of an existing value (aka "merging") or not.
private Throwable	throwOrReturnThrowable(Throwable t, DeserializationContext ctxt)
public abstract JsonDeserializer<Object>	unwrappingDeserializer(NameTransformer unwrapper) Overrides com.fasterxml.jackson.databind.JsonDeserializer.unwrappingDeserializer. Method that will return deserializer instance that is able to handle "unwrapped" value instances If no unwrapped instance can be constructed, will simply return this object as-is.
public BeanDeserializerBase	withBeanProperties(BeanPropertyMap props) Mutant factory method that custom sub-classes must override; not left as abstract to prevent more drastic backwards compatibility problems.
public abstract BeanDeserializerBase	withByNameInclusion(Set<String> ignorableProps, Set<String> includableProps)
public BeanDeserializerBase	withIgnorableProperties(Set<String> ignorableProps) Deprecated Since 2.12 use `withByNameInclusion` instead
public abstract BeanDeserializerBase	withIgnoreAllUnknown(boolean ignoreUnknown)
public abstract BeanDeserializerBase	withObjectIdReader(ObjectIdReader oir)
public void	wrapAndThrow(Throwable t, Object bean, String fieldName, DeserializationContext ctxt) Method that will modify caught exception (passed in as argument) as necessary to include reference information, and to ensure it is a subtype of `IOException`, or an unchecked exception.
protected Object	wrapInstantiationProblem(Throwable t, DeserializationContext ctxt)

Inherited from com.fasterxml.jackson.databind.deser.std.StdDeserializer:: _byteOverflow _checkBooleanToStringCoercion _checkCoercionFail _checkDoubleSpecialValue _checkFloatSpecialValue _checkFloatToIntCoercion _checkFloatToStringCoercion _checkFromStringCoercion _checkFromStringCoercion _checkIntToFloatCoercion _checkIntToStringCoercion _checkTextualNull _checkToStringCoercion _coerceBooleanFromInt _coercedTypeDesc _coercedTypeDesc _coerceEmptyString _coerceIntegral _coerceNullToken _coerceTextualNull _deserializeFromArray _deserializeFromEmpty _deserializeFromEmptyString _deserializeFromString _deserializeWrappedValue _failDoubleToIntCoercion _findCoercionFromBlankString _findCoercionFromEmptyArray _findCoercionFromEmptyString _findNullProvider _hasTextualNull _intOverflow _isBlank _isEmptyOrTextualNull _isFalse _isIntNumber _isNaN _isNegInf _isPosInf _isTrue _neitherNull _nonNullNumber _parseBoolean _parseBooleanFromInt _parseBooleanPrimitive _parseBooleanPrimitive _parseBytePrimitive _parseDate _parseDate _parseDateFromArray _parseDouble _parseDouble _parseDoublePrimitive _parseDoublePrimitive _parseDoublePrimitive _parseFloatPrimitive _parseFloatPrimitive _parseFloatPrimitive _parseInteger _parseInteger _parseIntPrimitive _parseIntPrimitive _parseLong _parseLong _parseLongPrimitive _parseLongPrimitive _parseShortPrimitive _parseString _parseString _reportFailedNullCoerce _shortOverflow _verifyEndArrayForSingle _verifyNullForPrimitive _verifyNullForPrimitiveCoercion _verifyNullForScalarCoercion _verifyNumberForScalarCoercion _verifyStringForScalarCoercion findContentNullProvider findContentNullStyle findConvertingContentDeserializer findDeserializer findFormatFeature findFormatOverrides findValueNullProvider getValueClass getValueType handleMissingEndArrayForSingle handleNestedArrayForSingle isDefaultDeserializer isDefaultKeyDeserializer

public abstract Class BeanDeserializerBase

Field Summary

Constructor Summary

Method Summary