枚举项 | 作用 |
ACCEPT_EMPTY_ARRAY_AS_NULL_OBJECT |
决定是否允许将空数组 ([]) 绑定为 null。默认情况下禁用,意味着不允许。 |
ACCEPT_EMPTY_STRING_AS_NULL_OBJECT |
决定是否允许将空字符串 ("") 绑定为 null。默认情况下禁用,意味着不允许。 |
ACCEPT_FLOAT_AS_INT |
决定是否允许将 JSON 浮点数强制转换为整数。默认情况下启用,意味着允许。 |
ACCEPT_SINGLE_VALUE_AS_ARRAY |
决定是否允许将非数组值反序列化为 Java 集合类型。默认情况下禁用,意味着不允许。 |
ADJUST_DATES_TO_CONTEXT_TIME_ZONE |
决定是否使用上下文提供的时区调整日期/时间值。默认情况下启用,意味着会使用上下文时区。 |
EAGER_DESERIALIZER_FETCH |
决定是否尝试提前获取必要的反序列化器。默认情况下启用,意味着会提前获取。 |
FAIL_ON_IGNORED_PROPERTIES |
决定在遇到被标记为忽略的属性时是否抛出异常。默认情况下禁用,意味着不会抛出异常。 |
FAIL_ON_INVALID_SUBTYPE |
决定在遇到无效的多态类型信息时是否抛出异常。默认情况下启用,意味着会抛出异常。 |
FAIL_ON_MISSING_CREATOR_PROPERTIES |
决定在缺少创建者属性时是否抛出异常。默认情况下禁用,意味着不会抛出异常。 |
FAIL_ON_MISSING_EXTERNAL_TYPE_ID_PROPERTY |
决定在缺少外部类型 ID 属性时是否抛出异常。默认情况下启用,意味着会抛出异常。 |
FAIL_ON_NULL_CREATOR_PROPERTIES |
决定在创建者属性为 null 时是否抛出异常。默认情况下禁用,意味着不会抛出异常。 |
FAIL_ON_NULL_FOR_PRIMITIVES |
决定在反序列化为 Java 基本类型时遇到 JSON null 是否抛出异常。默认情况下禁用,意味着将使用默认值(如 0)。 |
FAIL_ON_NUMBERS_FOR_ENUMS |
决定是否允许使用 JSON 整数值反序列化为 Java 枚举值。默认情况下禁用,意味着允许使用整数值。 |
FAIL_ON_READING_DUP_TREE_KEY |
决定在读取 JSON 树时遇到重复键是否抛出异常。默认情况下禁用,意味着不会抛出异常。 |
FAIL_ON_TRAILING_TOKENS |
决定在反序列化根值后是否检查剩余的 JSON 令牌。默认情况下禁用,意味着不会进行检查。 |
FAIL_ON_UNKNOWN_PROPERTIES |
决定在遇到未知属性时是否抛出异常。默认情况下启用,意味着会抛出 `JsonMappingException`。 |
FAIL_ON_UNRESOLVED_OBJECT_IDS |
决定在遇到未解析的对象 ID 时是否抛出异常。默认情况下启用,意味着会抛出异常。 |
READ_DATE_TIMESTAMPS_AS_NANOSECONDS |
决定是否使用纳秒时间戳反序列化日期/时间值。默认情况下启用,意味着使用纳秒时间戳。 |
READ_ENUMS_USING_TO_STRING |
决定是否使用 `Enum.toString()` 方法反序列化枚举值。默认情况下禁用,意味着使用 `Enum.name()` 方法。 |
READ_UNKNOWN_ENUM_VALUES_AS_NULL |
决定是否将未知的枚举值解析为 null。默认情况下禁用,意味着会抛出异常。 |
READ_UNKNOWN_ENUM_VALUES_USING_DEFAULT_VALUE |
决定是否使用预定义的默认值解析未知的枚举值。默认情况下禁用,意味着会抛出异常。 |
UNWRAP_ROOT_VALUE |
决定是否允许解包根级 JSON 值以匹配序列化时的设置。默认情况下禁用,意味着不允许。 |
UNWRAP_SINGLE_VALUE_ARRAYS |
决定是否允许将单值数组反序列化为对应的值类型。默认情况下禁用,意味着不允许。 |
USE_BIG_DECIMAL_FOR_FLOATS |
决定是否将 JSON 浮点数反序列化为 `BigDecimal`。默认情况下禁用,意味着浮点数将反序列化为 `Double`。 |
USE_BIG_INTEGER_FOR_INTS |
决定是否将 JSON 整数反序列化为 `BigInteger`。默认情况下禁用,意味着整数将反序列化为最小的可用类型(`Integer`、`Long` 或 `BigInteger`)。 |
USE_JAVA_ARRAY_FOR_JSON_ARRAY |
决定是否将 JSON 数组映射为 `Object[]` 或 `List`。默认情况下禁用,意味着 JSON 数组将映射为 `List`。 |
USE_LONG_FOR_INTS |
决定是否将小的 JSON 整数(适合 32 位整数)反序列化为 `Long`。默认情况下禁用,意味着这些整数将反序列化为 `Integer`。 |
WRAP_EXCEPTIONS |
决定是否捕获并包装异常以添加位置信息。默认情况下启用,意味着会捕获并包装异常。 |