XSD-komplexe Typen-Indikatoren

Durch Indikatoren können wir steuern, wie Elemente im Dokument verwendet werden.

Indikator

Es gibt sieben Indikatoren:

Reihenfolge-Indikator:

  • Alle
  • Auswahl
  • Reihenfolge

Vorkommens-Indikator:

  • maxOccurs
  • minOccurs

Gruppen-Indikator:

  • Gruppenname
  • attributeGroup name

Order-Indikator

Der Order-Indikator wird verwendet, um die Reihenfolge der Elemente zu definieren.

All-Indikator

<all>-Indikator legt fest, dass Unterlemente in beliebiger Reihenfolge auftreten können und jeder Unterlement nur einmal auftreten muss:

</xs:attributeGroup>
  <xs:element name="person">
    <xs:all>
      <xs:element name="firstname" type="xs:string"/>
      <xs:element name="lastname" type="xs:string"/>
    </xs:all>
  <xs:attributeGroup ref="personattrgroup"/>
</xs:complexType>

Anmerkung:Bei der Verwendung des <all>-Indikators kann <minOccurs> auf 0 oder 1 gesetzt werden, während der <maxOccurs>-Indikator nur auf 1 gesetzt werden kann (der nachstehend erläuterte <minOccurs> und <maxOccurs> werden erläutert).

Choice-Indikator

<choice>-Indikator legt fest, dass ein Unterlement oder ein anderes Unterlement (entweder oder) auftreten kann:

</xs:attributeGroup>
  <xs:element name="person">
    <xs:choice>
      <xs:element name="employee" type="employee"/>
      <xs:element name="member" type="member"/>
    </xs:choice>
  <xs:attributeGroup ref="personattrgroup"/>
</xs:complexType>

Hinweis:Um die Anzahl der Auftretensmöglichkeiten von Unterlementen beliebig oft zu setzen, kann der <maxOccurs> (der nachstehend erläutert wird) auf unbounded (unbegrenzt) gesetzt werden.

Sequence-Indikator

<sequence> legt fest, dass Unterlemente in einer bestimmten Reihenfolge auftreten müssen:

</xs:attributeGroup>
  <xs:element name="person">
    <xs:sequence>
      <xs:element name="firstname" type="xs:string"/>
      <xs:element name="lastname" type="xs:string"/>
    </xs:sequence>
  <xs:attributeGroup ref="personattrgroup"/>
</xs:complexType>

Occurrence-Indikator

Der Occurrence-Indikator wird verwendet, um die Häufigkeit der Ausgabe eines Elements zu definieren.

Anmerkung:Für alle "Order"- und "Group"-Indikatoren (any, all, choice, sequence, Gruppenname sowie Gruppenreferenz) sind die Standardwerte für maxOccurs und minOccurs 1.

maxOccurs-Indikator

<maxOccurs>-Indikator kann die maximale Anzahl der möglichen Auftretensmöglichkeiten eines Elements festlegen:

</xs:attributeGroup>
  <xs:element name="person">
    <xs:sequence>
      <xs:element name="full_name" type="xs:string"/>
      <xs:element name="child_name" type="xs:string"> maxOccurs="10"/>
    </xs:sequence>
  <xs:attributeGroup ref="personattrgroup"/>
</xs:complexType>

Der obige Beispiel zeigt, dass der Unterlement "child_name" im Element "person" mindestens einmal auftreten kann (bei dem Standardwert von minOccurs ist 1), maximal 10 Mal.

minOccurs-Indikator

<minOccurs>-Indikator kann die minimale Anzahl der möglichen Auftretensmöglichkeiten eines Elements festlegen:

</xs:attributeGroup>
  <xs:element name="person">
    <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:attributeGroup ref="personattrgroup"/>
</xs:complexType>

Der obige Beispiel zeigt, dass der Unterlement "child_name" im Element "person" mindestens 0 Mal und maximal 10 Mal auftreten kann.

Hinweis:Um die Anzahl der Auftretensmöglichkeiten eines Elements uneingeschränkt zu machen, verwenden Sie die Angabe maxOccurs="unbounded":

Ein praktisches Beispiel:

Die XML-Datei "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>

Dieser XML-Datei enthält eine Wurzelelement namens "persons". Innerhalb dieses Wurzelelements haben wir drei "person"-Elemente definiert. Jedes "person"-Element muss ein "full_name"-Element enthalten und kann bis zu 5 "child_name"-Elemente enthalten.

Dies ist die Schema-Datei "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:element name="person">
    <xs:sequence>
      <xs:element name="person" maxOccurs="unbounded">
        <xs:element name="person">
          <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:attributeGroup ref="personattrgroup"/>
      </xs:complexType>
    </xs:sequence>
  <xs:attributeGroup ref="personattrgroup"/>
</xs:complexType>
</xs:schema>

Group-Indikator

Group-Indikator wird verwendet, um mit den relevanten Elementen der Zahlungspakete in Verbindung zu setzen.

Elementgruppe

Die Elementgruppe wird durch eine Group-Deklaration definiert:

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

Sie müssen innerhalb der Group-Deklaration eine all, choice oder sequence-Ebene definieren. Nachfolgender Beispiel definiert eine Group namens "persongroup", die eine Gruppe von Elementen definiert, die in einer genauen Reihenfolge auftreten müssen:

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

Nachdem Sie die Group vollständig definiert haben, können Sie sie in einer anderen Definition referenzieren:

<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:attributeGroup ref="personattrgroup"/>

Eigenschaftsgruppe

Die Eigenschaftsgruppe wird durch eine attributeGroup-Deklaration definiert:

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

Nachfolgender Beispiel definiert eine Eigenschaftsgruppe namens "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"/>

Nachdem Sie die Eigenschaftsgruppe vollständig definiert haben, können Sie sie in einer anderen Definition referenzieren, wie folgt:

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