代码驿站移动版

当前位置：主页 > 软件编程 > JAVA代码 >

关于Java中XML Namespace 命名空间问题

时间：2023-01-06 09:04:06 | 栏目：JAVA代码 | 点击：次

根据Namespaces in XML W3C 推荐标准的定义，XML命名空间是由国际化资源标识符 (IRI) 标识的 XML 元素和属性集合；该集合通常称作 XML“词汇”。

定义 XML 命名空间的主要动机之一是在使用和重用多个词汇时避免名称冲突。XML 模式用于为 XML 实例创建一个词汇并频繁使用命名空间。因此，正确理解命名空间概念对于从总体上理解 XML 模式和实例验证至关重要。

命名空间在多个方面类似于 Java 中的程序包：

因此，可以看出 XML 概念中的命名空间与 Java 中的程序包并无多大区别。这种对比旨在简化对 XML 中命名空间的了解，并帮助您直观认识命名空间的概念。

在本文中，您将了解：

声明和应用命名空间

命名空间被声明为元素的属性。并不一定只在根元素声明命名空间；而是可以在 XML 文档中的任何元素中进行声明。声明的命名空间的范围起始于声明该命名空间的元素，并应用于该元素的所有内容，直到被具有相同前缀名称的其他命名空间声明覆盖―其中，元素内容是指该元素的 <opening-tag> 和 </closing-tag> 之间的内容。命名空间声明如下：

<someElement xmlns:pfx="http://www.foo.com" />

在属性xmlns:pfx 中，xmlns类似于一个保留字，它只用于声明命名空间。换言之，xmlns用于绑定命名空间，但其本身并不绑定到任何命名空间。因此，以上示例实际上是将前缀“pfx”与命名空间“http://www.foo.com”绑定在一起。

通常将 XSD 或 XS 用作 XML 模式命名空间的前缀，但具体使用什么前缀完全取决于个人。您可以选择将前缀 ABC 用于 XML 模式命名空间，这是合法的，但没有什么意义。使用有意义的命名空间前缀增强了 XML 文档的清晰性。请注意，前缀只用作占位符，并且必须通过可以识别命名空间的 XML 分析器进行解释才能使用绑定到该前缀的实际命名空间。在 Java 类比中，命名空间绑定可以比作声明一个变量，并且每当引用该变量时，它将被所赋与的值替换。

在上一个命名空间声明示例中，每当在命名空间范围中引用前缀“pfx”时，它将被解释为绑定到实际的命名空间 (http://www.foo.com)：

在 Java 中：Stringpfx = "http://www.library.com"

在 XML 中：<someElementxmlns:pfx="http://www.foo.com"/>

尽管命名空间通常看上去像 URL，但这并不意味着实际声明和使用命名空间时一定要连接到互联网上。实际上，通常将命名空间用作可以在互连网空间中共享词汇和不显示内容的虚拟“容器”。在互连网空间中，URL 是唯一的―因此，您通常选择使用 URL 来唯一标识命名空间。在浏览器中键入命名空间 URL 并不意味着它将显示该命名空间中的所有元素和属性；它只是一个概念。

但这里存在一种误解：尽管 Namespaces in XML W3C 推荐标准声明该命名空间名称应为 IRI，但它对此并无强制规定。因此，我还可以使用以下代码：

<someElement xmlns:pfx=" foo" />

该代码完全合法。

至此应明了，要使用命名空间，首先应使用前缀绑定将其绑定，然后在需要时使用该前缀。但为什么不能从一开始便使用命名空间限定元素或属性呢？首先，由于命名空间（作为 IRI）非常长，因此毫无疑问会使 XML 文档杂乱不堪。第二，也是最重要的，它可能对语法造成严重影响，或者具体一点说，可能对 XML 的生产规则造成严重影响―原因是 IRI 可能包含XML 1.0 W3C 推荐标准不允许在 XML 标记中使用的字符。

无效) <http://www.library.com:Book />
有效) <lib:Book xmlns:lib="http://www.library.com" />

下面的元素 Title 和 Author 与命名空间http://www.library.com关联：

<?xml version="1.0"?>
<Book xmlns:lib="http://www.library.com">
    <lib:Title>Sherlock Holmes</lib:Title>
    <lib:Author>Arthur Conan Doyle</lib:Author>
</Book>

在下面的示例中，Sherlock Holmes - III和Sherlock Holmes - I的元素Title和Author与命名空间http://www.library.com关联，Sherlock Holmes - II的元素Title和Author与命名空间http://www.otherlibrary.com关联。

