如何使用 Jackson 正确反序列化含属性与文本内容的 XML 子节点_网络技术

如何使用 Jackson 正确反序列化含属性与文本内容的 XML 子节点

发布时间 - 2026-01-29 00:00:00 点击率：次

本文详解如何通过 jackson 的 `@jacksonxmltext` 注解，准确解析同时包含属性（如 `os="ios"`）和文本值（如 `13`）的 xml 元素，解决因忽略文本内容导致 pojo 字段为空的问题。

在使用 Jackson 的 XmlMapper 进行 XML 反序列化时，若目标 XML 节点既携带属性（attribute），又内嵌文本内容（text content），默认情况下 Jackson 不会自动将文本映射到 Java 字段——这正是问题的核心：13 中的 "13" 无法被 Iphone.iphone 字段捕获，除非显式声明其为“文本内容”。

✅ 正确做法：使用 @JacksonXmlText

@JacksonXmlText 是 Jackson XML 模块专用注解，用于标识某个字段应接收该 XML 元素的字符内容（即 element body text），与 @JacksonXmlProperty（处理属性）或 @JacksonXmlElementWrapper（处理集合包装）等协同工作。

以下是修正后的完整 POJO 定义：

import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlProperty;
import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlText;
import lombok.Data;

@Data
public class PhoneDetails {
    @JacksonXmlProperty(localName = "Iphone")
    private Iphone iphoneDetails;
}

@Data
public class Iphone {
    @JacksonXmlProperty(localName = "os") // 映射属性 os="ios"
    private String os;

    @JacksonXmlText // ✅ 关键：映射 ... 中的纯文本 "13"
    private String iphone;
}

? 示例反序列化代码（精简可靠）

import com.fasterxml.jackson.dataformat.xml.XmlMapper;
import java.io.IOException;

public class Demo {
    public static void main(String[] args) throws IOException {
        XmlMapper xmlMapper = new XmlMapper();
        // 推荐关闭未知属性报错（可选，提升健壮性）
        xmlMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);

        String xml = "13";
        PhoneDetails result = xmlMapper.readValue(xml, PhoneDetails.class);

        System.out.println(result);
        // 输出：PhoneDetails(iphoneDetails=Iphone(os=ios, iphone=13))
    }
}

⚠️ 注意事项与常见误区

❌ 不要省略 @JacksonXmlText：仅靠 @JacksonXmlProperty 或无注解无法捕获文本内容；
✅ 属性与文本可共存：一个 XML 元素可同时拥有多个属性（用 @JacksonXmlProperty 分别标注）和唯一一段文本（由 @JacksonXmlText 标注）；
? 文本字段类型需为 String（或其他支持的标量类型，如 Integer、Boolean；Jackson 会自动转换）；

? 确保已引入 Jackson XML 依赖（Maven）：


    com.fasterxml.jackson.dataformat
    jackson-dataformat-xml
    2.17.0

✅ 总结

当 XML 元素形如 text 时，必须通过 @JacksonXmlText 显式标注接收 text 的字段，才能完成完整反序列化。这是 Jackson XML 处理混合内容（attributes + text）的标准且唯一推荐方式。正确使用该注解后，结构清晰、类型安全、无需手动解析字符串，大幅提升 XML 数据集成效率与可靠性。

# java # app # iphone # ai # ios # maven # String # Integer # Boolean # xml # 字符串 # Attribute # 序列化 # 这是 # 多个 # 或其他 # 可选 # 报错 # 唯一一 # 其为 # 为空 # 内嵌

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：综合素质评价系统登录网址综合素质评价官网入口说明

下一篇：Excel动态图表如何制作_Excel自动更新图表详细教程

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：综合素质评价系统登录网址综合素质评价官网入口说明

下一篇：Excel动态图表如何制作_Excel自动更新图表详细教程