Package com.fasterxml.jackson.databind.deser.std

Class StdDeserializer<T>

    • Field Detail

      • F_MASK_ACCEPT_ARRAYS

        protected static final int F_MASK_ACCEPT_ARRAYS

      • _valueClass

        protected final java.lang.Class<?> _valueClass
        Type of values this deserializer handles: sometimes exact types, other time most specific supertype of types deserializer handles (which may be as generic as Object in some case)

    • Constructor Detail

      • StdDeserializer

        protected StdDeserializer​(java.lang.Class<?> vc)

      • StdDeserializer

        protected StdDeserializer​(JavaType valueType)

      • StdDeserializer

        protected StdDeserializer​(StdDeserializer<?> src)
        Copy-constructor for sub-classes to use, most often when creating new instances for ContextualDeserializer.
        Since:
        2.5

    • Method Detail

      • handledType

        public java.lang.Class<?> handledType()
        Description copied from class: JsonDeserializer
        Method for accessing type of values this deserializer produces. Note that this information is not guaranteed to be exact -- it may be a more generic (super-type) -- but it should not be incorrect (return a non-related type).

        Default implementation will return null, which means almost same same as returning Object.class would; that is, that nothing is known about handled type.

        Overrides:
        handledType in class JsonDeserializer<T>

      • getValueClass

        @Deprecated