<?xml version="1.0"?>
<Book xmlns:lib="http://www.library.com">
    <lib:Title>Sherlock Holmes - I</lib:Title>
    <lib:Author>Arthur Conan Doyle</lib:Author>
    <purchase xmlns:lib="http://www.otherlibrary.com">
        <lib:Title>Sherlock Holmes - II</lib:Title>
        <lib:Author>Arthur Conan Doyle</lib:Author>
    </purchase>
    <lib:Title>Sherlock Holmes - III</lib:Title>
    <lib:Author>Arthur Conan Doyle</lib:Author>
</Book>

Namespaces in XML W3C 推荐标准规定了某些命名空间约束：

以三字母序列x、m和l（采用任何大小写组合）开头的前缀被保留，供 XML 和 XML 相关的规范使用。尽管这不是一个严重错误，但绑定此类前缀并不可取。前缀xml根据定义绑定到命名空间名称http://www.w3.org/XML/1998/namespace。只有已声明并绑定到命名空间的前缀才能使用。（是否曾经试过在 Java 中使用没有声明的变量？）

以下代码违反了这些约束：

<?xml version="1.0"?>
<Book xmlns:XmlLibrary="http://www.library.com">
    <lib:Title>Sherlock Holmes - I</lib:Title>
    <lib:Author>Arthur Conan Doyle</lib:Author>
</Book>

[错误]：前缀 lib 未绑定到命名空间。
[不可取]：前缀 XmlLibrary 以“Xml”开头。

单个默认命名空间（而非多个默认命名空间）

重复限定一个要在命名空间中使用的元素或属性可能会非常麻烦。这种情况下，可以声明一个 {默认命名空间}。记住，无论在任何时候都只能存在一个 {默认命名空间}。因此，术语“多个默认命名空间”在实际上是不正确的。

声明一个 {默认命名空间} 意味着，如果 {默认命名空间} 声明范围内的任何元素未使用前缀显式限定，则该元素将被隐式限定。与带前缀的命名空间一样，{默认命名空间} 也可以被覆盖。{默认命名空间} 声明如下：

<someElement xmlns="http://www.foo.com"/>
<?xml version="1.0"?>
<Book xmlns="http://www.library.com">
    <Title>Sherlock Holmes</Title>
    <Author>Arthur Conan Doyle</Author>
</Book>

这种情况下，元素Book、Title和Author与命名空间http://www.library.com关联。

记住，命名空间的范围起始于声明该命名空间的元素。因此，元素 Book 还与 {默认命名空间}关联，这是因为它没有前缀。

<?xml version="1.0"?>
<Book xmlns="http://www.library.com">
    <Title>Sherlock Holmes - I</Title>
    <Author>Arthur Conan Doyle</Author>
    <purchase xmlns="http://www.otherlibrary.com">
        <Title>Sherlock Holmes - II</Title>
        <Author>Arthur Conan Doyle</Author>
    </purchase>
    <Title>Sherlock Holmes - III</Title>
    <Author>Arthur Conan Doyle</Author>
</Book>

在以上的示例中，Sherlock Holmes - III和Sherlock Holmes - I的元素Book、Title和Author与命名空间http://www.library.com关联，Sherlock Holmes - II的元素 purchase、Title和Author与命名空间http://www.otherlibrary.com关联。

默认命名空间和属性

默认命名空间不应用于属性；因此，要将命名空间应用于属性，必须显式限定该属性。此处的属性isbn{没有命名空间}，而属性cover与命名空间http://www.library.com关联。

<?xml version="1.0"?>
<Book isbn="1234"
      pfx:cover="hard"
      xmlns="http://www.library.com"
      xmlns:pfx="http://www.library.com">
    <Title>Sherlock Holmes</Title>
    <Author>Arthur Conan Doyle</Author>
</Book>

取消声明命名空间

Namespaces in XML 1.0 W3C 推荐标准不允许取消绑定已经绑定的前缀，而 Namespaces in XML 1.1 W3C 推荐标准则允许这样做。1.0 没有理由不允许取消绑定，不过该错误已经在 1.1 中得到修正。不必知道此差别，这是因为支持 Namespaces in XML 1.1 的 XML 分析器并不多。

尽管取消绑定带前缀的命名空间有一些差别，但这两个版本均允许您取消绑定或删除已声明的 {默认命名空间}：用其他 {默认命名空间} 声明（覆盖声明中的命名空间为空）覆盖已声明的 {默认命名空间}。取消绑定命名空间与未声明命名空间具有同样的效果。此处的Sherlock Holmes - III和Sherlock Holmes - I的元素Book、Title和Author与命名空间http://www.library.com关联，而Sherlock Holmes - II的元素 purchase、Title和Author{没有命名空间}：

