JacksonXML转JSON忽略属性提取值

本文深入解析了如何利用 Jackson 的 XmlMapper 和 ObjectNode 灵活处理“带冗余属性的 XML → 简洁合法 JSON”这一常见集成难题，聚焦于剥离无业务意义的 XML 属性（如 `class`、`resolves-to`）、精准提取 `` 等文本节点内容，并输出语义清晰、符合 JSON 规范的结构——特别推荐直接扁平化为字符串值的方案（如 `"dateIssuedField": "0001-01-01T00:00:00"`），辅以可运行代码、关键避坑提示（如 `path()` 安全取值、属性即普通字段可直删）和批量处理扩展技巧，让开发者无需建模、不踩陷阱，高效实现轻量级、高可控的 XML-to-JSON 转换。

本文详解如何使用 Jackson 将含冗余属性的 XML（如 class、resolves-to）安全转换为简洁、合法的 JSON，重点演示动态移除 XML 属性、提取 文本内容，并生成符合 JSON 规范的结构。

本文详解如何使用 Jackson 将含冗余属性的 XML（如 `class`、`resolves-to`）安全转换为简洁、合法的 JSON，重点演示动态移除 XML 属性、提取 `` 文本内容，并生成符合 JSON 规范的结构。

在实际系统集成中，常需将第三方或遗留系统输出的 XML（含大量无业务意义的元数据属性）转换为标准 JSON。典型场景如解析 Xerces 序列化的 XMLGregorianCalendar 片段：

<dateIssuedField class="org.apache.xerces.jaxp.datatype.XMLGregorianCalendarImpl" resolves-to="org.apache.xerces.jaxp.datatype.SerializedXMLGregorianCalendar">
  <lexicalValue>0001-01-01T00:00:00</lexicalValue>
</dateIssuedField>

目标不是保留原始 XML 结构，而是剥离所有属性，仅提取 的文本内容，并映射为语义清晰的 JSON 字段。需注意：原始问题中期望的 {"dateIssuedField": {"0001-01-01T00:00:00"}} 并非合法 JSON（缺少键名），因此本文采用业界通用且语义明确的三种合规方案：

• ✅ 方案 A：扁平化为字符串值（推荐）→ "dateIssuedField": "0001-01-01T00:00:00"
• ✅ 方案 B：封装为单元素数组 → "dateIssuedField": ["0001-01-01T00:00:00"]
• ✅ 方案 C：转为键值对（需显式 null）→ "dateIssuedField": {"0001-01-01T00:00:00": null}

以下以 方案 A（最常用、最直观） 为核心，提供可直接运行的 Java 示例：

✅ 推荐方案：属性剥离 + 文本值直接替换

import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.node.ObjectNode;
import com.fasterxml.jackson.dataformat.xml.XmlMapper;

public class XmlToCleanJson {
    public static void main(String[] args) throws Exception {
        XmlMapper xmlMapper = new XmlMapper();
        ObjectMapper jsonMapper = new ObjectMapper();

        // 假设 XML 内容已加载为字符串
        String xml = """
            <myRoot>
              <dateIssuedField class="foo.bar.Baz" resolves-to="com.example.Ignore">
                <lexicalValue>0001-01-01T00:00:00</lexicalValue>
              </dateIssuedField>
            </myRoot>
            """;

        // 步骤 1：解析 XML 为 JsonNode 树
        JsonNode rootNode = xmlMapper.readTree(xml.getBytes());
        ObjectNode objectRoot = (ObjectNode) rootNode;

        // 步骤 2：定位目标节点并提取 lexicalValue 文本
        ObjectNode dateNode = (ObjectNode) objectRoot.get("dateIssuedField");
        String lexValue = dateNode.path("lexicalValue").textValue();

        // 步骤 3：用纯文本值直接替换整个 dateIssuedField 节点
        objectRoot.replace("dateIssuedField", jsonMapper.textNode(lexValue));

        // 步骤 4：序列化为标准 JSON 字符串
        String result = jsonMapper.writeValueAsString(objectRoot);
        System.out.println(result);
        // 输出：{"myRoot":{"dateIssuedField":"0001-01-01T00:00:00"}}
    }
}

⚠️ 关键注意事项

• 属性移除无需 MixIn 或注解：因 XML 属性在 Jackson 的 ObjectNode 中表现为普通字段（如 "class"、"resolves-to"），可直接调用 remove("key") 清理，无需预先定义类或配置序列化器。
• path() 比 get() 更安全：dateNode.path("lexicalValue") 在字段不存在时返回 MissingNode，避免 NullPointerException；而 get() 会返回 null，需额外判空。
• 依赖版本要求：确保使用 jackson-dataformat-xml ≥ 2.12（推荐 2.14+），其 XmlMapper 对属性处理更稳定。
• 嵌套结构通用性：若存在多个类似字段（如 dateCreatedField, dateModifiedField），可用递归遍历或正则匹配节点名批量处理。
• 性能考量：对于超大 XML，readTree() 会构建完整内存树。若仅需提取少数字段，建议结合 XmlParser 流式解析（StAX 模式）提升效率。

? 扩展：批量处理与健壮性增强

若需处理任意层级的 及其 ，可封装为工具方法：

public static void extractLexicalValues(ObjectNode node) {
    Iterator<Map.Entry<String, JsonNode>> fields = node.fields();
    while (fields.hasNext()) {
        Map.Entry<String, JsonNode> entry = fields.next();
        if (entry.getKey().endsWith("Field") && entry.getValue().isContainerNode()) {
            ObjectNode fieldNode = (ObjectNode) entry.getValue();
            JsonNode lexNode = fieldNode.path("lexicalValue");
            if (lexNode.isValueNode() && !lexNode.isNull()) {
                node.replace(entry.getKey(), jsonMapper.textNode(lexNode.asText()));
            }
        }
    }
}

✅ 总结

Jackson 的 XmlMapper + ObjectNode 组合提供了极强的 XML 结构操作能力——无需生成 Java 类、无需自定义序列化器，即可通过树遍历与节点替换，精准实现“去属性、提文本、转 JSON”的核心需求。优先选择字符串值扁平化（方案 A），既符合 JSON 规范，又利于前端消费与后续 JSON Schema 校验。当业务逻辑复杂或 XML 规模庞大时，再考虑引入 JAXB 或手动建模以获得更强类型安全与可维护性。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《JacksonXML转JSON忽略属性提取值》文章吧，也可关注golang学习网公众号了解相关技术文章。