com.fasterxml.jackson.datatype.threetenbp.deser

Class InstantDeserializer<T extends org.threeten.bp.temporal.Temporal>

java.lang.Object

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

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

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

com.fasterxml.jackson.datatype.threetenbp.deser.ThreeTenDateTimeDeserializerBase<T>

com.fasterxml.jackson.datatype.threetenbp.deser.InstantDeserializer<T>

All Implemented Interfaces:

com.fasterxml.jackson.databind.deser.ContextualDeserializer, com.fasterxml.jackson.databind.deser.NullValueProvider, Serializable

public class InstantDeserializer<T extends org.threeten.bp.temporal.Temporal>
extends ThreeTenDateTimeDeserializerBase<T>

Deserializer for ThreeTen temporal Instants, OffsetDateTime, and ZonedDateTimes.

Since:

2.2

Author:

Nick Williams

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	InstantDeserializer.FromDecimalArguments
static class	InstantDeserializer.FromIntegerArguments

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

com.fasterxml.jackson.databind.JsonDeserializer.None

Field Summary

Fields

Modifier and Type	Field and Description
protected Boolean	_adjustToContextTZOverride Flag for JsonFormat.Feature.ADJUST_DATES_TO_CONTEXT_TIME_ZONE
protected BiFunction<T,org.threeten.bp.ZoneId,T>	adjust
protected Function<InstantDeserializer.FromIntegerArguments,T>	fromMilliseconds
protected Function<InstantDeserializer.FromDecimalArguments,T>	fromNanoseconds
static InstantDeserializer<org.threeten.bp.Instant>	INSTANT
static InstantDeserializer<org.threeten.bp.OffsetDateTime>	OFFSET_DATE_TIME
protected Function<org.threeten.bp.temporal.TemporalAccessor,T>	parsedToValue
protected boolean	replaceZeroOffsetAsZ In case of vanilla `Instant` we seem to need to translate "+0000 | +00:00 | +00" timezone designator into plain "Z" for some reason; see [jackson-modules-java8#18] for more info
static InstantDeserializer<org.threeten.bp.ZonedDateTime>	ZONED_DATE_TIME

Fields inherited from class com.fasterxml.jackson.datatype.threetenbp.deser.ThreeTenDateTimeDeserializerBase

_formatter, _isLenient

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

_valueClass, _valueType, F_MASK_ACCEPT_ARRAYS, F_MASK_INT_COERCIONS

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	InstantDeserializer(Class<T> supportedType, org.threeten.bp.format.DateTimeFormatter formatter, Function<org.threeten.bp.temporal.TemporalAccessor,T> parsedToValue, Function<InstantDeserializer.FromIntegerArguments,T> fromMilliseconds, Function<InstantDeserializer.FromDecimalArguments,T> fromNanoseconds, BiFunction<T,org.threeten.bp.ZoneId,T> adjust, boolean replaceZeroOffsetAsZ)
protected	InstantDeserializer(InstantDeserializer<T> base, Boolean adjustToContextTimezoneOverride)
protected	InstantDeserializer(InstantDeserializer<T> base, org.threeten.bp.format.DateTimeFormatter f)

Method Summary

Modifier and Type	Method and Description
protected int	_countPeriods(String str)
protected T	_fromDecimal(com.fasterxml.jackson.databind.DeserializationContext context, BigDecimal value)
protected T	_fromLong(com.fasterxml.jackson.databind.DeserializationContext context, long timestamp)
protected <R> R	_handleDateTimeException(com.fasterxml.jackson.databind.DeserializationContext context, org.threeten.bp.DateTimeException e0, String value)
protected <R> R	_handleUnexpectedToken(com.fasterxml.jackson.databind.DeserializationContext context, com.fasterxml.jackson.core.JsonParser parser, com.fasterxml.jackson.core.JsonToken... expTypes)
protected <R> R	_handleUnexpectedToken(com.fasterxml.jackson.databind.DeserializationContext context, com.fasterxml.jackson.core.JsonParser parser, String message, Object... args)
protected org.threeten.bp.DateTimeException	_peelDTE(org.threeten.bp.DateTimeException e) Helper method used to peel off spurious wrappings of DateTimeException
protected <BOGUS> BOGUS	_reportWrongToken(com.fasterxml.jackson.databind.DeserializationContext context, com.fasterxml.jackson.core.JsonToken exp, String unit)
protected <BOGUS> BOGUS	_reportWrongToken(com.fasterxml.jackson.core.JsonParser parser, com.fasterxml.jackson.databind.DeserializationContext context, com.fasterxml.jackson.core.JsonToken... expTypes)
com.fasterxml.jackson.databind.JsonDeserializer<T>	createContextual(com.fasterxml.jackson.databind.DeserializationContext ctxt, com.fasterxml.jackson.databind.BeanProperty property)
T	deserialize(com.fasterxml.jackson.core.JsonParser parser, com.fasterxml.jackson.databind.DeserializationContext context)
Object	deserializeWithType(com.fasterxml.jackson.core.JsonParser parser, com.fasterxml.jackson.databind.DeserializationContext context, com.fasterxml.jackson.databind.jsontype.TypeDeserializer typeDeserializer)
protected boolean	shouldAdjustToContextTimezone(com.fasterxml.jackson.databind.DeserializationContext context)
protected InstantDeserializer<T>	withDateFormat(org.threeten.bp.format.DateTimeFormatter dtf)
protected InstantDeserializer<T>	withLeniency(Boolean leniency)

Methods inherited from class com.fasterxml.jackson.datatype.threetenbp.deser.ThreeTenDateTimeDeserializerBase

_failForNotLenient, _throwNoNumericTimestampNeedTimeZone, isLenient

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

deserialize, getEmptyAccessPattern, getNullAccessPattern, supportsUpdate

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

_byteOverflow, _coercedTypeDesc, _coerceEmptyString, _coerceIntegral, _coerceNullToken, _coerceTextualNull, _deserializeFromArray, _deserializeFromEmpty, _deserializeWrappedValue, _failDoubleToIntCoercion, _findNullProvider, _hasTextualNull, _intOverflow, _isEmptyOrTextualNull, _isIntNumber, _isNaN, _isNegInf, _isPosInf, _neitherNull, _nonNullNumber, _parseBooleanFromInt, _parseBooleanPrimitive, _parseBytePrimitive, _parseDate, _parseDate, _parseDateFromArray, _parseDoublePrimitive, _parseDoublePrimitive, _parseFloatPrimitive, _parseFloatPrimitive, _parseIntPrimitive, _parseIntPrimitive, _parseLongPrimitive, _parseLongPrimitive, _parseShortPrimitive, _parseString, _reportFailedNullCoerce, _shortOverflow, _verifyEndArrayForSingle, _verifyNullForPrimitive, _verifyNullForPrimitiveCoercion, _verifyNullForScalarCoercion, _verifyNumberForScalarCoercion, _verifyStringForScalarCoercion, findContentNullProvider, findContentNullStyle, findConvertingContentDeserializer, findDeserializer, findFormatFeature, findFormatOverrides, findValueNullProvider, getValueClass, getValueType, getValueType, handledType, handleMissingEndArrayForSingle, handleUnknownProperty, isDefaultDeserializer, isDefaultKeyDeserializer, parseDouble

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

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

Methods inherited from class java.lang.Object

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

Field Detail

INSTANT

public static final InstantDeserializer<org.threeten.bp.Instant> INSTANT

OFFSET_DATE_TIME

public static final InstantDeserializer<org.threeten.bp.OffsetDateTime> OFFSET_DATE_TIME

ZONED_DATE_TIME

public static final InstantDeserializer<org.threeten.bp.ZonedDateTime> ZONED_DATE_TIME

fromMilliseconds

protected final Function<InstantDeserializer.FromIntegerArguments,T extends org.threeten.bp.temporal.Temporal> fromMilliseconds

fromNanoseconds

protected final Function<InstantDeserializer.FromDecimalArguments,T extends org.threeten.bp.temporal.Temporal> fromNanoseconds

parsedToValue

protected final Function<org.threeten.bp.temporal.TemporalAccessor,T extends org.threeten.bp.temporal.Temporal> parsedToValue

adjust

protected final BiFunction<T extends org.threeten.bp.temporal.Temporal,org.threeten.bp.ZoneId,T extends org.threeten.bp.temporal.Temporal> adjust

replaceZeroOffsetAsZ

protected final boolean replaceZeroOffsetAsZ

In case of vanilla `Instant` we seem to need to translate "+0000 | +00:00 | +00" timezone designator into plain "Z" for some reason; see [jackson-modules-java8#18] for more info

Since:

2.9.0

_adjustToContextTZOverride

protected final Boolean _adjustToContextTZOverride

Flag for JsonFormat.Feature.ADJUST_DATES_TO_CONTEXT_TIME_ZONE

Since:

2.8

Constructor Detail

InstantDeserializer

protected InstantDeserializer(Class<T> supportedType,
                              org.threeten.bp.format.DateTimeFormatter formatter,
                              Function<org.threeten.bp.temporal.TemporalAccessor,T> parsedToValue,
                              Function<InstantDeserializer.FromIntegerArguments,T> fromMilliseconds,
                              Function<InstantDeserializer.FromDecimalArguments,T> fromNanoseconds,
                              BiFunction<T,org.threeten.bp.ZoneId,T> adjust,
                              boolean replaceZeroOffsetAsZ)

InstantDeserializer

protected InstantDeserializer(InstantDeserializer<T> base,
                              org.threeten.bp.format.DateTimeFormatter f)

InstantDeserializer

protected InstantDeserializer(InstantDeserializer<T> base,
                              Boolean adjustToContextTimezoneOverride)

Method Detail

withDateFormat

protected InstantDeserializer<T> withDateFormat(org.threeten.bp.format.DateTimeFormatter dtf)

Specified by:

withDateFormat in class ThreeTenDateTimeDeserializerBase<T extends org.threeten.bp.temporal.Temporal>

withLeniency

protected InstantDeserializer<T> withLeniency(Boolean leniency)

Specified by:

withLeniency in class ThreeTenDateTimeDeserializerBase<T extends org.threeten.bp.temporal.Temporal>

deserialize

public T deserialize(com.fasterxml.jackson.core.JsonParser parser,
                     com.fasterxml.jackson.databind.DeserializationContext context)
              throws IOException

Specified by:

deserialize in class com.fasterxml.jackson.databind.JsonDeserializer<T extends org.threeten.bp.temporal.Temporal>

Throws:

IOException

createContextual

public com.fasterxml.jackson.databind.JsonDeserializer<T> createContextual(com.fasterxml.jackson.databind.DeserializationContext ctxt,
                                                                           com.fasterxml.jackson.databind.BeanProperty property)
                                                                    throws com.fasterxml.jackson.databind.JsonMappingException

Specified by:

createContextual in interface com.fasterxml.jackson.databind.deser.ContextualDeserializer

Overrides:

createContextual in class ThreeTenDateTimeDeserializerBase<T extends org.threeten.bp.temporal.Temporal>

Throws:

com.fasterxml.jackson.databind.JsonMappingException

shouldAdjustToContextTimezone

protected boolean shouldAdjustToContextTimezone(com.fasterxml.jackson.databind.DeserializationContext context)

_countPeriods

protected int _countPeriods(String str)

_fromLong

protected T _fromLong(com.fasterxml.jackson.databind.DeserializationContext context,
                      long timestamp)

_fromDecimal

protected T _fromDecimal(com.fasterxml.jackson.databind.DeserializationContext context,
                         BigDecimal value)

deserializeWithType

public Object deserializeWithType(com.fasterxml.jackson.core.JsonParser parser,
                                  com.fasterxml.jackson.databind.DeserializationContext context,
                                  com.fasterxml.jackson.databind.jsontype.TypeDeserializer typeDeserializer)
                           throws IOException

Overrides:

deserializeWithType in class com.fasterxml.jackson.databind.deser.std.StdScalarDeserializer<T>

Throws:

IOException

_reportWrongToken

protected <BOGUS> BOGUS _reportWrongToken(com.fasterxml.jackson.databind.DeserializationContext context,
                                          com.fasterxml.jackson.core.JsonToken exp,
                                          String unit)
                                   throws IOException

Throws:

IOException

_reportWrongToken

protected <BOGUS> BOGUS _reportWrongToken(com.fasterxml.jackson.core.JsonParser parser,
                                          com.fasterxml.jackson.databind.DeserializationContext context,
                                          com.fasterxml.jackson.core.JsonToken... expTypes)
                                   throws IOException

Throws:

IOException

_handleDateTimeException

protected <R> R _handleDateTimeException(com.fasterxml.jackson.databind.DeserializationContext context,
                                         org.threeten.bp.DateTimeException e0,
                                         String value)
                                  throws com.fasterxml.jackson.databind.JsonMappingException

Throws:

com.fasterxml.jackson.databind.JsonMappingException

_handleUnexpectedToken

protected <R> R _handleUnexpectedToken(com.fasterxml.jackson.databind.DeserializationContext context,
                                       com.fasterxml.jackson.core.JsonParser parser,
                                       String message,
                                       Object... args)
                                throws com.fasterxml.jackson.databind.JsonMappingException

Throws:

com.fasterxml.jackson.databind.JsonMappingException

_handleUnexpectedToken

protected <R> R _handleUnexpectedToken(com.fasterxml.jackson.databind.DeserializationContext context,
                                       com.fasterxml.jackson.core.JsonParser parser,
                                       com.fasterxml.jackson.core.JsonToken... expTypes)
                                throws com.fasterxml.jackson.databind.JsonMappingException

Throws:

com.fasterxml.jackson.databind.JsonMappingException

_peelDTE

protected org.threeten.bp.DateTimeException _peelDTE(org.threeten.bp.DateTimeException e)

Helper method used to peel off spurious wrappings of DateTimeException

Parameters:

e - DateTimeException to peel

Returns:

DateTimeException that does not have another DateTimeException as its cause.