Jackson如何正确编写自定义反序列化器,处理复杂嵌套JSON解析
反序列化故障修复
Data2字段全为null的原因及解决
你的data_array中每个元素的结构是外层包裹了data_type和data两个字段的复合对象,Data2对应的实际字段全部嵌套在data节点下,直接将整个数组元素反序列化为Data2时,Jackson无法匹配到对应字段,因此所有字段默认赋值为null。
修复后的反序列化逻辑示例:
@Override public DataList deserialize(JsonParser parser, DeserializationContext context) throws IOException { JsonNode rootNode = parser.getCodec().readTree(parser); DataTypeEnum type = DataTypeEnum.from(rootNode.get("data_type").asText()); // 提取data_array节点 JsonNode dataArrayNode = rootNode.get("data").get("data_array"); List<Data2> data2List = new ArrayList<>(); // 遍历数组元素,取每个元素的data节点反序列化为Data2 for (JsonNode elementNode : dataArrayNode) { JsonNode dataNode = elementNode.get("data"); Data2 data2 = parser.getCodec().treeToValue(dataNode, Data2.class); data2List.add(data2); } // 构造DataList实例,见下文 return buildDataList(type, data2List); }
私有构造不可变对象实例化方案
针对私有构造的不可变DataList,两种可选方案:
- 如果类提供了公开的静态工厂方法(如
DataList.of(DataTypeEnum type, List<Data2> list)),直接调用工厂方法创建实例即可 - 如果没有公开构建方法,通过反射调用私有构造:
private DataList buildDataList(DataTypeEnum type, List<Data2> data2List) throws IOException { try { Constructor<DataList> constructor = DataList.class.getDeclaredConstructor(DataTypeEnum.class, List.class); constructor.setAccessible(true); return constructor.newInstance(type, data2List); } catch (Exception e) { throw new IOException("Failed to create DataList instance", e); } }
JsonPath注解式反序列化实现
Jackson可以通过BeanDeserializerModifier扩展默认反序列化逻辑,实现和你Gson方案完全一致的效果,实现步骤如下:
- 首先定义自定义注解
@JsonPathExpression
@Target(ElementType.FIELD) @Retention(RetentionPolicy.RUNTIME) public @interface JsonPathExpression { String value(); }
- 自定义
JsonPathDeserializerModifier,扩展默认反序列化逻辑
public class JsonPathDeserializerModifier extends BeanDeserializerModifier { @Override public JsonDeserializer<?> modifyDeserializer(DeserializationConfig config, BeanDescription beanDesc, JsonDeserializer<?> deserializer) { // 扫描当前类所有带JsonPathExpression注解的字段 List<Field> pathFields = Arrays.stream(beanDesc.getBeanClass().getDeclaredFields()) .filter(f -> f.isAnnotationPresent(JsonPathExpression.class)) .peek(f -> f.setAccessible(true)) .collect(Collectors.toList()); if (pathFields.isEmpty()) { return deserializer; } // 返回包装后的反序列化器 return new JsonDeserializer<>() { @Override public Object deserialize(JsonParser p, DeserializationContext ctxt) throws IOException { // 先读取整棵树 JsonNode rootNode = p.getCodec().readTree(p); // 先用默认反序列化器生成实例 Object instance = deserializer.deserialize(rootNode.traverse(p.getCodec()), ctxt); // 处理所有带JsonPath注解的字段 for (Field field : pathFields) { JsonPathExpression anno = field.getAnnotation(JsonPathExpression.class); try { Object value = JsonPath.read(rootNode.toString(), anno.value()); // 类型转换适配 Object convertedValue = ctxt.readTreeAsValue((JsonNode) value, field.getType()); field.set(instance, convertedValue); } catch (PathNotFoundException | IllegalAccessException ignored) { } catch (Exception e) { throw new IOException("Failed to inject value for field " + field.getName(), e); } } return instance; } }; } }
- 注册到ObjectMapper即可使用
ObjectMapper objectMapper = new ObjectMapper(); SimpleModule module = new SimpleModule(); module.setDeserializerModifier(new JsonPathDeserializerModifier()); objectMapper.registerModule(module);
使用方式和你Gson的方案完全一致,直接在字段上添加@JsonPathExpression("$.data.data_array")这类注解即可自动注入对应路径的值。
内容的提问来源于stack exchange,提问作者Alessandro Parisi
相关产品推荐
相关产品推荐

