org.codehaus.jackson.map

枚举 DeserializationConfig.Feature

java.lang.Object

java.lang.Enum<DeserializationConfig.Feature>

org.codehaus.jackson.map.DeserializationConfig.Feature

所有已实现的接口:

Serializable, Comparable<DeserializationConfig.Feature>, MapperConfig.ConfigFeature

封闭类:

DeserializationConfig

public static enum DeserializationConfig.Feature
extends Enum<DeserializationConfig.Feature>
implements MapperConfig.ConfigFeature

Enumeration that defines togglable features that guide the serialization feature.

枚举常量概要

枚举常量

枚举常量和说明
ACCEPT_EMPTY_STRING_AS_NULL_OBJECT Feature that can be enabled to allow JSON empty String value ("") to be bound to POJOs as null.
ACCEPT_SINGLE_VALUE_AS_ARRAY Feature that determines whether it is acceptable to coerce non-array (in JSON) values to work with Java collection (arrays, java.util.Collection) types.
AUTO_DETECT_CREATORS Feature that determines whether "creator" methods are automatically detected by consider public constructors, and static single argument methods with name "valueOf".
AUTO_DETECT_FIELDS Feature that determines whether non-static fields are recognized as properties.
AUTO_DETECT_SETTERS Feature that determines whether "setter" methods are automatically detected based on standard Bean naming convention or not.
CAN_OVERRIDE_ACCESS_MODIFIERS Feature that determines whether method and field access modifier settings can be overridden when accessing properties.
FAIL_ON_NULL_FOR_PRIMITIVES Feature that determines whether encountering of JSON null is an error when deserializing into Java primitive types (like 'int' or 'double').
FAIL_ON_NUMBERS_FOR_ENUMS Feature that determines whether JSON integer numbers are valid values to be used for deserializing Java enum values.
FAIL_ON_UNKNOWN_PROPERTIES Feature that determines whether encountering of unknown properties (ones that do not map to a property, and there is no "any setter" or handler that can handle it) should result in a failure (by throwing a JsonMappingException) or not.
READ_ENUMS_USING_TO_STRING Feature that determines standard deserialization mechanism used for Enum values: if enabled, Enums are assumed to have been serialized using return value of Enum.toString(); if disabled, return value of Enum.name() is assumed to have been used.
UNWRAP_ROOT_VALUE Feature to allow "unwrapping" root-level JSON value, to match setting of SerializationConfig.Feature.WRAP_ROOT_VALUE used for serialization.
USE_ANNOTATIONS Feature that determines whether annotation introspection is used for configuration; if enabled, configured AnnotationIntrospector will be used: if disabled, no annotations are considered.
USE_BIG_DECIMAL_FOR_FLOATS Feature that determines whether Json floating point numbers are to be deserialized into BigDecimals if only generic type description (either Object or Number, or within untyped Map or Collection context) is available.
USE_BIG_INTEGER_FOR_INTS Feature that determines whether Json integral (non-floating-point) numbers are to be deserialized into BigIntegers if only generic type description (either Object or Number, or within untyped Map or Collection context) is available.
USE_GETTERS_AS_SETTERS Feature that determines whether otherwise regular "getter" methods (but only ones that handle Collections and Maps, not getters of other type) can be used for purpose of getting a reference to a Collection and Map to modify the property, without requiring a setter method.
USE_JAVA_ARRAY_FOR_JSON_ARRAY Feature that determines whether JSON Array is mapped to Object[] or List<Object> when binding "untyped" objects (ones with nominal type of java.lang.Object).
WRAP_EXCEPTIONS Feature that determines whether Jackson code should catch and wrap Exceptions (but never Errors!)

方法概要

方法

限定符和类型	方法和说明
boolean	enabledByDefault() Accessor for checking whether this feature is enabled by default.
int	getMask() Returns bit mask for this feature instance
static DeserializationConfig.Feature	valueOf(String name) 返回带有指定名称的该类型的枚举常量。
static DeserializationConfig.Feature[]	values() 按照声明该枚举类型的常量的顺序, 返回 包含这些常量的数组。

从类继承的方法 java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

从类继承的方法 java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

枚举常量详细资料

USE_ANNOTATIONS

public static final DeserializationConfig.Feature USE_ANNOTATIONS

Feature that determines whether annotation introspection is used for configuration; if enabled, configured AnnotationIntrospector will be used: if disabled, no annotations are considered.

Feature is enabled by default.

从以下版本开始:

1.2

AUTO_DETECT_SETTERS

public static final DeserializationConfig.Feature AUTO_DETECT_SETTERS

Feature that determines whether "setter" methods are automatically detected based on standard Bean naming convention or not. If yes, then all public one-argument methods that start with prefix "set" are considered setters. If disabled, only methods explicitly annotated are considered setters.

