com.fasterxml.jackson.databind.deser.std

Class AtomicReferenceDeserializer

java.lang.Object

com.fasterxml.jackson.databind.JsonDeserializer<T>

com.fasterxml.jackson.databind.deser.std.StdDeserializer<T>

com.fasterxml.jackson.databind.deser.std.ReferenceTypeDeserializer<java.util.concurrent.atomic.AtomicReference<java.lang.Object>>

com.fasterxml.jackson.databind.deser.std.AtomicReferenceDeserializer

All Implemented Interfaces:

ContextualDeserializer, NullValueProvider, java.io.Serializable

public class AtomicReferenceDeserializer
extends ReferenceTypeDeserializer<java.util.concurrent.atomic.AtomicReference<java.lang.Object>>

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.fasterxml.jackson.databind.JsonDeserializer

JsonDeserializer.None

Constructor Summary

Constructors

Constructor and Description
AtomicReferenceDeserializer(JavaType fullType, ValueInstantiator inst, TypeDeserializer typeDeser, JsonDeserializer<?> deser)

Method Summary

Modifier and Type	Method and Description
java.lang.Object	getEmptyValue(DeserializationContext ctxt) Method called to determine value to be used for "empty" values (most commonly when deserializing from empty JSON Strings).
java.util.concurrent.atomic.AtomicReference<java.lang.Object>	getNullValue(DeserializationContext ctxt) Method that can be called to determine value to be used for representing null values (values deserialized when JSON token is JsonToken.VALUE_NULL).
java.lang.Object	getReferenced(java.util.concurrent.atomic.AtomicReference<java.lang.Object> reference) Method that may be called to find contents of specified reference, if any; or `null` if none.
java.util.concurrent.atomic.AtomicReference<java.lang.Object>	referenceValue(java.lang.Object contents)
java.lang.Boolean	supportsUpdate(DeserializationConfig config) By default we assume that updateability mostly relies on value deserializer; if it supports updates, typically that's what matters.
java.util.concurrent.atomic.AtomicReference<java.lang.Object>	updateReference(java.util.concurrent.atomic.AtomicReference<java.lang.Object> reference, java.lang.Object contents) Method called in case of "merging update", in which we should try update reference instead of creating a new one.
AtomicReferenceDeserializer	withResolved(TypeDeserializer typeDeser, JsonDeserializer<?> valueDeser) Mutant factory method called when changes are needed; should construct newly configured instance with new values as indicated.

Methods inherited from class com.fasterxml.jackson.databind.deser.std.ReferenceTypeDeserializer

createContextual, deserialize, deserialize, deserializeWithType, getEmptyAccessPattern, getNullAccessPattern, getValueType

Methods inherited from class com.fasterxml.jackson.databind.deser.std.StdDeserializer

getValueClass, handledType

Methods inherited from class com.fasterxml.jackson.databind.JsonDeserializer

findBackReference, getDelegatee, getEmptyValue, getKnownPropertyNames, getNullValue, getObjectIdReader, isCachable, replaceDelegatee, unwrappingDeserializer

Methods inherited from class java.lang.Object

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

Constructor Detail

AtomicReferenceDeserializer

public AtomicReferenceDeserializer(JavaType fullType,
                                   ValueInstantiator inst,
                                   TypeDeserializer typeDeser,
                                   JsonDeserializer<?> deser)

Since:

2.9

Method Detail

withResolved

public AtomicReferenceDeserializer withResolved(TypeDeserializer typeDeser,
                                                JsonDeserializer<?> valueDeser)

Description copied from class: ReferenceTypeDeserializer

Mutant factory method called when changes are needed; should construct newly configured instance with new values as indicated.

NOTE: caller has verified that there are changes, so implementations need NOT check if a new instance is needed.

getNullValue

public java.util.concurrent.atomic.AtomicReference<java.lang.Object> getNullValue(DeserializationContext ctxt)

Description copied from class: JsonDeserializer

Method that can be called to determine value to be used for representing null values (values deserialized when JSON token is JsonToken.VALUE_NULL). Usually this is simply Java null, but for some types (especially primitives) it may be necessary to use non-null values.

Since version 2.6 (in which the context argument was added), call is expected to be made each and every time a null token needs to be handled.

Default implementation simply returns null.

Specified by:

getNullValue in interface NullValueProvider

Specified by:

getNullValue in class ReferenceTypeDeserializer<java.util.concurrent.atomic.AtomicReference<java.lang.Object>>

getEmptyValue

public java.lang.Object getEmptyValue(DeserializationContext ctxt)

Description copied from class: JsonDeserializer

Method called to determine value to be used for "empty" values (most commonly when deserializing from empty JSON Strings). Usually this is same as JsonDeserializer.getNullValue(com.fasterxml.jackson.databind.DeserializationContext) (which in turn is usually simply Java null), but it can be overridden for types. Or, if type should never be converted from empty String, method can also throw an exception.

Since version 2.6 (in which the context argument was added), call is expected to be made each and every time an empty value is needed.

Since version 2.9 does not require return of `T` any more.

Default implementation simply calls JsonDeserializer.getNullValue(com.fasterxml.jackson.databind.DeserializationContext) and returns value.

Overrides:

getEmptyValue in class ReferenceTypeDeserializer<java.util.concurrent.atomic.AtomicReference<java.lang.Object>>

referenceValue

public java.util.concurrent.atomic.AtomicReference<java.lang.Object> referenceValue(java.lang.Object contents)

Specified by:

referenceValue in class ReferenceTypeDeserializer<java.util.concurrent.atomic.AtomicReference<java.lang.Object>>

getReferenced

public java.lang.Object getReferenced(java.util.concurrent.atomic.AtomicReference<java.lang.Object> reference)

Description copied from class: ReferenceTypeDeserializer

Method that may be called to find contents of specified reference, if any; or `null` if none. Note that method should never fail, so for types that use concept of "absence" vs "presence", `null` is to be returned for both "absent" and "reference to `null`" cases.

Specified by:

getReferenced in class ReferenceTypeDeserializer<java.util.concurrent.atomic.AtomicReference<java.lang.Object>>

updateReference

public java.util.concurrent.atomic.AtomicReference<java.lang.Object> updateReference(java.util.concurrent.atomic.AtomicReference<java.lang.Object> reference,
                                                                                     java.lang.Object contents)

Description copied from class: ReferenceTypeDeserializer

Method called in case of "merging update", in which we should try update reference instead of creating a new one. If this does not succeed, should just create a new instance.

Specified by:

updateReference in class ReferenceTypeDeserializer<java.util.concurrent.atomic.AtomicReference<java.lang.Object>>

supportsUpdate

public java.lang.Boolean supportsUpdate(DeserializationConfig config)

Description copied from class: ReferenceTypeDeserializer

By default we assume that updateability mostly relies on value deserializer; if it supports updates, typically that's what matters. So let's just delegate.

Overrides:

supportsUpdate in class ReferenceTypeDeserializer<java.util.concurrent.atomic.AtomicReference<java.lang.Object>>