elementFormDefault 在 XSD 中做什么？

Question

elementFormDefault 有什么作用，什么时候应该使用它？

所以我找到了 elementFormDefault 值的一些定义：

限定 - 元素和属性 位于的 targetNamespace 中 架构

不合格 - 元素和 属性没有命名空间

因此，根据该定义，我认为如果将模式设置为限定，那么为什么必须在类型前面加上命名空间？在什么情况下你甚至会认为他们不合格？我尝试用谷歌搜索，但得到的只是几个非常难以理解的 W3C 页面。

这是我现在正在使用的文件，为什么当我将 targetNamespace 声明为与 相同时，我需要将类型声明为 target:TypeAssignments xmlns:目标？

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
        xmlns:target="http://www.levijackson.net/web340/ns"
        targetNamespace="http://www.levijackson.net/web340/ns" 
        elementFormDefault="qualified">
  <element name="assignments">
    <complexType>
      <sequence>
        <element name="assignments" type="target:TypeAssignments"
                 minOccurs="1" maxOccurs="unbounded"/>
      </sequence>
    </complexType>
  </element>
  <complexType name="TypeAssignments">
    <sequence>
      <element name="assignment" type="target:assignmentInfo"
               minOccurs="0" maxOccurs="unbounded"/>
    </sequence>
  </complexType>
  <complexType name="assignmentInfo">
    <sequence>
      <element name="name" type="string"/>
      <element name="page" type="target:TypePage"/>
      <element name="file" type="target:TypeFile" 
               minOccurs="0" maxOccurs="unbounded"/>
    </sequence>
    <attribute name="id" type="string" use="required"/>
  </complexType>
  <simpleType name="TypePage">
    <restriction base="integer">
      <minInclusive value="50" />
      <maxInclusive value="498" />
    </restriction>
  </simpleType>
  <simpleType name="TypeFile">
    <restriction base="string">
      <enumeration value=".xml" />
      <enumeration value=".dtd" />
      <enumeration value=".xsd" />
    </restriction>
  </simpleType>
</schema>

Answer 1

ElementFormDefault 与模式中类型的名称空间无关，它与 XML 文档中符合模式的元素的名称空间有关。

这是规范的相关部分：

元素声明架构

组件属性{目标命名空间}
表示 如果存在形式并且其“实际价值”是合格的， 
                    或者如果形式不存在并且“实际价值” 
                     上的 elementFormDefault祖先有资格， 
                    那么 targetNamespace [属性] 的“实际值”
                    父的元素信息项，或 
                    如果没有则“缺席”，否则“缺席”。

这意味着，如果 elementFormDefault 为“qualified”，或者该元素在架构中显式声明为具有 form="qualified"，则您在架构顶部声明的 targetNamespace 仅适用于符合架构的 XML 文档中的元素。

例如：如果 elementFormDefault 未限定 -

<element name="name" type="string" form="qualified"></element>
<element name="page" type="target:TypePage"></element>

将期望“name”元素位于 targetNamespace 中，而“page”元素位于 null 命名空间中。

为了避免您必须在每个元素声明上放置 form="qualified"，声明 elementFormDefault="qualified" 意味着 targetNamespace 适用于每个元素，除非通过在元素声明上放置 form="unqualified" 来覆盖。

Answer 2

_{对旧的常见问题的新的详细答案和解释...}

简短答案：如果您不添加 elementFormDefault ="qualified" 到 xsd:schema，那么默认的 unqualified 值意味着本地声明的元素没有命名空间。

关于 elementFormDefault 的作用存在很多困惑，但这可以通过一个简短的示例快速澄清...

XSD 的简化版本：

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
        xmlns:target="http://www.levijackson.net/web340/ns"
        targetNamespace="http://www.levijackson.net/web340/ns">
  <element name="assignments">
    <complexType>
      <sequence>
        <element name="assignment" type="target:assignmentInfo" 
                 minOccurs="1" maxOccurs="unbounded"/>
      </sequence>
    </complexType>
  </element>
  <complexType name="assignmentInfo">
    <sequence>
      <element name="name" type="string"/>
    </sequence>
    <attribute name="id" type="string" use="required"/>
  </complexType>
</schema>

要点：

• 赋值 元素是本地定义的。
• 默认情况下，XSD 中本地定义的元素不在命名空间中。
  • 这是因为 elementFormDefault 的默认值为 unqualified。
  • 这可以说是 XSD 创建者的设计错误。
  • 标准做法是始终使用 elementFormDefault="qualified"
    这样赋值就位于目标命名空间中
    期待。