<someElement xmlns="" />
<?xml version="1.0"?>
<Book xmlns="http://www.library.com">
    <Title>Sherlock Holmes - I</Title>
    <Author>Arthur Conan Doyle</Author>
    <purchase xmlns="">
        <Title>Sherlock Holmes - II</Title>
        <Author>Arthur Conan Doyle</Author>
    </purchase>
    <Title>Sherlock Holmes - III</Title>
    <Author>Arthur Conan Doyle</Author>
</Book>

此处是根据 XML 1.0 规范中的命名空间取消绑定前缀的无效示例，而根据 XML 1.1 中的命名空间取消绑定前缀则是有效的：

<purchase xmlns:lib="">

从此处开始，前缀lib不能在 XML 文档中使用，因为只要您在元素purchase的范围内，它就保持未声名状态。当然，您完全可以再次定义它。

无名称空间

如果范围中没有默认命名空间，便不存在命名空间。{默认命名空间} 是使用xmlns显式声明的命名空间。如果未使用xmlns声明 {默认命名空间}，则不能说元素位于 {默认命名空间} 中。这种情况下，我们可以说元素位于 {无命名空间} 中。当已声明的 {默认命名空间} 被取消声明时，也将应用 {无命名空间}。

摘要：

命名空间和 XML 模式

到目前为止，我们已经了解了如何声明和使用现有命名空间。现在，让我们了解如何创建一个新命名空间，并使用 XML 模式将元素和属性添加到其中。

XML 模式首先是一个 XML。换言之，同任何其他 XML 文档一样，XML 模式使用元素和属性构建。此“构建材料”必须出自命名空间http://www.w3.org/2001/XMLSchema，它是已声明和保留的命名空间，其中包含W3C XML 模式结构规范和W3C XML 模式数据类型规范中定义的元素和属性。不应将元素或属性添加到该命名空间。

使用这些构建块，可以根据需要创建新元素和属性，并对这些元素和属性附加所需的约束，并将其保留在某个命名空间中。（请参见图 1。）XML 模式将此特殊命名空间称作 {目标命名空间}，即新建的元素和属性将驻留到的命名空间。

图 1：XML 模式命名空间中的元素和属性用于编写 XML 模式文档，

该文档生成由用户定义的元素和属性并将其置于 {目标命名空间} 中。

此 {目标命名空间} 随后用于验证 XML 实例。

此 {目标命名空间} 从 XML 实例中引用，以确保实例文档的有效性。（请参见图 2。）在验证过程中，验证器验证实例中所用的元素/属性是否存在于已声明的命名空间中，并检查是否对其结构和数据类型存在其他约束。

图 2：从 XML 模式到 XML 模式实例

限定或未限定

在 XML 模式中，我们可以选择指定实例文档是必须限定所有元素和属性，还是只限定全局声明的元素和属性。无论做出什么样的选择，都将验证整个实例。那么，我们为什么有两个选择呢？

答案是“可管理性”。当我们选择限定时，我们指定实例中的所有元素和属性都必须有一个命名空间，这将增强实例的命名空间复杂性。比如，当因将某些局部声明变为全局声明和/将某些全局声明变为局部声明而修改了模式时，根本不会影响实例文档。相反，如果选择非限定，则指定只有实例中全局声明的元素和属性才必须具有命名空间，从而隐藏实例的命名空间复杂性。但在此情形下，比如，当因将某些局部声明变为全局声明和/将某些全局声明变为局部声明而修改了模式时，将影响所有实例文档 ― 且实例不再有效。如果试图根据已修改的 XML 模式验证该实例，则 XML 模式验证器将报告验证错误。因此，必须根据 XML 模式中所作的修改修正命名空间，才能重新使该实例有效。

<?xml version="1.0" encoding="US-ASCII"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
        xmlns:tns="http://www.library.com"
        targetNamespace="http://www.library.com"
        elementFormDefault="qualified">
    attributeFormDefault="unqualified">
    <element name="Book" type="tns:BookType" />
    <complexType name="BookType">
        <sequence>
            <element name="Title" type="string" />
            <element name="Author" type="string" />
        </sequence>
    </complexType>
</schema>

元素<schema>的最近子元素为全局声明，而其他元素则为局部声明。在以上示例中，Book和BookType被全局声明，而Title和Author则被局部声明。

