Jackson 3.0.1 · tools.jackson.databind.deser.bean.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 ValueDeserializer<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 ValueDeserializer<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 ConcurrentHashMap<ClassKey, ValueDeserializer<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.
protected static final PropertyName	TEMP_PROPERTY_NAME

Inherited from tools.jackson.databind.deser.std.StdDeserializer:: _valueClass _valueType F_MASK_INT_COERCIONS

Access	Constructor and Description
protected	BeanDeserializerBase(BeanDeserializerBuilder builder, BeanDescription.Supplier beanDescRef, 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, UnwrappedPropertyHandler unwrapHandler, PropertyBasedCreator propertyBasedCreator, BeanPropertyMap renamedProperties, boolean ignoreAllUnknown) Constructor used in cases where unwrapping-with-name-change has been invoked and lookup indices need to be updated.
protected	BeanDeserializerBase(BeanDeserializerBase src, ObjectIdReader oir)
public	BeanDeserializerBase(BeanDeserializerBase src, Set<String> ignorableProps, Set<String> includableProps)
protected	BeanDeserializerBase(BeanDeserializerBase src, BeanPropertyMap beanProps)

Method Summary

Modifier and Type	Method and Description
protected Object	_convertObjectId(JsonParser p, DeserializationContext ctxt, Object rawId, ValueDeserializer<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 ValueDeserializer<Object>	_delegateDeserializer()
protected final ValueDeserializer<Object>	_delegateDeserializer(JsonParser p) Alternate to `_delegateDeserializer()` which will only consider `_arrayDelegateDeserializer` if given `JsonParser` points to `JsonToken#START_ARRAY` token.
protected abstract Object	_deserializeUsingPropertyBased(final JsonParser p, final DeserializationContext ctxt)
protected ValueDeserializer<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).
private ValueDeserializer<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 ValueDeserializer<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 PropertyMetadata	_getSetterInfo(DeserializationContext ctxt, AnnotatedMember accessor, JavaType type) Method essentially copied from `BasicDeserializerFactory`, needed to find `PropertyMetadata` for Delegating Creator, for access to annotation-derived info.
protected BeanDeserializerBase	_handleByNameInclusion(DeserializationContext ctxt, AnnotationIntrospector intr, BeanDeserializerBase contextual, AnnotatedMember accessor)
protected Object	_handleTypedObjectId(JsonParser p, DeserializationContext ctxt, Object pojo, Object rawId) Off-lined 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 ValueDeserializer<?>	createContextual(DeserializationContext ctxt, BeanProperty property) Overrides tools.jackson.databind.ValueDeserializer.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	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 typeDeserializer) Overrides tools.jackson.databind.deser.std.StdDeserializer.deserializeWithType. Base implementation that does not assume specific type inclusion mechanism.
public SettableBeanProperty	findBackReference(String logicalName) Overrides tools.jackson.databind.ValueDeserializer.findBackReference. Method needed by `BeanDeserializerFactory` to properly link managed- and back-reference pairs.
public SettableBeanProperty	findProperty(PropertyName propertyName)
protected 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 AccessPattern	getEmptyAccessPattern() Overrides tools.jackson.databind.ValueDeserializer.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 tools.jackson.databind.ValueDeserializer.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 tools.jackson.databind.ValueDeserializer.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 tools.jackson.databind.ValueDeserializer.getNullAccessPattern. Implements tools.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(DeserializationContext ctxt) Overrides tools.jackson.databind.ValueDeserializer.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 tools.jackson.databind.deser.std.StdDeserializer.getValueInstantiator. Implements tools.jackson.databind.deser.ValueInstantiator.Gettable.getValueInstantiator.
public JavaType	getValueType() Overrides tools.jackson.databind.deser.std.StdDeserializer.getValueType. Exact structured type this deserializer handles, if known.
public Class<?>	handledType() Overrides tools.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) 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 p, DeserializationContext ctxt, Object beanOrClass, String propName) Overrides tools.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 abstract void	initNameMatcher(DeserializationContext ctxt)
protected void	injectValues(DeserializationContext ctxt, Object bean)
public boolean	isCachable() Overrides tools.jackson.databind.ValueDeserializer.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 tools.jackson.databind.ValueDeserializer.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	resolve(DeserializationContext ctxt) Overrides tools.jackson.databind.ValueDeserializer.resolve. Method called to finalize setup of this deserializer, after deserializer itself has been registered.
public Boolean	supportsUpdate(DeserializationConfig config) Overrides tools.jackson.databind.ValueDeserializer.supportsUpdate. Introspection method that may be called to see whether deserializer supports update of an existing value (aka "merging") or not.
private Throwable	throwOrReturnThrowable(DeserializationContext ctxt, Throwable t)
public abstract ValueDeserializer<Object>	unwrappingDeserializer(DeserializationContext ctxt, NameTransformer unwrapper) Overrides tools.jackson.databind.ValueDeserializer.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 abstract BeanDeserializerBase	withIgnoreAllUnknown(boolean ignoreUnknown)
public abstract BeanDeserializerBase	withObjectIdReader(ObjectIdReader oir)
public DatabindException	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 `DatabindException`, or an unchecked exception.
protected Object	wrapInstantiationProblem(DeserializationContext ctxt, Throwable t)

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

public abstract Class BeanDeserializerBase

Field Summary

Constructor Summary

Method Summary