public final java.lang.Class<?> getValueClass()
        Deprecated.
        Since 2.3 use handledType() instead

      • getValueType

        public JavaType getValueType()
        Exact structured type this deserializer handles, if known.

        Default implementation just returns null.

      • isDefaultDeserializer

        protected boolean isDefaultDeserializer​(JsonDeserializer<?> deserializer)
        Method that can be called to determine if given deserializer is the default deserializer Jackson uses; as opposed to a custom deserializer installed by a module or calling application. Determination is done using JacksonStdImpl annotation on deserializer class.

      • isDefaultKeyDeserializer

        protected boolean isDefaultKeyDeserializer​(KeyDeserializer keyDeser)

      • deserializeWithType

        public java.lang.Object deserializeWithType​(com.fasterxml.jackson.core.JsonParser p,
                                            DeserializationContext ctxt,
                                            TypeDeserializer typeDeserializer)
                                     throws java.io.IOException
        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 JsonDeserializer<T>
        typeDeserializer - Deserializer to use for handling type information
        Throws:
        java.io.IOException

      • _parseBooleanPrimitive

        protected final boolean _parseBooleanPrimitive​(com.fasterxml.jackson.core.JsonParser p,
                                               DeserializationContext ctxt)
                                        throws java.io.IOException
        Throws:
        java.io.IOException

      • _parseBooleanFromInt

        protected boolean _parseBooleanFromInt​(com.fasterxml.jackson.core.JsonParser p,
                                       DeserializationContext ctxt)
                                throws java.io.IOException
        Throws:
        java.io.IOException

      • _parseBytePrimitive

        protected final byte _parseBytePrimitive​(com.fasterxml.jackson.core.JsonParser p,
                                         DeserializationContext ctxt)
                                  throws java.io.IOException
        Throws:
        java.io.IOException

      • _parseShortPrimitive

        protected final short _parseShortPrimitive​(com.fasterxml.jackson.core.JsonParser p,
                                           DeserializationContext ctxt)
                                    throws java.io.IOException
        Throws:
        java.io.IOException

      • _parseIntPrimitive

        protected final int _parseIntPrimitive​(com.fasterxml.jackson.core.JsonParser p,
                                       DeserializationContext ctxt)
                                throws java.io.IOException
        Throws:
        java.io.IOException

      • _parseIntPrimitive

        protected final int _parseIntPrimitive​(DeserializationContext ctxt,
                                       java.lang.String text)
                                throws java.io.IOException
        Throws:
        java.io.IOException
        Since:
        2.9

      • _parseLongPrimitive

        protected final long _parseLongPrimitive​(com.fasterxml.jackson.core.JsonParser p,
                                         DeserializationContext ctxt)
                                  throws java.io.IOException
        Throws:
        java.io.IOException

      • _parseLongPrimitive

        protected final long _parseLongPrimitive​(DeserializationContext ctxt,
                                         java.lang.String text)
                                  throws java.io.IOException
        Throws:
        java.io.IOException
        Since:
        2.9

      • _parseFloatPrimitive

        protected final float _parseFloatPrimitive​(com.fasterxml.jackson.core.JsonParser p,
                                           DeserializationContext ctxt)
                                    throws java.io.IOException
        Throws:
        java.io.IOException

      • _parseFloatPrimitive

        protected final float _parseFloatPrimitive​(DeserializationContext ctxt,
                                           java.lang.String text)
                                    throws java.io.IOException
        Throws:
        java.io.IOException
        Since:
        2.9

      • _parseDoublePrimitive

        protected final double _parseDoublePrimitive​(com.fasterxml.jackson.core.JsonParser p,
                                             DeserializationContext ctxt)
                                      throws java.io.IOException
        Throws:
        java.io.IOException

      • _parseDoublePrimitive

        protected final double _parseDoublePrimitive​(DeserializationContext ctxt,
                                             java.lang.String text)
                                      throws java.io.IOException
        Throws:
        java.io.IOException
        Since:
        2.9

      • _parseDate

        protected java.util.Date _parseDate​(com.fasterxml.jackson.core.JsonParser p,
                                    DeserializationContext ctxt)
                             throws java.io.IOException
        Throws:
        java.io.IOException

      • _parseDateFromArray

        protected java.util.Date _parseDateFromArray​(com.fasterxml.jackson.core.JsonParser p,
                                             DeserializationContext ctxt)
                                      throws java.io.IOException
        Throws:
        java.io.IOException

      • _parseDate

        protected java.util.Date _parseDate​(java.lang.String value,
                                    DeserializationContext ctxt)
                             throws java.io.IOException
        Throws:
        java.io.IOException
        Since:
        2.8

      • parseDouble

        protected static final double parseDouble​(java.lang.String numStr)
                                   throws java.lang.NumberFormatException
        Helper method for encapsulating calls to low-level double value parsing; single place just because we need a work-around that must be applied to all calls.
        Throws:
        java.lang.NumberFormatException

      • _parseString

        protected final java.lang.String _parseString​(com.fasterxml.jackson.core.JsonParser p,
                                              DeserializationContext ctxt)
                                       throws java.io.IOException
        Helper method used for accessing String value, if possible, doing necessary conversion or throwing exception as necessary.
        Throws:
        java.io.IOException
        Since:
        2.1

      • _deserializeFromEmpty

        protected T _deserializeFromEmpty​(com.fasterxml.jackson.core.JsonParser p,
                                  DeserializationContext ctxt)
                           throws java.io.IOException
        Helper method that may be used to support fallback for Empty String / Empty Array non-standard representations; usually for things serialized as JSON Objects.
        Throws:
        java.io.IOException
        Since:
        2.5

      • _hasTextualNull

        protected boolean _hasTextualNull​(java.lang.String value)
        Helper method called to determine if we are seeing String value of "null", and, further, that it should be coerced to null just like null token.
        Since:
        2.3

      • _isEmptyOrTextualNull

        protected boolean _isEmptyOrTextualNull​(java.lang.String value)
        Since:
        2.9

      • _isNegInf

        protected final boolean _isNegInf​(java.lang.String text)

      • _isPosInf

        protected final boolean _isPosInf​(java.lang.String text)

      • _isNaN

        protected final boolean _isNaN​(java.lang.String text)

      • _failDoubleToIntCoercion

        protected void _failDoubleToIntCoercion​(com.fasterxml.jackson.core.JsonParser p,
                                        DeserializationContext ctxt,
                                        java.lang.String type)
                                 throws java.io.IOException
        Throws:
        java.io.IOException

      • _coerceNullToken

        protected java.lang.Object _coerceNullToken​(DeserializationContext ctxt,
                                            boolean isPrimitive)
                                     throws JsonMappingException
        Method to call when JSON `null` token is encountered. Note: only called when this deserializer encounters it but NOT when reached via property
        Throws:
        JsonMappingException
        Since:
        2.9

      • _verifyNumberForScalarCoercion

        protected void _verifyNumberForScalarCoercion​(DeserializationContext ctxt,
                                              com.fasterxml.jackson.core.JsonParser p)
                                       throws java.io.IOException
        Throws:
        java.io.IOException

      • _coercedTypeDesc

        protected java.lang.String _coercedTypeDesc()
        Helper method called to get a description of type into which a scalar value coercion is (most likely) being applied, to be used for constructing exception messages on coerce failure.
        Returns:
        Message with backtick-enclosed name of type this deserializer supports
        Since:
        2.9

      • findDeserializer

        protected JsonDeserializer<java.lang.Object> findDeserializer​(DeserializationContext ctxt,
                                                              JavaType type,
                                                              BeanProperty property)
                                                       throws JsonMappingException
        Helper method used to locate deserializers for properties the type this deserializer handles contains (usually for properties of bean types)
        Parameters:
        type - Type of property to deserialize
        property - Actual property object (field, method, constuctor parameter) used for passing deserialized values; provided so deserializer can be contextualized if necessary
        Throws:
        JsonMappingException

      • _isIntNumber

        protected final boolean _isIntNumber​(java.lang.String text)
        Helper method to check whether given text refers to what looks like a clean simple integer number, consisting of optional sign followed by a sequence of digits.

      • findConvertingContentDeserializer

        protected JsonDeserializer<?> findConvertingContentDeserializer​(DeserializationContext ctxt,
                                                                BeanProperty prop,
                                                                JsonDeserializer<?> existingDeserializer)
                                                         throws JsonMappingException
        Helper method that can be used to see if specified property has annotation indicating that a converter is to be used for contained values (contents of structured types; array/List/Map values)
        Parameters:
        existingDeserializer - (optional) configured content serializer if one already exists.
        Throws:
        JsonMappingException
        Since:
        2.2

      • findFormatOverrides

        protected com.fasterxml.jackson.annotation.JsonFormat.Value findFormatOverrides​(DeserializationContext ctxt,
                                                                                BeanProperty prop,
                                                                                java.lang.Class<?> typeForDefaults)
        Helper method that may be used to find if this deserializer has specific JsonFormat settings, either via property, or through type-specific defaulting.
        Parameters:
        typeForDefaults - Type (erased) used for finding default format settings, if any
        Since:
        2.7

      • handleUnknownProperty

        protected void handleUnknownProperty​(com.fasterxml.jackson.core.JsonParser p,
                                     DeserializationContext ctxt,
                                     java.lang.Object instanceOrClass,
                                     java.lang.String propName)
                              throws java.io.IOException
        Method called to deal with a property that did not map to a known Bean property. Method can deal with the problem as it sees fit (ignore, throw exception); but if it does return, it has to skip the matching Json content parser has.
        Parameters:
        p - Parser that points to value of the unknown property
        ctxt - Context for deserialization; allows access to the parser, error reporting functionality
        instanceOrClass - Instance that is being populated by this deserializer, or if not known, Class that would be instantiated. If null, will assume type is what getValueClass() returns.
        propName - Name of the property that cannot be mapped
        Throws:
        java.io.IOException

      • handleMissingEndArrayForSingle

        protected void handleMissingEndArrayForSingle​(com.fasterxml.jackson.core.JsonParser p,
                                              DeserializationContext ctxt)
                                       throws java.io.IOException
        Throws:
        java.io.IOException

      • _verifyEndArrayForSingle

        protected void _verifyEndArrayForSingle​(com.fasterxml.jackson.core.JsonParser p,
                                        DeserializationContext ctxt)
                                 throws java.io.IOException
        Throws:
        java.io.IOException

      • _neitherNull

        protected static final boolean _neitherNull​(java.lang.Object a,
                                            java.lang.Object b)
        Since:
        2.9

      • _byteOverflow

        protected final boolean _byteOverflow​(int value)
        Since:
        2.9

      • _shortOverflow

        protected final boolean _shortOverflow​(int value)
        Since:
        2.9

      • _intOverflow

        protected final boolean _intOverflow​(long value)
        Since:
        2.9

      • _nonNullNumber

        protected java.lang.Number _nonNullNumber​(java.lang.Number n)
        Since:
        2.9