XSD Индикаторы


С помощью индикаторов мы можем управлять тем, как элементы используются в документе.


Индикаторы

Существует семь типов индикаторов:

Индикаторы порядка:

  • Все
  • Choice
  • Последовательность

Индикаторы вхождения:

  • maxOccurs
  • minOccurs

Индикаторы групп:

  • Имя группы
  • Имя attributeGroup

Индикаторы порядка

Индикаторы порядка используются для определения порядка элементов.

Индикатор 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> указывает, что может появиться либо один дочерний элемент, либо другой дочерний элемент (или/или):

<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> указывает, что дочерние элементы должны появляться в определенном порядке:

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


Индикаторы вхождения

Индикаторы вхождения используются для определения того, как часто может появляться элемент.

Примечание:Для всех индикаторов "Порядок" и "Группа" (any, all, choice, sequence, group name и group reference) значения по умолчанию 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) и не более 10 раз.

Индикатор 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" может появляться не менее 0 раз и не более 10 раз в элементе "person".

Совет:Если вы хотите, чтобы элемент имел неограниченное количество вхождений, используйте объявление maxOccurs="unbounded":

Практический пример:

XML-файл с именем "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>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-файл выше содержит корневой элемент с именем "persons". Внутри этого корневого элемента мы определяем три элемента "person". Каждый элемент "person" должен содержать элемент "full_name", и он может содержать до 5 элементов "child_name".

Это файл схемы "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:

<xs:group name="groupname">
...
</xs:group>

Внутри объявления 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>

Группы атрибутов

Группы атрибутов определяются с помощью объявления 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>
Другие расширения