JAXB GlassFish生成xsi:nil=true时去除命名空间声明求助

你遇到的问题是GlassFish版JAXB会在带xsi:nil="true"的元素上自动添加xmlns:xsi声明，要解决这个问题，核心思路是提前在XML的根节点（或更高层级）统一声明xsi命名空间，让JAXB复用这个声明而不在子元素上重复生成。以下是具体实现步骤：

1. 扩展自定义NamespacePrefixMapper，添加xsi前缀映射 #

确保你的CustomNamespacePrefixMapper能识别xsi的命名空间，返回对应的前缀：

public class CustomNamespacePrefixMapper extends NamespacePrefixMapper {
    @Override
    public String getPreferredPrefix(String namespaceUri, String suggestion, boolean requirePrefix) {
        // 处理xsi命名空间
        if ("http://www.w3.org/2001/XMLSchema-instance".equals(namespaceUri)) {
            return "xsi";
        }
        // 处理你的fa命名空间（替换成实际的URI）
        if ("your-fa-namespace-actual-uri".equals(namespaceUri)) {
            return "fa";
        }
        // 其他命名空间映射按你的原有逻辑处理
        return suggestion;
    }
}

2. 在根节点层级声明xsi命名空间 #

有两种方式可以实现：

方式一：通过package-info.java统一配置所有命名空间

在你的根实体类所在的包下创建package-info.java，声明xsi和其他需要的命名空间：

@XmlSchema(
    xmlns = {
        @XmlNs(prefix = "xsi", namespaceURI = "http://www.w3.org/2001/XMLSchema-instance"),
        @XmlNs(prefix = "fa", namespaceURI = "your-fa-namespace-actual-uri")
    },
    elementFormDefault = XmlNsForm.QUALIFIED
)
package com.your.project.package; // 替换成实际包名

import javax.xml.bind.annotation.XmlNs;
import javax.xml.bind.annotation.XmlNsForm;
import javax.xml.bind.annotation.XmlSchema;

方式二：在Marshaller配置时主动绑定xsi命名空间

如果用switch-case处理不同的Marshaller，可以在对应分支中添加xsi命名空间的上下文：

// 初始化JAXBContext和Marshaller
JAXBContext jaxbContext = JAXBContext.newInstance(YourRootClass.class);
Marshaller marshaller = jaxbContext.createMarshaller();

// 设置自定义前缀映射器（GlassFish JAXB用这个属性名）
marshaller.setProperty("com.sun.xml.bind.namespacePrefixMapper", new CustomNamespacePrefixMapper());

// 主动触发根节点的xsi命名空间声明（可结合schema location，空字符串也能生效）
marshaller.setProperty(Marshaller.JAXB_SCHEMA_LOCATION, "");

3. 确保实体类字段的注解正确配置 #

在CreditorCustomerXml类中，给insertion字段正确标注@XmlElement的nillable属性：

public class CreditorCustomerXml {
    // 替换成实际的fa命名空间URI
    @XmlElement(namespace = "your-fa-namespace-actual-uri", nillable = true)
    private String insertion;

    // getter、setter方法
}

原理说明 #

JAXB在生成xsi:nil="true"时，会检查当前元素的祖先节点是否已经声明了xsi命名空间。如果没有，就会自动在该元素上添加xmlns:xsi声明。通过提前在根节点层级声明xsi命名空间，并让NamespacePrefixMapper正确映射前缀，JAXB就会复用已有的命名空间，不再在子元素上重复生成声明。

内容的提问来源于stack exchange，提问作者Lampie1978