• 它是 xs:element 声明中很少使用的 form 属性，elementFormDefault 为其建立默认值。

看似有效的 XML

根据上述 XSD，此 XML 看起来应该是有效的：

<assignments xmlns="http://www.levijackson.net/web340/ns"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://www.levijackson.net/web340/ns try.xsd">
  <assignment id="a1">
    <name>John</name>
  </assignment>
</assignments>

注意：

• 赋值 上的默认命名空间放置 赋值 以及所有它的后代在默认命名空间 (http://www.levijackson.net/web340/ns) 中。

令人困惑的验证错误

尽管上面的 XML 看起来有效，但它会产生以下令人困惑的验证错误：

[错误] try.xml:4:23: cvc-complex-type.2.4.a: 内容无效
发现以元素“赋值”开头。 “{赋值}”之一是
预计。

注释：

• 您不会是第一个诅咒此诊断的开发人员，该诊断似乎表明内容无效，因为它期望找到 赋值 元素，但实际上它找到了一个赋值元素。（WTF）
• 这真正意味着什么：{和}周围赋值意味着验证需要赋值在没有命名空间这里。不幸的是，当它说它找到了一个 assignment 元素时，它没有提到它在默认命名空间中找到了它，这与没有命名空间不同。

解决方案

• 大多数情况下：将 elementFormDefault="qualified" 添加到 XSD 的 xsd:schema 元素。这意味着在 XSD 中本地声明时，有效的 XML 必须将元素放置在目标命名空间中；否则，有效的 XML 必须将本地声明的元素放置在任何名称空间中。
• 极少数人：更改 XML 以符合 XSD
  要求赋值不在命名空间中。这是可以实现的，
  例如，通过将 xmlns="" 添加到 assignment 元素。

---

_{鸣谢：感谢Michael Kay对此答案提供的有用反馈。< /子>}

Answer 3

考虑 author 元素使用以下 ComplexType AuthorType

<xsd:complexType name="AuthorType">
  <!-- compositor goes here -->
  <xsd:sequence>
     <xsd:element name="name" type="xsd:string"/>
     <xsd:element name="phone" type="tns:Phone"/>
  </xsd:sequence>
  <xsd:attribute name="id" type="tns:AuthorId"/>
</xsd:complexType>
<xsd:element name="author" type="tns:AuthorType"/>

如果 elementFormDefault="unqualified"

则以下 XML 实例有效，

<x:author xmlns:x="http://example.org/publishing">
   <name>Aaron Skonnard</name>
   <phone>(801)390-4552</phone>
</x:author>

允许作者的 name 属性，无需指定命名空间（非限定）。属于 一部分的任何元素都被视为复杂类型的本地元素。

如果 elementFormDefault="qualified"

则实例应具有合格的本地元素，

<x:author xmlns:x="http://example.org/publishing">
   <x:name>Aaron Skonnard</name>
   <x:phone>(801)390-4552</phone>
</x:author>

请参阅 此链接了解更多详情

Answer 4

elementFormDefault 需要注意的重要一点是，它适用于本地定义的元素，通常是在complexType 块内命名的元素，而不是在架构顶层定义的全局元素。通过 elementFormDefault="qualified"，您可以使用架构的目标命名空间作为文档的默认命名空间，从 xml 文档中寻址架构中的本地元素。

在实践中，使用 elementFormDefault="qualified" 能够在嵌套块中声明元素，否则您必须在顶层声明所有元素，并使用 ref 属性在嵌套元素的架构中引用它们，从而导致更不紧凑的模式。

XML Schema Primer 中的这一点讨论了它：http://www.w3.org/TR/xmlschema- 0/#NS

Answer 5

elementFormDefault="qualified" 用于控制 XML 实例文档（.xml 文件）中命名空间的使用，而不是架构文档本身（.xsd 文件）中命名空间的使用。

通过指定 elementFormDefault="qualified"，我们强制在使用此模式验证的文档中使用命名空间声明。

通常的做法是指定此值来声明元素应该是限定的而不是不限定的。但是，由于 attributeFormDefault="unqualified" 是默认值，因此如果不想限定命名空间，则无需在架构文档中指定它。

Answer 6

我注意到，如果使用 elementFormDefault="qualified"，XMLSpy（至少 2011 版本）需要定义一个 targetNameSpace。否则不会验证。并且也不会生成带有命名空间前缀的 xml