如何使用 Jackson 反序列化任意深度嵌套的 XML 结构-java教程-PHP中文网

本文介绍在 Jackson 中处理任意深度递归嵌套 XML（如多层嵌套）的反序列化方案，通过合理配置注解与 POJO 结构，自动映射层级关系并完整保留“组链路+对象数据”的上下文关联。

本文介绍在 jackson 中处理任意深度递归嵌套 xml（如多层 `` 嵌套）的反序列化方案，通过合理配置注解与 pojo 结构，自动映射层级关系并完整保留“组链路+对象数据”的上下文关联。

Jackson 本身不提供专用的 @Recursive 或类似注解，但其默认的反序列化机制天然支持自引用（self-referencing）类型——只要 Java 类结构清晰表达了递归关系（例如 Group 类中包含 List groups 字段），Jackson 就能正确解析无限嵌套的 XML/JSON 数据，无需额外干预。

核心实现要点

结构建模需体现递归性：Group 类必须包含自身类型的集合字段（如 private List groups;），这是 Jackson 推断嵌套层级的基础；
XML 元素名与字段精准绑定：使用 @JsonProperty（JSON 场景）或 @XmlElement/@JacksonXmlProperty（XML 场景）明确指定字段对应的实际标签名；
处理无包装列表（flat list）：当子元素（如
根元素声明不可少：使用 @XmlRootElement(name = "root") 标记顶层类，确保 Jackson XML 模块（jackson-dataformat-xml）能正确定位入口。

以下为完整可运行的 POJO 示例（适配您提供的 XML 结构）：

import com.fasterxml.jackson.annotation.JsonProperty;
import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlElementWrapper;
import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlRootElement;

@JacksonXmlRootElement(localName = "root")
public class Root {
    private List<group> groups;

    // getter/setter（Lombok @Data 或手动补充）
    public List<group> getGroups() { return groups; }
    public void setGroups(List<group> groups) { this.groups = groups; }
}

public class Group {
    @JsonProperty("group_data")
    private String groupData;

    private List<group> groups; // ← 关键：递归引用，支撑任意深度嵌套

    @JacksonXmlElementWrapper(useWrapping = false)
    private List<item> items; // ← 关键：禁用 <items> 包装，匹配扁平 <object> 序列

    // getters/setters...
    public String getGroupData() { return groupData; }
    public void setGroupData(String groupData) { this.groupData = groupData; }
    public List<group> getGroups() { return groups; }
    public void setGroups(List<group> groups) { this.groups = groups; }
    public List<item> getItems() { return items; }
    public void setItems(List<item> items) { this.items = items; }
}

@JacksonXmlRootElement(localName = "object")
public class Item {
    private ItemData item;

    // getter/setter...
    public ItemData getItem() { return item; }
    public void setItem(ItemData item) { this.item = item; }
}

public class ItemData {
    private String itemName;

    // getter/setter...
    public String getItemName() { return itemName; }
    public void setItemName(String itemName) { this.itemName = itemName; }
}</item></item></group></group></object></items></item></group></group></group></group>

使用示例（反序列化）

XmlMapper xmlMapper = new XmlMapper();
// 启用对空标签、命名空间等常见 XML 特性的兼容（可选）
xmlMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);

String xml = "<root>...your deeply nested XML...</root>";
Root root = xmlMapper.readValue(xml, Root.class);
// 此时 root.getGroups() 已完整构建整棵树，每层 Group 都携带其 groupData 和下属 items

注意事项与最佳实践

✅ 务必引入 jackson-dataformat-xml 依赖（Maven）：

<dependency><groupid>com.fasterxml.jackson.dataformat</groupid><artifactid>jackson-dataformat-xml</artifactid><version>2.17.0</version><!-- 请使用最新稳定版 --></dependency>

⚠️ XML 标签拼写需严格一致（如原文中 / 为笔误，实际 XML 必须为 / ，否则解析失败）；
? 若需反向序列化（Java → XML），建议为所有类添加无参构造函数（Jackson 默认要求）；
? 对于超深嵌套（>1000 层），可考虑设置 XmlMapper.setDefaultLeniency(true) 并监控栈深度，避免 StackOverflowError；
? 如需提取“所有 Item 及其完整祖先 GroupData 链”，可在反序列化后编写递归遍历工具方法，利用 Group 的嵌套结构自然还原路径。

通过上述设计，Jackson 不仅能准确还原任意深度的嵌套结构，还能保持语义完整性——每个 Item 所属的 GroupData 层级关系，在对象图中天然可追溯，满足“收集所有对象并附带完整组链数据”的核心诉求。