JAXB 解析嵌套 XML 列表返回 null 的原因与解决方案-java教程-PHP中文网

JAXB 解析嵌套 XML 列表返回 null 的原因与解决方案

本文详解 JAXB 在处理带命名空间的嵌套 XML 元素（如下的列表）时返回 null 的根本原因，并提供基于 package-info.java 的标准、可靠解决方案。

本文详解 jaxb 在处理带命名空间的嵌套 xml 元素（如 `` 下的 `` 列表）时返回 null 的根本原因，并提供基于 `package-info.java` 的标准、可靠解决方案。

JAXB 默认对 XML 命名空间（namespace）极为敏感。当 XML 文档声明了默认命名空间（如 xmlns="http://rejestrymedyczne.ezdrowie.gov.pl/rpl/eksport-danych-v1.0"），所有未显式加前缀的元素均属于该命名空间。而若 Java 类未统一、正确地声明命名空间上下文，JAXB 解析器将无法匹配元素，导致 @XmlElement 绑定失败——最典型表现即 List 字段为 null，即使 XML 中存在对应结构。

核心问题在于：单个类上分散设置 namespace 属性（如 @XmlRootElement(namespace=...) 或 @XmlElement(namespace=...)）极易遗漏或不一致，尤其在嵌套层级较深时（如 produktyLecznicze → produktLeczniczy → opakowania → opakowanie），任一环节缺失命名空间声明都会中断绑定链。

✅ 正确做法是采用 包级命名空间声明，通过 package-info.java 统一定义整个包的默认命名空间行为：

// package-info.java（必须位于实体类所在包的根目录）
@jakarta.xml.bind.annotation.XmlSchema(
    namespace = "http://rejestrymedyczne.ezdrowie.gov.pl/rpl/eksport-danych-v1.0",
    elementFormDefault = XmlNsForm.QUALIFIED
)
package com.yourpackage.model;

import jakarta.xml.bind.annotation.XmlNsForm;

⚠️ 注意：elementFormDefault = XmlNsForm.QUALIFIED 表示所有局部元素（非顶层 @XmlRootElement）也需按命名空间限定解析——这正是匹配等嵌套元素的关键。

完成 package-info.java 后，重构 Java 类如下：

1. 根容器类 ProduktyLecznicze（仅保留 @XmlRootElement）：

135AI排版

一款AI办公效率工具，主要用于135AI排版，AI一键生成高颜值图文排版，适合需要提升相关任务效率的用户。

下载

@XmlAccessorType(XmlAccessType.FIELD)
@XmlRootElement // 不再指定 name 和 namespace，由 package-info 统一管理
public class ProduktyLecznicze {
    @XmlAttribute(name = "stanNaDzien")
    private String stanNaDzien;

    @XmlElement(name = "produktLeczniczy") // 名称匹配 XML，命名空间自动继承
    private List<produktleczniczy> produktyLecznicze;

    // getter/setter...
}</produktleczniczy>

2. 一级子元素 ProduktLeczniczy（移除 @XmlRootElement）：

@XmlAccessorType(XmlAccessType.FIELD)
public class ProduktLeczniczy { // ❌ 删除 @XmlRootElement
    @XmlAttribute(name = "nazwaProduktu") private String nazwaProduktu;
    @XmlAttribute(name = "id") private int id;

    // 关键：添加对嵌套集合的映射（示例：opakowania）
    @XmlElement(name = "opakowania")
    private Opakowania opakowania; // 或直接定义 List<opakowanie>（见下文）

    // getter/setter...
}</opakowanie>

3. 补全嵌套结构类（否则 opakowania 等仍为 null）：
仅声明 @XmlElement 不够，还需定义对应 Java 类。例如：

@XmlAccessorType(XmlAccessType.FIELD)
public class Opakowania {
    @XmlElement(name = "opakowanie")
    private List<opakowanie> opakowania;

    // getter/setter...
}

@XmlAccessorType(XmlAccessType.FIELD)
public class Opakowanie {
    @XmlAttribute(name = "wielkosc") private String wielkosc;
    @XmlAttribute(name = "kodEAN") private String kodEAN;
    @XmlAttribute(name = "id") private String id;
    // 其他属性...
}</opakowanie>

? 替代方案：若希望直接在 ProduktLeczniczy 中持有 List，可使用 @XmlElementWrapper + @XmlElement：
@XmlElementWrapper(name = "opakowania")
@XmlElement(name = "opakowanie")
private List<opakowanie> opakowania;</opakowanie>

最后，解组代码保持简洁：

JAXBContext context = JAXBContext.newInstance(ProduktyLecznicze.class);
Unmarshaller unmarshaller = context.createUnmarshaller();
ProduktyLecznicze result = (ProduktyLecznicze) unmarshaller.unmarshal(xmlFile);
// 此时 produktyLecznicze 和深层嵌套列表均不再为 null

? 总结关键点：