Class JSR310DeserializerBase<T>

  • All Implemented Interfaces:
    com.fasterxml.jackson.databind.deser.NullValueProvider, com.fasterxml.jackson.databind.deser.ValueInstantiator.Gettable, java.io.Serializable
    Direct Known Subclasses:
    DurationDeserializer, JSR310DateTimeDeserializerBase, JSR310StringParsableDeserializer

    abstract class JSR310DeserializerBase<T>
    extends com.fasterxml.jackson.databind.deser.std.StdScalarDeserializer<T>
    Base class that indicates that all JSR310 datatypes are deserialized from scalar JSON types.
    Since:
    2.2
    • Nested Class Summary

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

        com.fasterxml.jackson.databind.JsonDeserializer.None
    • Field Summary

      Fields 
      Modifier and Type Field Description
      protected 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).
      private static long serialVersionUID  
      • Fields inherited from class com.fasterxml.jackson.databind.deser.std.StdDeserializer

        _valueClass, _valueType, F_MASK_ACCEPT_ARRAYS, F_MASK_INT_COERCIONS
    • Method Summary

      All Methods Instance Methods Abstract Methods Concrete Methods 
      Modifier and Type Method Description
      protected T _failForNotLenient​(com.fasterxml.jackson.core.JsonParser p, com.fasterxml.jackson.databind.DeserializationContext ctxt, com.fasterxml.jackson.core.JsonToken expToken)  
      protected T _fromEmptyString​(com.fasterxml.jackson.core.JsonParser p, com.fasterxml.jackson.databind.DeserializationContext ctxt, java.lang.String str)
      Replacement for isLenient() for specific case of deserialization from empty or blank String.
      protected <R> R _handleDateTimeException​(com.fasterxml.jackson.databind.DeserializationContext context, java.time.DateTimeException e0, java.lang.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, java.lang.String message, java.lang.Object... args)  
      protected boolean _isValidTimestampString​(java.lang.String str)  
      protected java.time.DateTimeException _peelDTE​(java.time.DateTimeException e)
      Helper method used to peel off spurious wrappings of DateTimeException
      protected <BOGUS> BOGUS _reportWrongToken​(com.fasterxml.jackson.core.JsonParser parser, com.fasterxml.jackson.databind.DeserializationContext context, com.fasterxml.jackson.core.JsonToken... expTypes)  
      protected <BOGUS> BOGUS _reportWrongToken​(com.fasterxml.jackson.databind.DeserializationContext context, com.fasterxml.jackson.core.JsonToken exp, java.lang.String unit)  
      java.lang.Object deserializeWithType​(com.fasterxml.jackson.core.JsonParser parser, com.fasterxml.jackson.databind.DeserializationContext context, com.fasterxml.jackson.databind.jsontype.TypeDeserializer typeDeserializer)  
      protected boolean isLenient()  
      com.fasterxml.jackson.databind.type.LogicalType logicalType()  
      protected abstract JSR310DeserializerBase<T> withLeniency​(java.lang.Boolean leniency)  
      • 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, _checkBooleanToStringCoercion, _checkCoercionFail, _checkDoubleSpecialValue, _checkFloatSpecialValue, _checkFloatToIntCoercion, _checkFloatToStringCoercion, _checkFromStringCoercion, _checkFromStringCoercion, _checkIntToFloatCoercion, _checkIntToStringCoercion, _checkTextualNull, _checkToStringCoercion, _coerceBooleanFromInt, _coercedTypeDesc, _coercedTypeDesc, _coerceEmptyString, _coerceIntegral, _coerceNullToken, _coerceTextualNull, _deserializeFromArray, _deserializeFromEmpty, _deserializeFromEmptyString, _deserializeFromString, _deserializeWrappedValue, _failDoubleToIntCoercion, _findCoercionFromBlankString, _findCoercionFromEmptyArray, _findCoercionFromEmptyString, _findNullProvider, _hasTextualNull, _intOverflow, _isBlank, _isEmptyOrTextualNull, _isFalse, _isIntNumber, _isNaN, _isNegInf, _isPosInf, _isTrue, _neitherNull, _nonNullNumber, _parseBoolean, _parseBooleanFromInt, _parseBooleanPrimitive, _parseBooleanPrimitive, _parseBytePrimitive, _parseDate, _parseDate, _parseDateFromArray, _parseDouble, _parseDouble, _parseDoublePrimitive, _parseDoublePrimitive, _parseDoublePrimitive, _parseFloatPrimitive, _parseFloatPrimitive, _parseFloatPrimitive, _parseInteger, _parseInteger, _parseIntPrimitive, _parseIntPrimitive, _parseLong, _parseLong, _parseLongPrimitive, _parseLongPrimitive, _parseShortPrimitive, _parseString, _parseString, _reportFailedNullCoerce, _shortOverflow, _verifyEndArrayForSingle, _verifyNullForPrimitive, _verifyNullForPrimitiveCoercion, _verifyNullForScalarCoercion, _verifyNumberForScalarCoercion, _verifyStringForScalarCoercion, findContentNullProvider, findContentNullStyle, findConvertingContentDeserializer, findDeserializer, findFormatFeature, findFormatOverrides, findValueNullProvider, getValueClass, getValueInstantiator, getValueType, getValueType, handledType, handleMissingEndArrayForSingle, handleNestedArrayForSingle, handleUnknownProperty, isDefaultDeserializer, isDefaultKeyDeserializer
      • Methods inherited from class com.fasterxml.jackson.databind.JsonDeserializer

        deserialize, deserializeWithType, findBackReference, getAbsentValue, 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

      • _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.

        Note that with 2.12 and later coercion settings are moving to CoercionConfig, instead of simple yes/no leniency setting.

        Since:
        2.11
    • Constructor Detail

      • JSR310DeserializerBase

        protected JSR310DeserializerBase​(java.lang.Class<T> supportedType)
        Since:
        2.11
      • JSR310DeserializerBase

        protected JSR310DeserializerBase​(java.lang.Class<T> supportedType,
                                         java.lang.Boolean leniency)
      • JSR310DeserializerBase

        protected JSR310DeserializerBase​(JSR310DeserializerBase<T> base,
                                         java.lang.Boolean leniency)
    • Method Detail

      • withLeniency

        protected abstract JSR310DeserializerBase<T> withLeniency​(java.lang.Boolean leniency)
        Since:
        2.11
      • isLenient

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

        protected T _fromEmptyString​(com.fasterxml.jackson.core.JsonParser p,
                                     com.fasterxml.jackson.databind.DeserializationContext ctxt,
                                     java.lang.String str)
                              throws java.io.IOException
        Replacement for isLenient() for specific case of deserialization from empty or blank String.
        Throws:
        java.io.IOException
        Since:
        2.12
      • logicalType

        public com.fasterxml.jackson.databind.type.LogicalType logicalType()
        Overrides:
        logicalType in class com.fasterxml.jackson.databind.deser.std.StdScalarDeserializer<T>
      • deserializeWithType

        public java.lang.Object deserializeWithType​(com.fasterxml.jackson.core.JsonParser parser,
                                                    com.fasterxml.jackson.databind.DeserializationContext context,
                                                    com.fasterxml.jackson.databind.jsontype.TypeDeserializer typeDeserializer)
                                             throws java.io.IOException
        Overrides:
        deserializeWithType in class com.fasterxml.jackson.databind.deser.std.StdScalarDeserializer<T>
        Throws:
        java.io.IOException
      • _isValidTimestampString

        protected boolean _isValidTimestampString​(java.lang.String str)
      • _reportWrongToken

        protected <BOGUS> BOGUS _reportWrongToken​(com.fasterxml.jackson.databind.DeserializationContext context,
                                                  com.fasterxml.jackson.core.JsonToken exp,
                                                  java.lang.String unit)
                                           throws java.io.IOException
        Throws:
        java.io.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 java.io.IOException
        Throws:
        java.io.IOException
      • _handleDateTimeException

        protected <R> R _handleDateTimeException​(com.fasterxml.jackson.databind.DeserializationContext context,
                                                 java.time.DateTimeException e0,
                                                 java.lang.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,
                                               java.lang.String message,
                                               java.lang.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
      • _failForNotLenient

        protected T _failForNotLenient​(com.fasterxml.jackson.core.JsonParser p,
                                       com.fasterxml.jackson.databind.DeserializationContext ctxt,
                                       com.fasterxml.jackson.core.JsonToken expToken)
                                throws java.io.IOException
        Throws:
        java.io.IOException
      • _peelDTE

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