Module tools.jackson.databind
Package tools.jackson.databind.ext.javatime.deser

Class JSR310DateTimeDeserializerBase<T>

java.lang.Object
tools.jackson.databind.ValueDeserializer<T>
tools.jackson.databind.deser.std.StdDeserializer<T>
tools.jackson.databind.deser.std.StdScalarDeserializer<T>
tools.jackson.databind.ext.javatime.deser.JSR310DateTimeDeserializerBase<T>
All Implemented Interfaces:
NullValueProvider, ValueInstantiator.Gettable
Direct Known Subclasses:
InstantDeserializer, LocalDateDeserializer, LocalDateTimeDeserializer, LocalTimeDeserializer, MonthDayDeserializer, MonthDeserializer, OffsetTimeDeserializer, YearDeserializer, YearMonthDeserializer
public abstract class JSR310DateTimeDeserializerBase<T> extends StdScalarDeserializer<T>

  • Field Details

    • _formatter

      protected final DateTimeFormatter _formatter

    • _shape

      protected final JsonFormat.Shape _shape
      Setting that indicates the JsonFormat.Shape specified for this deserializer as a JsonFormat.Shape annotation on property or class, or due to per-type "config override", or from global settings: If Shape is NUMBER_INT, the input value is considered to be epoch days. If not a NUMBER_INT, and the deserializer was not specified with the leniency setting of true, then an exception will be thrown.

    • _isLenient

      protected final boolean _isLenient
      Flag that indicates what leniency setting is enabled for this deserializer (either due JsonFormat.Shape annotation on property or class, or due to per-type "config override", or from global settings): leniency/strictness has effect on accepting some non-default input value representations (such as integer values for dates).

      Note that global default setting is for leniency to be enabled, for Jackson 2.x, and has to be explicitly change to force strict handling: this is to keep backwards compatibility with earlier versions.

  • Constructor Details

  • Method Details

    • withDateFormat

      protected abstract JSR310DateTimeDeserializerBase<T> withDateFormat(DateTimeFormatter dtf)

    • withLeniency

      protected abstract JSR310DateTimeDeserializerBase<T> withLeniency(Boolean leniency)

    • withShape

      protected JSR310DateTimeDeserializerBase<T> withShape(JsonFormat.Shape shape)
      The default implementation returns this, because shape is more likely applicable in case of the serialization, usage during deserialization could cover only very specific cases.

    • createContextual

      public ValueDeserializer<?> createContextual(DeserializationContext ctxt, BeanProperty property)
      Description copied from class: ValueDeserializer
      Method called to see if a different (or differently configured) deserializer is needed to deserialize values of specified property. Note that instance that this method is called on is typically shared one and as a result method should NOT modify this instance but rather construct and return a new instance. This instance should only be returned as-is, in case it is already suitable for use.
      Overrides:
      createContextual in class ValueDeserializer<T>
      Parameters:
      ctxt - Deserialization context to access configuration, additional deserializers that may be needed by this deserializer
      property - Method, field or constructor parameter that represents the property (and is used to assign deserialized value). Should be available; but there may be cases where caller cannot provide it and null is passed instead (in which case impls usually pass 'this' deserializer as is)
      Returns:
      Deserializer to use for deserializing values of specified property; may be this instance or a new instance.

    • _withFormatOverrides

      protected JSR310DateTimeDeserializerBase<?> _withFormatOverrides(DeserializationContext ctxt, BeanProperty property, JsonFormat.Value formatOverrides)
      Parameters:
      ctxt - Active deserialization context
      property - (optional) Property on which this deserializer is used, or null for root value
      formatOverrides - Format overrides to use (non-null)
      Returns:
      Either this deserializer as is, or newly constructed variant if created for different configuration
      Since:
      2.12.1

    • _throwNoNumericTimestampNeedTimeZone

      protected <BOGUS> BOGUS _throwNoNumericTimestampNeedTimeZone(tools.jackson.core.JsonParser p, DeserializationContext ctxt) throws tools.jackson.core.JacksonException
      Throws:
      tools.jackson.core.JacksonException

    • isLenient

      protected boolean isLenient()
      Returns:
      true if lenient handling is enabled; {code false} if not (strict mode)

    • _fromEmptyString

      protected T _fromEmptyString(tools.jackson.core.JsonParser p, DeserializationContext ctxt, String str) throws tools.jackson.core.JacksonException
      Replacement for isLenient() for specific case of deserialization from empty or blank String.
      Throws:
      tools.jackson.core.JacksonException
      Since:
      2.12

    • logicalType

      public LogicalType logicalType()
      Description copied from class: ValueDeserializer
      Method for accessing logical type of values this deserializer produces. Typically used for further configuring handling of values, for example, to find which coercions are legal.
      Overrides:
      logicalType in class StdScalarDeserializer<T>
      Returns:
      Logical type of values this deserializer produces, if known; null if not

    • deserializeWithType

      public Object deserializeWithType(tools.jackson.core.JsonParser parser, DeserializationContext context, TypeDeserializer typeDeserializer) throws tools.jackson.core.JacksonException
      Description copied from class: StdDeserializer
      Base implementation that does not assume specific type inclusion mechanism. Sub-classes are expected to override this method if they are to handle type information.
      Overrides:
      deserializeWithType in class StdScalarDeserializer<T>
      typeDeserializer - Deserializer to use for handling type information
      Throws:
      tools.jackson.core.JacksonException

    • _isValidTimestampString

      protected boolean _isValidTimestampString(String str)

    • _reportWrongToken

      protected <BOGUS> BOGUS _reportWrongToken(DeserializationContext context, tools.jackson.core.JsonToken exp, String unit) throws tools.jackson.core.JacksonException
      Throws:
      tools.jackson.core.JacksonException

    • _reportWrongToken

      protected <BOGUS> BOGUS _reportWrongToken(tools.jackson.core.JsonParser parser, DeserializationContext context, tools.jackson.core.JsonToken... expTypes) throws tools.jackson.core.JacksonException
      Throws:
      tools.jackson.core.JacksonException

    • _handleDateTimeException

      protected <R> R _handleDateTimeException(DeserializationContext context, DateTimeException e0, String value) throws tools.jackson.core.JacksonException
      Throws:
      tools.jackson.core.JacksonException

    • _handleDateTimeFormatException

      protected <R> R _handleDateTimeFormatException(DeserializationContext context, DateTimeException e0, DateTimeFormatter format, String value) throws tools.jackson.core.JacksonException
      Throws:
      tools.jackson.core.JacksonException

    • _handleUnexpectedToken

      protected <R> R _handleUnexpectedToken(DeserializationContext ctxt, tools.jackson.core.JsonParser parser, String message, Object... args)

    • _handleUnexpectedToken

      protected <R> R _handleUnexpectedToken(DeserializationContext context, tools.jackson.core.JsonParser parser, tools.jackson.core.JsonToken... expTypes)

    • _failForNotLenient

      protected T _failForNotLenient(tools.jackson.core.JsonParser p, DeserializationContext ctxt, tools.jackson.core.JsonToken expToken) throws tools.jackson.core.JacksonException
      Throws:
      tools.jackson.core.JacksonException

    • _peelDTE

      protected DateTimeException _peelDTE(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.