XSD Индикаторы
С помощью индикаторов мы можем управлять тем, как элементы используются в документе.
Индикаторы
Существует семь типов индикаторов:
Индикаторы порядка:
- Все
- Choice
- Последовательность
Индикаторы вхождения:
- maxOccurs
- minOccurs
Индикаторы групп:
- Имя группы
- Имя attributeGroup
Индикаторы порядка
Индикаторы порядка используются для определения порядка элементов.
Индикатор All
Индикатор <all> указывает, что дочерние элементы могут появляться в любом порядке, и каждый дочерний элемент должен появляться только один раз:
<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:complexType>
<xs:choice>
<xs:element name="employee" type="employee"/>
<xs:element name="member" type="member"/>
</xs:choice>
</xs:complexType>
</xs:element>
Индикатор последовательности
<sequence> указывает, что дочерние элементы должны появляться в определенном порядке:
<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: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: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":
<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":
<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>
Внутри объявления group необходимо определить элемент all, choice или sequence. В следующем примере определяется группа с именем "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: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>
В следующем примере определяется группа атрибутов с именем "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: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>