Индикаторы комплексных типов XSD
- Предыдущая страница Смешанное содержимое XSD
- Следующая страница XSD <any>
Через индикаторы мы можем контролировать способ использования элементов в документе.
Индикатор
Имеется семь индикаторов:
Индикатор порядка:
- Все
- Выбор
- Последовательность
Индикатор возникновения:
- maxOccurs
- minOccurs
Индикатор group:
- имя группы
- имя attributeGroup
Индикатор 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 (будет объяснено позже).
Индикатор 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" может появляться в элементе "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" может出现在 элементе "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:
<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>
- Предыдущая страница Смешанное содержимое XSD
- Следующая страница XSD <any>