Jackson XML 转 JSON 时忽略属性并提取文本内容的完整实践指南-java教程-PHP中文网

Jackson XML 转 JSON 时忽略属性并提取文本内容的完整实践指南

本文详解如何使用 Jackson 将含冗余属性（如 class、resolves-to）的 XML 安全转换为简洁 JSON，重点实现属性过滤与文本提取，无需预定义类或注解。

本文详解如何使用 jackson 将含冗余属性（如 `class`、`resolves-to`）的 xml 安全转换为简洁 json，重点实现属性过滤与 `` 文本提取，无需预定义类或注解。

在实际系统集成中，常遇到结构不规范的 XML（例如由遗留框架生成），其中包含大量无业务意义的元数据属性（如 class="org.apache.xerces.jaxp.datatype.XMLGregorianCalendarImpl" 和 resolves-to="..."），而真正需要的是嵌套子节点（如）中的纯文本值。此时若直接使用 XmlMapper.readTree() 转为 JsonNode，这些属性会作为字段保留在 JSON 中，导致输出臃肿且不符合下游消费预期。

Jackson 并未提供“全局忽略所有 XML 属性”的开箱即用配置（XmlMapper 的 configure(...) 方法不支持属性级过滤），但可通过 树模型（Tree Model）后处理 灵活解决——即先解析为 ObjectNode，再遍历、裁剪、重构节点结构。

✅ 推荐方案：基于 ObjectNode 的精准重构（推荐 JSON 字符串形式）

最符合语义与 JSON 规范的做法是将 0001-01-01T00:00:00 直接映射为 "dateIssuedField": "0001-01-01T00:00:00"。该格式合法、扁平、易解析，也是绝大多数 API 的标准约定。

XmlMapper xmlMapper = new XmlMapper();
ObjectMapper jsonMapper = new ObjectMapper();

try (InputStream xmlStream = getClass().getResourceAsStream("/in.xml")) {
    // 1. 解析 XML 为 JsonNode 树
    ObjectNode rootNode = (ObjectNode) xmlMapper.readTree(xmlStream);

    // 2. 定位目标节点并提取 lexicalValue 文本
    JsonNode dateNode = rootNode.get("dateIssuedField");
    if (dateNode != null && dateNode.isObject()) {
        String lexicalText = ((ObjectNode) dateNode).path("lexicalValue").textValue();

        // 3. 替换原节点：用纯文本节点替代整个对象节点
        rootNode.replace("dateIssuedField", new TextNode(lexicalText));
    }

    // 4. 序列化为标准 JSON 字符串
    String jsonOutput = jsonMapper.writeValueAsString(rootNode);
    System.out.println(jsonOutput);
    // 输出: {"dateIssuedField":"0001-01-01T00:00:00"}
} catch (IOException e) {
    throw new RuntimeException("XML to JSON conversion failed", e);
}

⚠️ 注意事项：

path("lexicalValue") 比 get("lexicalValue") 更安全（避免 NullPointerException）；

若 XML 中存在多个同类节点（如多个），需改用 forEach 或 iterator() 遍历处理；

此方案完全绕过 Java 类绑定，不依赖 @JsonIgnore 或 MixIn，适用于无源码、无 Schema 的黑盒 XML。

? 备选方案：移除属性 + 保留对象结构（仅当必须维持对象形态时）

若因历史兼容性要求必须保留 { "dateIssuedField": { "0001-01-01T00:00:00": null } } 这类非标准结构（注意：严格来说这不是有效 JSON 值，而是键值对），可手动清理属性并重写节点：

ObjectNode dateNode = (ObjectNode) rootNode.get("dateIssuedField");
if (dateNode != null) {
    // 移除所有属性（仅保留子元素）
    dateNode.remove("class");
    dateNode.remove("resolves-to");

    // 提取 lexicalValue 并构建新键值对
    String value = dateNode.path("lexicalValue").textValue();
    dateNode.removeAll(); // 清空原内容
    dateNode.put(value, (String) null); // 设置为 null 值（JSON 允许）
}

? 最佳实践建议

优先采用字符串映射（方案一）：语义清晰、体积最小、兼容性最强；
避免“属性忽略”幻觉：Jackson 的 XmlMapper 无法像 @JacksonXmlProperty(isAttribute = false) 那样声明式过滤，树模型后处理是可靠路径；
批量处理场景：可封装通用方法，递归遍历 ObjectNode，对匹配 XPath（如 *[*]/lexicalValue）的节点自动执行提取；
性能考量：对于超大 XML（>10MB），建议结合 XmlStreamReader 流式解析，而非全量加载为树；但对于常规配置/元数据 XML，readTree() 简洁高效。

通过上述方式，你无需生成任何 Java 类、无需修改原始 XML、也无需引入额外依赖，即可稳健地将“带毒属性”的 XML 转化为干净、标准、可交付的 JSON。