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

如何使用 Jackson 反序列化任意深度嵌套的 XML 结构（如递归分组）

本文介绍在 Jackson 中处理任意深度嵌套 XML（如递归和）的反序列化方案，通过合理配置 @XmlRootElement、@JsonProperty 和 @JacksonXmlElementWrapper 等注解，实现自包含、可无限嵌套的 Java 对象建模，并完整保留层级路径中的数据上下文。

本文介绍在 jackson 中处理任意深度嵌套 xml（如递归 `` 和 ``）的反序列化方案，通过合理配置 `@xmlrootelement`、`@jsonproperty` 和 `@jacksonxmlelementwrapper` 等注解，实现自包含、可无限嵌套的 java 对象建模，并完整保留层级路径中的数据上下文。

Jackson 本身没有专用的“递归注解”，但其默认的反序列化机制天然支持自引用类型（self-referencing types），只要对象模型定义清晰、字段命名与 XML 结构对齐，并配合必要的 Jackson XML 模块（jackson-dataformat-xml）配置，即可无缝处理任意深度的嵌套结构。

✅ 正确建模递归结构

关键在于让 Group 类同时持有自身类型的集合（List），形成自然递归引用。Jackson 在解析时会自动识别并递归构建子树：

@XmlRootElement(name = "root")
public class Root {
    @XmlElement(name = "groups")
    private List<group> groups;

    // getter/setter（或使用 Lombok @Data）
}

@XmlRootElement(name = "group")  // 注意：原始 XML 中拼写错误（如 "gropup"/"goups"）需按实际修正
public class Group {
    @XmlElement(name = "group_data")
    private String groupData;

    @XmlElement(name = "groups")
    private List<group> groups; // ← 核心：递归嵌套入口

    @JacksonXmlElementWrapper(useWrapping = false)
    @XmlElement(name = "object")
    private List<item> items; // 多个 <object> 直接平铺，不包裹在 <items> 中

    // getter/setter
}

@XmlRootElement(name = "object")
public class Item {
    @XmlElement(name = "item_data") // 若实际 XML 中为 <item_data>；否则按需调整
    private ItemData item;

    // getter/setter
}

public class ItemData {
    @XmlElement(name = "item_name")
    private String itemName;

    // getter/setter
}</item_data></items></object></item></group></group>

⚠️ 注意命名一致性：XML 中的标签名（如、

✅ 启用 Jackson XML 支持

确保项目引入依赖（Maven）：

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

反序列化代码示例：

XmlMapper xmlMapper = new XmlMapper();
// 可选：启用忽略未知元素，增强鲁棒性
xmlMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);

Root root = xmlMapper.readValue(xmlString, Root.class);
// 所有嵌套层级的 groupData + items 均已完整加载

✅ 数据提取：获取“带完整路径的 Item”

若需收集所有 Item 并附带其所属的完整 Group 链（即从根到叶子的 groupData 路径），建议编写递归遍历工具方法：

public static List<itemwithcontext> collectItemsWithGroupPath(Root root) {
    List<itemwithcontext> result = new ArrayList();
    if (root.getGroups() != null) {
        for (Group group : root.getGroups()) {
            traverseGroup(group, new ArrayList(), result);
        }
    }
    return result;
}

private static void traverseGroup(Group group, List<string> path, List<itemwithcontext> result) {
    List<string> currentPath = new ArrayList(path);
    currentPath.add(group.getGroupData()); // 记录当前层级 group_data

    // 收集本层 items
    if (group.getItems() != null) {
        for (Item item : group.getItems()) {
            result.add(new ItemWithContext(item, currentPath));
        }
    }

    // 递归遍历子 groups
    if (group.getGroups() != null) {
        for (Group child : group.getGroups()) {
            traverseGroup(child, currentPath, result);
        }
    }
}

// 辅助类
public static class ItemWithContext {
    private final Item item;
    private final List<string> groupPath; // 如 ["A", "A.1", "A.1.α"]

    // constructor, getter...
}</string></string></itemwithcontext></string></itemwithcontext></itemwithcontext>

✅ 总结

Jackson 不需要特殊注解即可处理递归结构，核心是Java 类型自引用 + 正确的 XML 映射注解；
使用 @XmlElement(name = "...") 精准绑定标签名，@JacksonXmlElementWrapper(useWrapping = false) 消除冗余包装节点；
实际解析前务必校验 XML 实际结构（尤其大小写与拼写），避免因 FAIL_ON_UNKNOWN_PROPERTIES 导致失败；
对于业务上需要“路径上下文”的场景（如审计、权限继承），应在反序列化后通过递归遍历显式构造路径信息，而非强求反序列化一步到位。

该方案简洁、可扩展、符合 Jackson 最佳实践，适用于任意深度的树形 XML 数据建模。