Индикаторы комплексных типов XSD

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

Индикатор

Имеется семь индикаторов:

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

  • Все
  • Choice
  • Sequence

Индикатор occurrences:

  • maxOccurs
  • minOccurs

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

  • Название группы
  • attributeGroup name

Индикатор order

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

Индикатор 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

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

Совет:Чтобы установить любое количество出现的 подэлементов, установите <maxOccurs> (будет рассмотрено позже) в значение unbounded (неограниченное количество раз).

Индикатор sequence

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

Индикатор occurrence

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

Комментарий:Для всех индикаторов "Order" и "Group" (any, all, choice, sequence, имя группы и ссылка на группу) значения по умолчанию для 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" может出现的次数 от 1 до 10 раз в элементе "person" (по умолчанию значение minOccurs равно 1).

Индикатор 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" может出现在 элементе "person" от 0 до 10 раз.

Совет:Чтобы не ограничивать количество出现的元素，используйте заявление 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>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".

Это файл схемы "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 используется для определения связанных элементов набора.

Группа элементов

Группа элементов определяется с помощью объявления group:

<xs:group name="组名称">
  ...
</xs: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="组名称">
  ...
</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>