如何使用 dom4j 添加默认名称空间？

Question

我想使用 dom4j 为 XML 文档的根元素添加一个默认名称空间，如下面的 sn-p 所示。使用 dom4j 执行此操作的正确方法是什么？

<?xml version="1.0" encoding="utf-8" ?>
<animals xmlns="http://zoo.domain.org/schema/animals" >
    <animal id="1">
        <elephant>
            <name>Jumbo</name>
        </elephant>
    </animal>
</animals>

dom4j API 确实提供了 Element#addNamespace 方法，但 javadoc 告诉该前缀不能为空。 以下代码将生成 animals 的预期命名空间：

Document document = DocumentHelper.createDocument();
Element animals = document.addElement("animals")
        .addNamespace("", "http://zoo.domain.org/schema/animals");
Element animal = animals.addElement("animal")
        .addAttribute("id", "1");
animal.addElement("elephant")
        .addElement("name")
        .addText("Jumbo");

// write document to file etc.
...

...但是子元素animal 得到一个空字符串作为默认命名空间，这不是我想要的：

<?xml version="1.0" encoding="UTF-8"?>
<animals xmlns="http://zoo.domain.org/schema/animals">
    <animal xmlns="" id="1">
        <elephant>
            <name>Jumbo</name>
        </elephant>
    </animal>
</animals>

Answer 1

方法Document#addElement（也包括Element#addElement）接受第二个参数namespaceURI。这样就行了，将默认命名空间添加到 XML 元素。

以下代码将生成预期的 XML。

Document document = DocumentHelper.createDocument();
Element animals = document.addElement("animals", "http://zoo.domain.org/schema/animals");
Element animal = animals.addElement("animal")
        .addAttribute("id", "1");
animal.addElement("elephant")
        .addElement("name")
        .addText("Jumbo");

// write document to file etc.
...

另外值得一提的是，如果您想自己创建一个元素，DocumentFactory#createElement 有一个重载版本，它也接受namespaceURI。 DocumentHelper#createElement 没有这样的重载方法。

Answer 2

您不是在创建文档（根）元素。

Document document = DocumentHelper.createDocument();
Element root = document.addElement( "animals" );
// TODO the rest of your code

最终，您会将文档传递给 XML 编写器以编写（保存）文档。另外，来自 Javadoc：

元素addNamespace​（java.lang.String前缀，java.lang.String uri） 向此元素添加名称空间以供其子内容使用 参数： prefix - 是要使用的前缀，不应为空或空白

您可以尝试的一件事是创建Namespace 的实例，将空字符串传递给构造函数，然后改用Element.add() 方法。 Namespace的Javadoc并没有说明前缀不能为空。