Module tools.jackson.databind

Package tools.jackson.databind.deser.impl

Class MergingSettableBeanProperty

java.lang.Object

tools.jackson.databind.introspect.ConcreteBeanPropertyBase

tools.jackson.databind.deser.SettableBeanProperty

tools.jackson.databind.deser.SettableBeanProperty.Delegating

tools.jackson.databind.deser.impl.MergingSettableBeanProperty

All Implemented Interfaces:

Named, BeanProperty, FullyNamed

public class MergingSettableBeanProperty
extends SettableBeanProperty.Delegating

SettableBeanProperty implementation that will try to access value of the property first, and if non-null value found, pass that for update (using ValueDeserializer.deserialize(tools.jackson.core.JsonParser, tools.jackson.databind.DeserializationContext, Object)) instead of constructing a new value. This is necessary to support "merging" properties.

Note that there are many similarities to SetterlessProperty, which predates this variant; and that one is even used in cases where there is no mutator available.

Nested Class Summary

Nested classes/interfaces inherited from class tools.jackson.databind.deser.SettableBeanProperty

SettableBeanProperty.Delegating

Nested classes/interfaces inherited from interface tools.jackson.databind.BeanProperty

BeanProperty.Bogus, BeanProperty.Std

Nested classes/interfaces inherited from interface tools.jackson.core.util.Named

Named.StringAsNamed

Field Summary

Fields

Modifier and Type	Field	Description
protected final AnnotatedMember	_accessor	Member (field, method) used for accessing existing value.

Fields inherited from class tools.jackson.databind.deser.SettableBeanProperty.Delegating

delegate

Fields inherited from class tools.jackson.databind.deser.SettableBeanProperty

_contextAnnotations, _managedReferenceName, _nullProvider, _objectIdInfo, _propertyIndex, _propName, _type, _valueDeserializer, _valueTypeDeserializer, _viewMatcher, _wrapperName, MISSING_VALUE_DESERIALIZER

Fields inherited from class tools.jackson.databind.introspect.ConcreteBeanPropertyBase

_aliases, _metadata

Fields inherited from interface tools.jackson.databind.BeanProperty

EMPTY_FORMAT, EMPTY_INCLUDE

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	MergingSettableBeanProperty(MergingSettableBeanProperty src, SettableBeanProperty delegate)
protected	MergingSettableBeanProperty(SettableBeanProperty delegate, AnnotatedMember accessor)

Method Summary

Modifier and Type	Method	Description
static MergingSettableBeanProperty	construct(SettableBeanProperty delegate, AnnotatedMember accessor)
void	deserializeAndSet(JsonParser p, DeserializationContext ctxt, Object instance)	Method called to deserialize appropriate value, given parser (and context), and set it using appropriate mechanism.
Object	deserializeSetAndReturn(JsonParser p, DeserializationContext ctxt, Object instance)	Alternative to SettableBeanProperty.deserializeAndSet(tools.jackson.core.JsonParser, tools.jackson.databind.DeserializationContext, java.lang.Object) that returns either return value of setter method called (if one is), or null to indicate that no return value is available.
boolean	isMerging()	Whether this property requires merging of values (read-then-write)
void	set(DeserializationContext ctxt, Object instance, Object value)	Method called to assign given value to this property, on specified Object.
Object	setAndReturn(DeserializationContext ctxt, Object instance, Object value)	Method called to assign given value to this property, on specified Object, and return whatever delegating accessor returned (if anything)
protected SettableBeanProperty	withDelegate(SettableBeanProperty d)	Method sub-classes must implement, to construct a new instance with given delegate.

Methods inherited from class tools.jackson.databind.deser.SettableBeanProperty.Delegating