可以通过将模式元素属性elementFormDefault和attributeFormDefault设置为qualified或unqualified 表示在限定和非限定之间的选择。

elementFormDefault   = (qualified | unqualified) :unqualified
attributeFormDefault = (qualified | unqualified) :unqualified

当将elementFormDefault设置为qualified时，它表示在该语法的实例中，必须使用前缀或通过设置 {默认命名空间} 来显式限定所有元素。unqualified设置意味着只有全局声明的元素才必须被显式限定，而局部声明的元素不得被限定。在此情形下，限定一个局部声明是错误的。同样，将attributeFormDefault设置为qualified时，必须使用前缀显式限定实例文档中的所有属性。

注意，{默认命名空间} 不应用于属性；因此，不能使用 {默认命名空间} 声明限定属性。Unqualified好像暗示通过包含的元素位于命名空间中。这很有趣，对吧？

在下图中，概念符号空间类似于命名空间分区的非规范性概念。例如，如果将命名空间比作电冰箱，那么符号空间就是冰箱中的架子。就像架子对电冰箱中的整个空间进行分区一样，符号空间对命名空间进行分区。

命名空间中有三个主要分区：一个用于全局元素声明，一个用于全局属性声明，一个用于全局类型声明 (complexType/simpleType)。这种安排表示，全局元素、全局属性和全局类型可以具有相同的名称，并可以在{目标命名空间}中共存而不发生任何名称冲突。此外，每个全局元素和全局 complexType 拥有其自己的符号空间来包含局部声明。

让我们来看看属性对elementFormDefault和attributeFormDefault的四种可能的值组合。

情形 1：elementFormDefault=qualified, attributeFormDefault=qualified

此处，{目标命名空间} 直接包含所有元素和属性；因此在该情形中，必须限定所有元素和属性。

情形 2：elementFormDefault=qualified, attributeFormDefault=unqualified

此处，{目标命名空间} 直接包含所有元素，且这些元素的相应属性包含在相应元素的符号空间中。因此，在该情形中，只须限定元素，而不得限定属性，除非属性是全局声明的。

情形 3：elementFormDefault=unqualified, attributeFormDefault=qualified

此处，{目标命名空间} 直接包含所有属性和仅全局声明的元素，同时这些元素在其符号空间中包含其子元素。因此，在该情形中，只虚限定全局声明的元素和所有属性。

情形 4：elementFormDefault=unqualified, attributeFormDefault=unqualified

此处，{目标命名空间} 直接包含仅在全局声明的元素，同时这些元素在其符号空间中包含其子元素。每个元素在其符号空间中包含相应的属性；因此，在该情形中，只需限定仅在全局声明的元素和属性。

以上各图用于直观说明命名空间内直接包含的内容或传递式包含的内容（取决于elementFormDefault/attributeFormDefault的值）。该设置表示直接位于{目标命名空间}中的元素/属性必须在相应的 XML 实例中拥有一个与其关联的命名空间，而未直接（传递式）位于{目标命名空间}中的元素/属性不得在相应的 XML 实例中拥有一个与其关联的命名空间。

目标命名空间和无目标命名空间

现在，我们知道 XML 模式创建新元素和属性并将其置于称作 {目标命名空间} 的命名空间中。但如果在该模式中未指定 {目标命名空间} 又会怎么样？如果未指定属性targetNamespace，则将不存在 {目标命名空间} ― 这是合法的 ―但在targetNamespace属性中指定一个空 URI 则是“非法”的。

例如，以下代码无效。不能为 {目标命名空间} 指定一个空 URI：

<schematargetNamespace="". . .>

在此情形中，如果不存在 {目标命名空间}，则如前所述，则将新建的元素和属性保存在 {无命名空间} 中。（使用术语 {默认命名空间} 是错误的。）要验证相应的 XML 实例，相应的 XML 实例必须使用http://www.w3.org/2001/XMLSchema-instance命名空间中的noNamespaceSchemaLocation属性来引用没有目标命名空间的 XML 模式。

结论

衷心希望此命名空间概述能够帮助您更轻松地迁移到 XML 模式。Oracle XML 开发人员工具包 (XDK) Namespaces in the XML 1.0 W3C 推荐标准中的 W3C 命名空间；您可以通过使用SAXParserFactory和DocumentBuilderFactory类中的setNamespaceAware(boolean)方法打开/关闭命名空间检查（使用 Oracle XDK 中的 JAXP API）。

参考：XML 模式：了解命名空间 http://www.oracle.com/technetwork/cn/articles/srivastava-namespaces-098626-zhs.html

您可能感兴趣的文章:

相关文章