Jackson适配JsonPatch DTO:多类型value识别与强转风险规避
适配JsonPatch场景的Jackson配置实现
核心问题根因
- 原始代码将
value字段声明为Object类型,Jackson默认无明确类型上下文,会将结构化对象反序列化为通用LinkedHashMap - Jackson默认浮点数反序列化规则会将非明确类型的数值转为
Double类型,导致BigDecimal精度丢失
方案1:基于path语义的自定义反序列化(最适配JsonPatch标准)
利用JsonPatch自带的path字段的业务语义建立路径与目标类型的映射,不需要修改原有报文结构,完全符合RFC6902规范:
- 自定义针对JsonPatch实体的反序列化器,在解析过程中先读取
path值,匹配对应的业务类型 - 核心实现代码:
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; } } - 注册反序列化器到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
相关产品推荐
相关产品推荐