Note that this feature has lower precedence than per-class annotations, and is only used if there isn't more granular configuration available.

Feature is enabled by default.

AUTO_DETECT_CREATORS

public static final DeserializationConfig.Feature AUTO_DETECT_CREATORS

Feature that determines whether "creator" methods are automatically detected by consider public constructors, and static single argument methods with name "valueOf". If disabled, only methods explicitly annotated are considered creator methods (except for the no-arg default constructor which is always considered a factory method).

Note that this feature has lower precedence than per-class annotations, and is only used if there isn't more granular configuration available.

Feature is enabled by default.

AUTO_DETECT_FIELDS

public static final DeserializationConfig.Feature AUTO_DETECT_FIELDS

Feature that determines whether non-static fields are recognized as properties. If yes, then all public member fields are considered as properties. If disabled, only fields explicitly annotated are considered property fields.

Note that this feature has lower precedence than per-class annotations, and is only used if there isn't more granular configuration available.

Feature is enabled by default.

从以下版本开始:

1.1

USE_GETTERS_AS_SETTERS

public static final DeserializationConfig.Feature USE_GETTERS_AS_SETTERS

Feature that determines whether otherwise regular "getter" methods (but only ones that handle Collections and Maps, not getters of other type) can be used for purpose of getting a reference to a Collection and Map to modify the property, without requiring a setter method. This is similar to how JAXB framework sets Collections and Maps: no setter is involved, just setter.

Note that such getters-as-setters methods have lower precedence than setters, so they are only used if no setter is found for the Map/Collection property.

Feature is enabled by default.

CAN_OVERRIDE_ACCESS_MODIFIERS

public static final DeserializationConfig.Feature CAN_OVERRIDE_ACCESS_MODIFIERS

Feature that determines whether method and field access modifier settings can be overridden when accessing properties. If enabled, method AccessibleObject.setAccessible(java.lang.reflect.AccessibleObject[], boolean) may be called to enable access to otherwise unaccessible objects.

USE_BIG_DECIMAL_FOR_FLOATS

public static final DeserializationConfig.Feature USE_BIG_DECIMAL_FOR_FLOATS

Feature that determines whether Json floating point numbers are to be deserialized into BigDecimals if only generic type description (either Object or Number, or within untyped Map or Collection context) is available. If enabled such values will be deserialized as BigDecimals; if disabled, will be deserialized as Doubles.

Feature is disabled by default, meaning that "untyped" floating point numbers will by default be deserialized as Doubles (choice is for performance reason -- BigDecimals are slower than Doubles)

USE_BIG_INTEGER_FOR_INTS

public static final DeserializationConfig.Feature USE_BIG_INTEGER_FOR_INTS

Feature that determines whether Json integral (non-floating-point) numbers are to be deserialized into BigIntegers if only generic type description (either Object or Number, or within untyped Map or Collection context) is available. If enabled such values will be deserialized as BigIntegers; if disabled, will be deserialized as "smallest" available type, which is either Integer, Long or BigInteger, depending on number of digits.

Feature is disabled by default, meaning that "untyped" floating point numbers will by default be deserialized using whatever is the most compact integral type, to optimize efficiency.

USE_JAVA_ARRAY_FOR_JSON_ARRAY

public static final DeserializationConfig.Feature USE_JAVA_ARRAY_FOR_JSON_ARRAY

Feature that determines whether JSON Array is mapped to Object[] or List<Object> when binding "untyped" objects (ones with nominal type of java.lang.Object). If true, binds as Object[]; if false, as List<Object>.

Feature is disabled by default, meaning that JSON arrays are bound as Lists.

从以下版本开始:

1.9

READ_ENUMS_USING_TO_STRING

public static final DeserializationConfig.Feature READ_ENUMS_USING_TO_STRING

Feature that determines standard deserialization mechanism used for Enum values: if enabled, Enums are assumed to have been serialized using return value of Enum.toString(); if disabled, return value of Enum.name() is assumed to have been used. Since pre-1.6 method was to use Enum name, this is the default.

Note: this feature should usually have same value as SerializationConfig.Feature.WRITE_ENUMS_USING_TO_STRING.

For further details, check out [JACKSON-212]

从以下版本开始:

1.6

FAIL_ON_UNKNOWN_PROPERTIES

public static final DeserializationConfig.Feature FAIL_ON_UNKNOWN_PROPERTIES

Feature that determines whether encountering of unknown properties (ones that do not map to a property, and there is no "any setter" or handler that can handle it) should result in a failure (by throwing a JsonMappingException) or not. This setting only takes effect after all other handling methods for unknown properties have been tried, and property remains unhandled.

Feature is enabled by default, meaning that JsonMappingException is thrown if an unknown property is encountered. This is the implicit default prior to introduction of the feature.

从以下版本开始:

