XSD-komplexa typindikatorer

Genom indikatorer kan vi styra hur element används i dokumentet.

indikator

Det finns sju indikatorer:

Ordningindikator:

  • alla
  • val
  • sekvens

Frekvensindikator:

  • maxOccurs
  • minOccurs

Gruppindikator:

  • Gruppnamn
  • attributeGroup name

Order-indikatorn

Order-indikatorn används för att definiera elementets ordning.

All-indikatorn

<all>-indikatorn specificerar att underelement kan uppträda i vilken ordning som helst och att varje underelement måste uppträda endast en gång:

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

Kommentar:När du använder <all>-indikatorn kan du ställa in <minOccurs> till 0 eller 1, och kan bara ställa in <maxOccurs>-indikatorn till 1 (mer information om <minOccurs> och <maxOccurs> kommer senare).

Choice-indikatorn

<choice>-indikatorn specificerar att ett underelement kan uppträda eller att ett annat underelement (entant eller annant) kan uppträda:

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

Tips:För att sätta att underelement kan uppträda ett obegränsat antal gånger, kan du ställa in <maxOccurs> (som kommer att förklaras senare) till unbounded (obegränsat antal gånger).

Sequence-indikatorn

<sequence> specificerar att underelement måste uppträda i en viss ordning:

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

Occurrence-indikatorn används för att definiera frekvensen av ett elements uppträdande.

Kommentar:För alla "Order" och "Group"-indikatorer (any, all, choice, sequence, gruppnamn samt gruppreferens), är standardvärdet för både maxOccurs och minOccurs 1.

maxOccurs-indikatorn

<maxOccurs>-indikatorn specificerar den högsta antalet gånger ett element kan uppträda:

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

Detta exempel visar att underelementet "child_name" kan uppträda i elementet "person" minst en gång (där minOccurs har standardvärdet 1) och högst 10 gånger.

minOccurs-indikatorn

<minOccurs>-indikatorn specificerar den minsta antalet gånger ett element kan uppträda:

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

Detta exempel visar att underelementet "child_name" kan uppträda i elementet "person" minst 0 gånger och högst 10 gånger.

Tips:För att göra det möjligt för en element att uppträda obegränsat, använd deklarationen maxOccurs="unbounded":

Ett konkret exempel:

En XML-fil med namnet "Myfamily.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>

Ovanstående XML-fil innehåller en rot-element med namnet "persons". Inuti detta rot-element har vi definierat tre "person"-element. Varje "person"-element måste innehålla ett "full_name"-element, och det kan innehålla upp till 5 "child_name"-element.

Detta är schema-filen "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 indikator

Group indikator används för att definiera relaterade elementgrupper.

Elementgrupp

Elementgrupper definieras genom att använda group-deklarationen:

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

Du måste definiera en all, choice eller sequence-element inom group-deklarationen. Nedanstående exempel definierar en group med namnet "persongroup", som definierar ett måste uppstå i exakt denna ordning:

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

Efter att du har definierat group kan du hänvisa till den i en annan definition:

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

Attributgrupp

Attributgrupper definieras genom att använda attributeGroup-deklarationen:

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

Nedanstående exempel definierar en attributgrupp med namnet "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>

Efter att du har definierat attributgruppen kan du hänvisa till den i en annan definition, som så här:

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