_with, assignIndex, fixAccess, getAnnotation, getCreatorIndex, getDeclaringClass, getDelegate, getInjectableValueId, getManagedReferenceName, getMember, getObjectIdInfo, getPropertyIndex, getValueDeserializer, getValueTypeDeserializer, hasValueDeserializer, hasValueTypeDeserializer, hasViews, isInjectionOnly, visibleInView, withName, withNullProvider, withValueDeserializer

Methods inherited from class tools.jackson.databind.deser.SettableBeanProperty

_throwAsJacksonE, _throwAsJacksonE, depositSchemaProperty, deserialize, deserializeWith, getContextAnnotation, getFullName, getInjectionDefinition, getName, getNullValueProvider, getType, getWrapperName, isIgnorable, markAsIgnorable, setManagedReferenceName, setObjectIdInfo, setViews, toString, unwrapped, withSimpleName

Methods inherited from class tools.jackson.databind.introspect.ConcreteBeanPropertyBase

findAliases, findFormatOverrides, findPropertyFormat, findPropertyInclusion, getMetadata, isRequired, isVirtual

Methods inherited from class java.lang.Object

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

Methods inherited from interface tools.jackson.databind.util.FullyNamed

hasName

Field Details

_accessor

protected final AnnotatedMember _accessor

Member (field, method) used for accessing existing value.

Constructor Details

MergingSettableBeanProperty

protected MergingSettableBeanProperty(SettableBeanProperty delegate,
 AnnotatedMember accessor)

MergingSettableBeanProperty

protected MergingSettableBeanProperty(MergingSettableBeanProperty src,
 SettableBeanProperty delegate)

Method Details

construct

public static MergingSettableBeanProperty construct(SettableBeanProperty delegate,
 AnnotatedMember accessor)

withDelegate

protected SettableBeanProperty withDelegate(SettableBeanProperty d)

Description copied from class: SettableBeanProperty.Delegating

Method sub-classes must implement, to construct a new instance with given delegate.

Specified by:

withDelegate in class SettableBeanProperty.Delegating

isMerging

public boolean isMerging()

Description copied from class: SettableBeanProperty

Whether this property requires merging of values (read-then-write)

Overrides:

isMerging in class SettableBeanProperty

deserializeAndSet

public void deserializeAndSet(JsonParser p,
 DeserializationContext ctxt,
 Object instance)
                       throws JacksonException

Description copied from class: SettableBeanProperty

Method called to deserialize appropriate value, given parser (and context), and set it using appropriate mechanism. Pre-condition is that passed parser must point to the first token that should be consumed to produce the value (the only value for scalars, multiple for Objects and Arrays).

Overrides:

deserializeAndSet in class SettableBeanProperty.Delegating

Throws:

JacksonException

deserializeSetAndReturn

public Object deserializeSetAndReturn(JsonParser p,
 DeserializationContext ctxt,
 Object instance)
                               throws JacksonException

Description copied from class: SettableBeanProperty

Alternative to SettableBeanProperty.deserializeAndSet(tools.jackson.core.JsonParser, tools.jackson.databind.DeserializationContext, java.lang.Object) that returns either return value of setter method called (if one is), or null to indicate that no return value is available. Mostly used to support Builder style deserialization.

Overrides:

deserializeSetAndReturn in class SettableBeanProperty.Delegating

Throws:

JacksonException

set

public void set(DeserializationContext ctxt,
 Object instance,
 Object value)

Description copied from class: SettableBeanProperty

Method called to assign given value to this property, on specified Object.

Note: this is an optional operation, not supported by all implementations, creator-backed properties for example do not support this method.

Overrides:

set in class SettableBeanProperty.Delegating

setAndReturn

public Object setAndReturn(DeserializationContext ctxt,
 Object instance,
 Object value)

Description copied from class: SettableBeanProperty

Method called to assign given value to this property, on specified Object, and return whatever delegating accessor returned (if anything)

Note: this is an optional operation, not supported by all implementations, creator-backed properties for example do not support this method.

Overrides:

setAndReturn in class SettableBeanProperty.Delegating