XSD - monimutkaisen tyypin vihje

Vihjeenantajien avulla voimme hallita elementtien käyttöä dokumentissa.

Vihjeenantaja

On seitsemän vihjeenantajaa:

Järjestys vihjeenantaja:

  • Kaikki
  • Valinta
  • Järjestys

Toimintahäiriö vihjeenantaja:

  • maxOccurs
  • minOccurs

Ryhmä vihjeenantaja:

  • Ryhmän nimi
  • attributeGroup name

Order -indikaattori

Order -indikaattori määrittää elementin järjestyksen.

All -indikaattori

<all> -indikaattori määrittää, että alaelementit voivat esiintyä mihin tahansa järjestykseen ja että jokainen alaelementti esiintyy vain kerran:

<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>

Huomautus:Kun käytät <all> -indikaattoria, voit asettaa <minOccurs> arvoksi 0 tai 1, mutta <maxOccurs> -indikaattorin voit asettaa vain arvoksi 1 (joka käsitellään myöhemmin <minOccurs> ja <maxOccurs>).

Choice -indikaattori

<choice> -indikaattori määrittää, että jokin tietty alaelementti tai toinen alaelementti (joko tämä tai tuo) voi esiintyä:

<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>

Vinkki:Jos haluat sallia alaelementin esiintymisen mihin tahansa määrään, voit asettaa <maxOccurs> (joka käsitellään myöhemmin) arvoksi unbounded (rajoittamaton).

Sequence -indikaattori

<sequence> määrittää, että alaelementit on esitettävä tietystä järjestyksestä:

<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 -indikaattori

Occurrence -indikaattori määrittää elementin esiintymisen säännöllisyyden.

Huomautus:Kaikille "Order"- ja "Group"-indikaattoreille (any, all, choice, sequence, group name ja group reference) maxOccurs- ja minOccurs-arvot ovat oletuksena 1.

maxOccurs -indikaattori

<maxOccurs> -indikaattori määrittää elementin enimmäis esiintymiskerrat:

<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>

Yllä oleva esimerkki osoittaa, että alaelementti "child_name" voi esiintyä "person"-elementissä vähintään yhden kerran (jossa minOccurs:n oletusarvo on 1) ja enintään 10 kertaa.

minOccurs -indikaattori

<minOccurs> -indikaattori määrittää elementin vähimmäis esiintymiskerrat:

<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>

Yllä oleva esimerkki osoittaa, että alaelementti "child_name" voi esiintyä "person"-elementissä vähintään 0 kertaa ja enintään 10 kertaa.

Vinkki:Jos haluat sallia elementin esiintymisen ilman rajoituksia, käytä määrittelyä maxOccurs="unbounded":

一个实际的例子：

名为 "Myfamily.xml" 的 XML 文件：

<?xml version="1.0" encoding="ISO-8859-1"?>
<persons xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="family.xsd">
<person>
<full_name>Tony Smith</full_name>
<child_name>Cecilie</child_name>
</person>
<person>
<full_name>David Smith</full_name>
<child_name>Jogn</child_name>
<child_name>mike</child_name>
<child_name>kyle</child_name>
<child_name>mary</child_name>
</person>
<person>
<full_name>Michael Smith</full_name>
</person>
</persons>

上面这个 XML 文件含有一个名为 "persons" 的根元素。在这个根元素内部，我们定义了三个 "person" 元素。每个 "person" 元素必须含有一个 "full_name" 元素，同时它可以包含多至 5 个 "child_name" 元素。

这是schema文件"family.xsd"：

<?xml version="1.0" encoding="ISO-8859-1"?>
<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 指示器用于定义相关的数批元素。

Elementtiyhmä

Elementtiyhmä määritellään group- lausekkeella:

<xs:group name="组名称">
  ...
</xs:group>

Sinun on määritettävä all, choice tai sequence-elementti group- lausekkeen sisällä. Tässä esimerkissä määritellään nimeltään "persongroup" oleva group, joka määrittelee elementtien täytyy esiintyä tarkalla järjestyksellä:

<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>

Kun olet määrittänyt groupin valmiiksi, voit viitata siihen toisessa määrittelyssä:

<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>

Ominaisuusryhmä

Ominaisuusryhmä määritellään attributeGroup- lausekkeella:

<xs:attributeGroup name="组名称">
  ...
</xs:attributeGroup>

Tässä esimerkissä määritellään nimeltään "personattrgroup" oleva ominaisuusryhmä:

<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>

Kun olet määrittänyt ominaisuusryhmän valmiiksi, voit viitata siihen toisessa määrittelyssä, kuten seuraavasti:

<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>