1.2

FAIL_ON_NULL_FOR_PRIMITIVES

public static final DeserializationConfig.Feature FAIL_ON_NULL_FOR_PRIMITIVES

Feature that determines whether encountering of JSON null is an error when deserializing into Java primitive types (like 'int' or 'double'). If it is, a JsonProcessingException is thrown to indicate this; if not, default value is used (0 for 'int', 0.0 for double, same defaulting as what JVM uses).

Feature is disabled by default (to be consistent with behavior of Jackson 1.6), i.e. to allow use of nulls for primitive properties.

从以下版本开始:

1.7

FAIL_ON_NUMBERS_FOR_ENUMS

public static final DeserializationConfig.Feature FAIL_ON_NUMBERS_FOR_ENUMS

Feature that determines whether JSON integer numbers are valid values to be used for deserializing Java enum values. If set to 'false' numbers are acceptable and are used to map to ordinal() of matching enumeration value; if 'true', numbers are not allowed and a JsonMappingException will be thrown. Latter behavior makes sense if there is concern that accidental mapping from integer values to enums might happen (and when enums are always serialized as JSON Strings)

Feature is disabled by default (to be consistent with behavior of Jackson 1.6), i.e. to allow use of JSON integers for Java enums.

从以下版本开始:

1.7

WRAP_EXCEPTIONS

public static final DeserializationConfig.Feature WRAP_EXCEPTIONS

Feature that determines whether Jackson code should catch and wrap Exceptions (but never Errors!) to add additional information about location (within input) of problem or not. If enabled, most exceptions will be caught and re-thrown (exception specifically being that IOExceptions may be passed as is, since they are declared as throwable); this can be convenient both in that all exceptions will be checked and declared, and so there is more contextual information. However, sometimes calling application may just want "raw" unchecked exceptions passed as is.

Feature is enabled by default, and is similar in behavior to default prior to 1.7.

从以下版本开始:

1.7

ACCEPT_SINGLE_VALUE_AS_ARRAY

public static final DeserializationConfig.Feature ACCEPT_SINGLE_VALUE_AS_ARRAY

Feature that determines whether it is acceptable to coerce non-array (in JSON) values to work with Java collection (arrays, java.util.Collection) types. If enabled, collection deserializers will try to handle non-array values as if they had "implicit" surrounding JSON array. This feature is meant to be used for compatibility/interoperability reasons, to work with packages (such as XML-to-JSON converters) that leave out JSON array in cases where there is just a single element in array.

从以下版本开始:

1.8

UNWRAP_ROOT_VALUE

public static final DeserializationConfig.Feature UNWRAP_ROOT_VALUE

Feature to allow "unwrapping" root-level JSON value, to match setting of SerializationConfig.Feature.WRAP_ROOT_VALUE used for serialization. Will verify that the root JSON value is a JSON Object, and that it has a single property with expected root name. If not, a JsonMappingException is thrown; otherwise value of the wrapped property will be deserialized as if it was the root value.

从以下版本开始:

1.9

ACCEPT_EMPTY_STRING_AS_NULL_OBJECT

public static final DeserializationConfig.Feature ACCEPT_EMPTY_STRING_AS_NULL_OBJECT

Feature that can be enabled to allow JSON empty String value ("") to be bound to POJOs as null. If disabled, standard POJOs can only be bound from JSON null or JSON Object (standard meaning that no custom deserializers or constructors are defined; both of which can add support for other kinds of JSON values); if enable, empty JSON String can be taken to be equivalent of JSON null.

从以下版本开始:

1.8

方法详细资料

values

public static DeserializationConfig.Feature[] values()

按照声明该枚举类型的常量的顺序, 返回 包含这些常量的数组。该方法可用于迭代 常量, 如下所示:

for (DeserializationConfig.Feature c : DeserializationConfig.Feature.values())
    System.out.println(c);

valueOf

public static DeserializationConfig.Feature valueOf(String name)

返回带有指定名称的该类型的枚举常量。 字符串必须与用于声明该类型的枚举常量的 标识符完全匹配。(不允许有多余 的空格字符。)

参数:

name - 要返回的枚举常量的名称。

返回:

返回带有指定名称的枚举常量

抛出:

如果该枚举类型没有带有指定名称的常量, - 则抛出 IllegalArgumentException

如果参数为空值, - 则抛出 NullPointerException

enabledByDefault

public boolean enabledByDefault()

从接口复制的说明: MapperConfig.ConfigFeature

Accessor for checking whether this feature is enabled by default.

指定者:

enabledByDefault 在接口中 MapperConfig.ConfigFeature

getMask

public int getMask()

从接口复制的说明: MapperConfig.ConfigFeature

Returns bit mask for this feature instance

指定者:

getMask 在接口中 MapperConfig.ConfigFeature