JAXB 中 @XmlElementWrapper 生成空列表的解决方案

老婷小哥_2332

老婷小哥_2332

2026-10-28

498人浏览

原创

JAXB 中 @XmlElementWrapper 生成空列表的解决方案

使用 JAXB 解析带命名空间的 XML 时,若 @XmlElementWrapper 包裹的集合为空,通常是因为 @XmlElement 缺少对应命名空间声明,导致子元素无法正确匹配。

使用 jaxb 解析带命名空间的 xml 时,若 `@xmlelementwrapper` 包裹的集合为空,通常是因为 `@xmlelement` 缺少对应命名空间声明,导致子元素无法正确匹配。

在 Jakarta EE 9+(如 Spring Boot 3.x + Java 17)环境下,JAXB 已迁移至 jakarta.xml.bind 命名空间,且对 XML 命名空间(namespace)的匹配变得严格。你提供的 XML 示例中,根元素 和其子容器 均位于命名空间 my-secret-name-space 下,因此不仅 @XmlRootElement 和 @XmlElementWrapper 需指定该命名空间,其内部的 @XmlElement(name = "bar") 也必须显式声明相同的命名空间——否则 JAXB 在反序列化时将忽略所有 元素,最终导致 bars 列表为空。

✅ 正确配置如下(关键修改已加粗):

@Data
@XmlRootElement(name = "foo", namespace = "my-secret-name-space")
@XmlAccessorType(XmlAccessType.FIELD)
public class Foo {
    @XmlAttribute
    private String name;

    @XmlElementWrapper(name = "bars", namespace = "my-secret-name-space")
    @XmlElement(name = "bar", namespace = "my-secret-name-space") // ← 必须添加 namespace!
    private List<bar> bars;
}</bar>

同时确保 Bar 类支持命名空间感知(虽然 无子元素,但若未来扩展含命名空间子节点,建议显式标注):

@Data
@XmlAccessorType(XmlAccessType.NONE)
public class Bar {
    @XmlAttribute
    private String name;
}

⚠️ 注意事项:

  • @XmlElementWrapper 的 namespace 仅作用于包装元素 ,不自动继承给其子元素;每个 @XmlElement 必须独立声明 namespace。
  • 若 XML 使用默认命名空间(如 xmlns="my-secret-name-space"),JAXB 要求所有相关注解(@XmlRootElement、@XmlElementWrapper、@XmlElement)均需精确匹配该 URI,大小写与拼写必须一致。
  • 不推荐省略 namespace 参数来“绕过”命名空间检查——这会导致解析失败或静默丢弃元素,尤其在生产环境中难以调试。
  • 使用 JAXBContext.newInstance(Foo.class) 是正确做法,无需额外注册 Bar.class(因 Foo 已通过泛型引用 List,且 Bar 具备 JAXB 注解)。

? 验证技巧:可在反序列化后添加日志检查 foo.getBars() 是否为 null 或空列表,并启用 JAXB 调试日志(如设置 System.setProperty("com.sun.xml.bind.debug", "true"))辅助定位命名空间匹配问题。

遵循上述配置后, 中嵌套的两个 元素将被正确映射到 Foo.bars 列表中,彻底解决空集合问题。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

11417

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

8522

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

7352

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1224

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

988

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1456

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3009

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20271

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1315

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.1万人学习