XSD 指示器

  • 定义和使用

    我们可以控制将HOW元素用于带有指示器的文档中。
    有七个指示器
    顺序指标(Order Indicators):
    • All(所有)
    • Choice(选择)
    • Sequence(序列)
    出现指标(Occurrence indicators):
    • maxOccurs(最多次数)
    • minOccurs(少数)
    组指标(Group indicators):
    • Group name
    • attributeGroup name
  • Order 指示器

    All 指示器

    <all> 指示器指定子元素可以按任何顺序出现,并且每个子元素只能出现一次:
    <xs:element name="person">
      <xs:complexType>
        <xs:all>
          <xs:element name="firstname" type="xs:string"/>
          <xs:element name="lastname" type="xs:string"/>
        </xs:all>
      </xs:complexType>
    </xs:element>
    注意:使用 <all> 指示器时,可以将 <minOccurs> 指示器设置为 0 或 1,而 <maxOccurs> 指示器只能设置为 1(<minOccurs>和<maxOccurs>稍后描述)。

    Choice 指示器

    <choice> 指示器指定可以出现一个子元素或另一个子元素:
    <xs:element name="person">
      <xs:complexType>
        <xs:choice>
          <xs:element name="employee" type="employee"/>
          <xs:element name="member" type="member"/>
        </xs:choice>
      </xs:complexType>
    </xs:element>

    sequence 指示器

    <sequence> 指示器指定子元素必须以特定顺序出现:
    <xs:element name="person">
      <xs:complexType>
       <xs:sequence>
         <xs:element name="firstname" type="xs:string"/>
         <xs:element name="lastname" type="xs:string"/>
       </xs:sequence>
     </xs:complexType>
    </xs:element>
  • Occurrence 指示器

    Occurrence 指示器用于定义元素出现的频率。
    注意:对于所有 "Order" 和 "Group" 指示符(任何,所有,选择,序列,组名和组引用),maxOccurs 和 minOccurs 的默认值为 1。

    maxOccurs 指示器

    <maxOccurs > 指示器指定元素可以出现的最大次数:
    <xs:element name="person">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="full_name" type="xs:string"/>
          <xs:element name="child_name" type="xs:string" maxOccurs="10"/>
        </xs:sequence>
      </xs:complexType>
    </xs:element>
    上面的示例表明,"child_name" 元素在 "person" 元素中可以最少出现一次(minOccurs的默认值为1),最多可以出现十次。

    minOccurs 指示器

    <minOccurs> 指示器指定元素可以出现的最小次数:
    <xs:element name="person">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="full_name" type="xs:string"/>
          <xs:element name="child_name" type="xs:string"
          maxOccurs="10" minOccurs="0"/>
        </xs:sequence>
      </xs:complexType>
    </xs:element>
    上面的示例表明,"child_name" 元素在 "person" 元素中的出现次数最少为零,最多为十次。
    提示:要允许元素无限次出现,请使用 maxOccurs="unbounded" 语句:
    一个名为 "Myfamily.xml" 的 XML 文件:
    <?xml version="1.0" encoding="UTF-8"?>
    
    <persons xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="family.xsd">
    
    <person>
      <full_name>Hege Refsnes</full_name>
      <child_name>Cecilie</child_name>
    </person>
    
    <person>
      <full_name>Tove Refsnes</full_name>
      <child_name>Hege</child_name>
      <child_name>Stale</child_name>
      <child_name>Jim</child_name>
      <child_name>Borge</child_name>
    </person>
    
    <person>
      <full_name>Stale Refsnes</full_name>
    </person>
    
    </persons>
    上面的XML文件包含一个名为 "person" 的根元素。 在此根元素内,我们定义了三个 "person" 元素。 每个 "person" 元素必须包含一个 "full_name" 元素,并且最多可以包含五个 "child_name" 元素。
    这是模式文件 "family.xsd":
    <?xml version="1.0" encoding="UTF-8"?>
    <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
    elementFormDefault="qualified">
    
    <xs:element name="persons">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="person" maxOccurs="unbounded">
            <xs:complexType>
              <xs:sequence>
                <xs:element name="full_name" type="xs:string"/>
                <xs:element name="child_name" type="xs:string"
                minOccurs="0" maxOccurs="5"/>
              </xs:sequence>
            </xs:complexType>
          </xs:element>
        </xs:sequence>
      </xs:complexType>
    </xs:element>
    
    </xs:schema>
  • Group 指示器

    Group 指示器用于定义相关的元素集。

    Element Groups

    元素组是通过组声明定义的,如下所示:
    <xs:group name="groupname">
      ...
    </xs:group>
    您必须在组声明中定义 all,choice 或 sequence 元素。
    下面的示例定义了一个名为 "persongroup" 的组,该组定义了必须按确切顺序出现的一组元素:
    <xs:group name="persongroup">
      <xs:sequence>
        <xs:element name="firstname" type="xs:string"/>
        <xs:element name="lastname" type="xs:string"/>
        <xs:element name="birthday" type="xs:date"/>
      </xs:sequence>
    </xs:group>
    定义组后,可以在另一个定义中引用它,如下所示:
    <xs:group name="persongroup">
      <xs:sequence>
        <xs:element name="firstname" type="xs:string"/>
        <xs:element name="lastname" type="xs:string"/>
        <xs:element name="birthday" type="xs:date"/>
      </xs:sequence>
    </xs:group>
    
    <xs:element name="person" type="personinfo"/>
    
    <xs:complexType name="personinfo">
      <xs:sequence>
        <xs:group ref="persongroup"/>
        <xs:element name="country" type="xs:string"/>
      </xs:sequence>
    </xs:complexType>

    Attribute Groups

    属性组是通过 attributeGroup 声明定义的,如下所示:
    <xs:attributeGroup name="groupname">
      ...
    </xs:attributeGroup>
    以下示例定义了一个名为 "personattrgroup" 的属性组:
    <xs:attributeGroup name="personattrgroup">
      <xs:attribute name="firstname" type="xs:string"/>
      <xs:attribute name="lastname" type="xs:string"/>
      <xs:attribute name="birthday" type="xs:date"/>
    </xs:attributeGroup>
    定义属性组后,可以在另一个定义中引用它,如下所示:
    <xs:attributeGroup name="personattrgroup">
      <xs:attribute name="firstname" type="xs:string"/>
      <xs:attribute name="lastname" type="xs:string"/>
      <xs:attribute name="birthday" type="xs:date"/>
    </xs:attributeGroup>
    
    <xs:element name="person">
      <xs:complexType>
        <xs:attributeGroup ref="personattrgroup"/>
      </xs:complexType>
    </xs:element>