You need to enable JavaScript to run this app. Jackson适配JsonPatch DTO:多类型value识别与强转风险规避
优惠活动
大模型
产品
解决方案
定价
更多

Jackson适配JsonPatch DTO:多类型value识别与强转风险规避

适配JsonPatch场景的Jackson配置实现

核心问题根因

  • 原始代码将value字段声明为Object类型,Jackson默认无明确类型上下文,会将结构化对象反序列化为通用LinkedHashMap
  • Jackson默认浮点数反序列化规则会将非明确类型的数值转为Double类型,导致BigDecimal精度丢失

方案1:基于path语义的自定义反序列化(最适配JsonPatch标准)

利用JsonPatch自带的path字段的业务语义建立路径与目标类型的映射,不需要修改原有报文结构,完全符合RFC6902规范:

  1. 自定义针对JsonPatch实体的反序列化器,在解析过程中先读取path值,匹配对应的业务类型
  2. 核心实现代码:
    public class JsonPatchEntryDeserializer extends StdDeserializer<JsonPatchEntry> {
        // 按业务规则配置路径前缀与目标类型的映射
        private static final Map<String, Class<?>> PATH_TYPE_MAPPER = Map.of(
                "/people", Person.class,
                "/A", A.class
        );
    
        public JsonPatchEntryDeserializer() {
            super(JsonPatchEntry.class);
        }
    
        @Override
        public JsonPatchEntry deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
            JsonNode rootNode = p.getCodec().readTree(p);
            JsonPatchEntry entry = new JsonPatchEntry();
            
            // 先读取固定字段
            entry.setPath(rootNode.get("path").asText());
            entry.setOperation(rootNode.get("op").asText());
            
            // 无value字段的操作(如remove)直接跳过值解析
            if (rootNode.has("value")) {
                JsonNode valueNode = rootNode.get("value");
                // 根据path匹配对应解析类型
                Class<?> targetType = PATH_TYPE_MAPPER.entrySet().stream()
                        .filter(mapping -> entry.getPath().startsWith(mapping.getKey()))
                        .map(Map.Entry::getValue)
                        .findFirst()
                        .orElse(Object.class); // 匹配不到的场景兜底为通用类型
                // 按目标类型反序列化值节点,不会生成Map结构
                entry.setValues(p.getCodec().treeToValue(valueNode, targetType));
            }
            return entry;
        }
    }
    
  3. 注册反序列化器到ObjectMapper即可生效。

方案2:无侵入多态类型推导(不依赖path规则)

如果业务上path规则不固定,可利用Jackson的类型推导能力,在value字段上添加注解,无需修改报文结构即可自动匹配类型:

// 在JsonPatchEntry的values字段上添加注解
@JsonTypeInfo(use = JsonTypeInfo.Id.DEDUCTION)
@JsonSubTypes({
    @JsonSubTypes.Type(value = Person.class),
    @JsonSubTypes.Type(value = A.class)
})
@JsonProperty("value")
protected Object values;
  • 注解说明:Id.DEDUCTION模式下,Jackson不需要在报文中额外添加类型标识字段,会通过类的字段结构自动匹配:识别到报文含lastName/firstName等特征字段时自动反序列化为Person,识别到quantity/colour等特征字段时自动反序列化为A。

BigDecimal精度问题配置

全局给ObjectMapper开启浮点数类型强制转换配置,从根源上避免数值被转为double:

ObjectMapper objectMapper = new ObjectMapper()
    // 反序列化浮点数时默认使用BigDecimal,不转Double
    .enable(DeserializationFeature.USE_BIG_DECIMAL_FOR_FLOATS)
    // 整数类型按需匹配BigInteger,避免精度丢失
    .enable(DeserializationFeature.USE_BIG_INTEGER_FOR_INTS);
  • 配置生效后,无论通过哪种方式解析值,所有浮点数都会自动匹配BigDecimal类型,不需要后续手动强制转换。

注意事项

  • 示例报文里Person的字段firsName存在拼写错误,需和类里定义的firstName字段对齐,否则会出现字段空值
  • 针对remove这类无value字段的操作,反序列化逻辑要做兼容,避免空指针
  • 如果两个业务类存在同名字段,可通过调整@JsonSubTypes的声明顺序,优先匹配特征更明确的类型,避免识别错误
  • 后续新增value支持的类型时,仅需要在映射规则或多态注解中补充对应类即可,不需要修改核心反序列化逻辑

内容的提问来源于stack exchange,提问作者Pedro Almeida

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.15 21:27:04