Wskaźnik typu kompozytowego XSD

Przez indykator, możemy kontrolować sposób użycia elementów w dokumencie.

Indykator

Siedem rodzajów indykatorów:

Indykator kolejności:

  • Wszystkie
  • Wybór
  • Sekwencja

Indykator wystąpienia:

  • maxOccurs
  • minOccurs

Indykator grupy:

  • Nazwa grupy
  • attributeGroup name

Wskaźnik <order>

Wskaźnik <order> określa kolejność elementów.

Wskaźnik <all>

Wskaźnik <all> określa, że podelementy mogą występować w dowolnej kolejności i każdy podelement musi występować tylko raz:

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

Komentarz:Kiedy używasz wskaźnika <all>, możesz ustawić <minOccurs> na 0 lub 1, a wskaźnik <maxOccurs> może być ustawiony tylko na 1 (będzie omówione <minOccurs> oraz <maxOccurs>).

Wskaźnik <choice>

Wskaźnik <choice> określa, że może występować pewien podelement lub inny podelement (albo to, albo inne):

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

Wskazówka:Aby ustawić dowolną liczbę wystąpień podelementu, ustaw <maxOccurs> (który zostanie omówiony później) na unbounded (nieskończona liczba razy).

Wskaźnik <sequence>

<sequence> określa, że podelementy muszą występować w określonej kolejności:

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

Wskaźnik wystąpienia

Wskaźnik wystąpienia określa częstotliwość występowania elementu.

Komentarz:Dla wszystkich wskaźników "Order" i "Group" (any, all, choice, sequence, nazwa grupy oraz odwołanie do grupy) domyślne wartości maxOccurs oraz minOccurs wynoszą 1.

Indykator <maxOccurs>

Indykator <maxOccurs> określa maksymalną liczbę wystąpień elementu:

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

Powyższy przykład pokazuje, że podelement "child_name" może występować w elemencie "person" co najmniej raz (domyślna wartość minOccurs to 1), a co najwyżej 10 razy.

Indykator <minOccurs>

Indykator <minOccurs> określa minimalną liczbę wystąpień elementu:

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

Powyższy przykład pokazuje, że podelement "child_name" może występować w elemencie "person" co najmniej 0 razy, a co najwyżej 10 razy.

Wskazówka:Aby umożliwić nieograniczoną liczbę wystąpień elementu, użyj deklaracji maxOccurs="unbounded":

Rzeczywisty przykład:

Plik XML o nazwie "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>

Powyższy plik XML zawiera jeden element główny o nazwie "persons". Wewnątrz tego elementu zdefiniowano trzy elementy "person". Każdy element "person" musi zawierać element "full_name", a może zawierać do 5 elementów "child_name".

To jest plik schematu "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>

Indykator Group

Indykator Group służy do zdefiniowania związanych elementów partii.

Grupy elementów

Grupy elementów są definiowane poprzez deklarację group:

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

Musisz zdefiniować element all, choice lub sequence wewnątrz deklaracji group. Poniższy przykład definiuje grupę elementów o nazwie "persongroup", która definiuje zestaw elementów, które muszą pojawić się w określonej kolejności:

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

Po zakończeniu definicji grupy elementów, możesz odnosić się do niej w innych definicjach:

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

Grupy atrybutów

Grupy atrybutów są definiowane poprzez deklarację attributeGroup:

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

Poniższy przykład definiuje grupę atrybutów o nazwie "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>

Po zakończeniu definicji grupy atrybutów, możesz odnosić się do niej w innych definicjach, np.:

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