如何在Java中控制XML命名空间声明位置（JAXB或其他方法）

我明白你想要的效果——让每个命名空间只在第一次用到它的元素上声明，而不是一股脑堆在根元素里。JAXB默认的行为确实会把所有用到的命名空间都集中在根元素，但我们有几种方法可以调整这个逻辑：

方法1：自定义NamespacePrefixMapper（适用于默认JAXB实现，比如GlassFish的jaxb-impl） #

JAXB的默认实现支持通过NamespacePrefixMapper来控制命名空间的声明策略。我们可以重写它的方法，告诉JAXB不要提前声明所有命名空间，而是在需要的时候再声明。

首先，创建自定义的映射器类：

import com.sun.xml.bind.marshaller.NamespacePrefixMapper;

public class CustomNamespaceMapper extends NamespacePrefixMapper {
    // 指定命名空间对应的前缀
    @Override
    public String getPreferredPrefix(String namespaceUri, String suggestion, boolean requirePrefix) {
        if ("http://www.example.com".equals(namespaceUri)) {
            return "abc";
        } else if ("http://www.example2.com".equals(namespaceUri)) {
            return "xyz";
        }
        return suggestion;
    }

    // 返回空数组，阻止JAXB在根元素提前声明所有命名空间
    @Override
    public String[] getContextualNamespaceDecls() {
        return new String[0];
    }
}

然后在编组的时候，把这个映射器设置给Marshaller：

JAXBContext jaxbContext = JAXBContext.newInstance(Defter.class, Xbrl.class);
Marshaller marshaller = jaxbContext.createMarshaller();

// 绑定自定义命名空间映射器
marshaller.setProperty("com.sun.xml.bind.namespacePrefixMapper", new CustomNamespaceMapper());
// 开启格式化输出，方便查看
marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true);

// 执行编组
marshaller.marshal(yourDefterObject, System.out);

注意：这个属性是Sun/Oracle系JAXB实现的专属属性，如果你用的是EclipseLink MOXy，属性名会变成org.eclipse.persistence.jaxb.MarshallerProperties.NAMESPACE_PREFIX_MAPPER。

方法2：使用EclipseLink MOXy的延迟声明特性（更灵活） #

如果你可以切换到MOXy作为JAXB的实现，它提供了更直接的配置来实现命名空间就近声明：

首先，在你的Xbrl类上添加@XmlNamespace注解：

import org.eclipse.persistence.oxm.annotations.XmlNamespace;
import javax.xml.bind.annotation.XmlRootElement;

@XmlRootElement(namespace = "http://www.example2.com")
@XmlNamespace(prefix = "xyz", namespaceURI = "http://www.example2.com")
public class Xbrl {
    // 你的类字段和方法
}

然后在编组时设置延迟声明的属性：

JAXBContext jaxbContext = JAXBContext.newInstance(Defter.class, Xbrl.class);
Marshaller marshaller = jaxbContext.createMarshaller();

marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true);
// 关键：开启延迟命名空间声明
marshaller.setProperty(org.eclipse.persistence.jaxb.MarshallerProperties.DELAY_NS_DECLARATION, true);

marshaller.marshal(yourDefterObject, System.out);

这种方法不需要自定义映射器，配置更简洁。

方法3：手动XML转换（无依赖限制） #

如果不想依赖特定的JAXB实现，你可以先正常编组XML，再用XSLT或者DOM操作来调整命名空间的声明位置。比如用XSLT转换：

编写XSLT样式表（命名为namespace-transform.xsl）：

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
    xmlns:abc="http://www.example.com" xmlns:xyz="http://www.example2.com">
    <xsl:output method="xml" indent="yes"/>

    <!-- 复制所有节点和属性 -->
    <xsl:template match="@*|node()">
        <xsl:copy>
            <xsl:apply-templates select="@*|node()"/>
        </xsl:copy>
    </xsl:template>

    <!-- 重新生成根元素，只保留abc命名空间 -->
    <xsl:template match="abc:defter">
        <abc:defter xmlns:abc="http://www.example.com">
            <xsl:apply-templates select="@*|node()"/>
        </abc:defter>
    </xsl:template>

    <!-- 重新生成xbrl元素，添加xyz命名空间 -->
    <xsl:template match="xyz:xbrl">
        <xyz:xbrl xmlns:xyz="http://www.example2.com">
            <xsl:apply-templates select="@*|node()"/>
        </xyz:xbrl>
    </xsl:template>
</xsl:stylesheet>

然后用Java代码执行转换：

// 先编组到DOM对象
DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();
dbf.setNamespaceAware(true);
Document doc = dbf.newDocumentBuilder().newDocument();

JAXBContext jaxbContext = JAXBContext.newInstance(Defter.class, Xbrl.class);
Marshaller marshaller = jaxbContext.createMarshaller();
marshaller.marshal(yourDefterObject, doc);

// 应用XSLT转换
TransformerFactory tf = TransformerFactory.newInstance();
Transformer transformer = tf.newTransformer(new StreamSource(new File("namespace-transform.xsl")));
transformer.transform(new DOMSource(doc), new StreamResult(System.out));

这种方法通用性强，但需要额外的XML处理步骤。

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