Module tools.jackson.databind

Package tools.jackson.databind.ext.jdk8

Class Jdk8OptionalDeserializer

java.lang.Object

tools.jackson.databind.ValueDeserializer<T>

tools.jackson.databind.deser.std.StdDeserializer<T>

tools.jackson.databind.deser.std.ReferenceTypeDeserializer<Optional<?>>

tools.jackson.databind.ext.jdk8.Jdk8OptionalDeserializer

All Implemented Interfaces:

NullValueProvider, ValueInstantiator.Gettable

public class Jdk8OptionalDeserializer
extends ReferenceTypeDeserializer<Optional<?>>

Nested Class Summary

Nested classes/interfaces inherited from class tools.jackson.databind.ValueDeserializer

ValueDeserializer.None

Field Summary

Fields inherited from class tools.jackson.databind.deser.std.ReferenceTypeDeserializer

_fullType, _valueDeserializer, _valueInstantiator, _valueTypeDeserializer

Fields inherited from class tools.jackson.databind.deser.std.StdDeserializer

_valueClass, _valueType, F_MASK_INT_COERCIONS

Constructor Summary

Constructors

Constructor	Description
Jdk8OptionalDeserializer(JavaType fullType, ValueInstantiator inst, TypeDeserializer typeDeser, ValueDeserializer<?> deser)

Method Summary

Modifier and Type	Method	Description
Object	getAbsentValue(DeserializationContext ctxt)	Let's actually NOT coerce missing Creator parameters into empty value.
Object	getEmptyValue(DeserializationContext ctxt)	Method called to determine value to be used for "empty" values (most commonly when deserializing from empty JSON Strings).
Optional<?>	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).
Object	getReferenced(Optional<?> reference)	Method that may be called to find contents of specified reference, if any; or `null` if none.
Optional<?>	referenceValue(Object contents)
Optional<?>	updateReference(Optional<?> reference, Object contents)	Method called in case of "merging update", in which we should try update reference instead of creating a new one.
Jdk8OptionalDeserializer	withResolved(TypeDeserializer typeDeser, ValueDeserializer<?> valueDeser)	Mutant factory method called when changes are needed; should construct newly configured instance with new values as indicated.

Methods inherited from class tools.jackson.databind.deser.std.ReferenceTypeDeserializer

createContextual, deserialize, deserialize, deserializeWithType, getEmptyAccessPattern, getNullAccessPattern, getValueInstantiator, getValueType, logicalType, supportsUpdate

Methods inherited from class 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, handledType, handleMissingEndArrayForSingle, handleNestedArrayForSingle, handleUnknownProperty, isDefaultDeserializer, isDefaultKeyDeserializer

Methods inherited from class tools.jackson.databind.ValueDeserializer

deserializeWithType, findBackReference, getDelegatee, getKnownPropertyNames, getObjectIdReader, isCachable, replaceDelegatee, resolve, unwrappingDeserializer

Methods inherited from class java.lang.Object

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

Constructor Details

Jdk8OptionalDeserializer

public Jdk8OptionalDeserializer(JavaType fullType,
 ValueInstantiator inst,
 TypeDeserializer typeDeser,
 ValueDeserializer<?> deser)

Method Details

withResolved

public Jdk8OptionalDeserializer withResolved(TypeDeserializer typeDeser,
 ValueDeserializer<?> 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.

Specified by:

withResolved in class ReferenceTypeDeserializer<Optional<?>>

getNullValue

public Optional<?> getNullValue(DeserializationContext ctxt)

Description copied from class: ValueDeserializer

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.

This method may be called once, or multiple times, depending on what ValueDeserializer.getNullAccessPattern() returns.

Default implementation simply returns null.

Specified by:

getNullValue in interface NullValueProvider

Specified by:

getNullValue in class ReferenceTypeDeserializer<Optional<?>>

getEmptyValue

public Object getEmptyValue(DeserializationContext ctxt)

Description copied from class: ValueDeserializer

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

This method may be called once, or multiple times, depending on what ValueDeserializer.getEmptyAccessPattern() returns.

Default implementation simply calls ValueDeserializer.getNullValue(tools.jackson.databind.DeserializationContext) and returns value.

Overrides:

getEmptyValue in class ReferenceTypeDeserializer<Optional<?>>

getAbsentValue

public Object getAbsentValue(DeserializationContext ctxt)

Let's actually NOT coerce missing Creator parameters into empty value.

Specified by:

getAbsentValue in interface NullValueProvider

Overrides:

getAbsentValue in class ValueDeserializer<Optional<?>>

referenceValue

public Optional<?> referenceValue(Object contents)

Specified by:

referenceValue in class ReferenceTypeDeserializer<Optional<?>>

getReferenced

public Object getReferenced(Optional<?> 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<Optional<?>>

updateReference

public Optional<?> updateReference(Optional<?> reference,
 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<Optional<?>>