Możemy kontrolować w jaki sposób elementy mają być używane w dokumentach ze wskaźnikami.
wskaźniki
Istnieje siedem wskaźników:
Wskaźniki zamówienie:
- All
- Choice
- Sequence
Wskaźniki Występowanie:
- maxOccurs
- minOccurs
Wskaźniki Grupa:
- Group name
- attributeGroup name
Wskaźniki Zamówienie
Zamówienie wskaźniki służą do określenia kolejności elementów.
wszystko Indicator
<all> Wskaźnik określa, że elementy podrzędne mogą być wyświetlane w dowolnej kolejności, a każdy element dziecko musi pojawić się 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>
Note: Podczas korzystania z <all> wskaźnik można ustawić <minOccurs> wskaźnik 0 lub 1 i <maxOccurs> Wskaźnik może być ustawiony tylko 1 ( <minOccurs> i <maxOccurs> są opisane później).
dobór wskaźnika
<choice> Wskaźnik określa, że mogą wystąpić albo jeden element dziecko lub inna:
<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>
Wskaźnik kolejności
<sequence> Wskaźnik określa, że elementy podrzędne muszą pojawić się 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źniki występowanie
Wskaźniki występowania są wykorzystywane do określenia, jak często może pojawić się element.
Note: Dla wszystkich "Order" i "Group" wskaźników (w ogóle, wszystko, wybór, sekwencja, nazwa grupy, a grupa odniesienia) Wartość domyślna dla maxOccurs i minOccurs to 1.
maxOccurs Indicator
<maxOccurs> Wskaźnik określa maksymalną liczbę razy, może wystąpić element:
<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 wskazuje, że "child_name" element może wystąpić co najmniej jeden raz (wartość domyślna dla minOccurs wynosi 1), a maksymalnie dziesięć razy w "person" elementu.
Wskaźnik minOccurs
<minOccurs> Wskaźnik określa minimalną liczbę razy, może wystąpić element:
<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 wskazuje, że "child_name" element może wystąpić co najmniej zero razy, a maksymalnie dziesięć razy w "person" elementu.
Tip: Aby umożliwić elementem pojawiać nieograniczoną ilość razy, użyj maxOccurs = "nieograniczony" oświadczenie:
A working example:
Plik XML o nazwie "Myfamily.xml" :
<?xml version="1.0" encoding="UTF-8"?>
<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>
Plik XML powyżej zawiera element główny o nazwie "persons" . Wewnątrz tego elementu głównego zdefiniowaliśmy trzy "person" elementy. Każdy "person" element musi zawierać "full_name" element i może zawierać do pięciu "child_name" elementy.
Oto plik schematu "family.xsd" :
<?xml version="1.0" encoding="UTF-8"?>
<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>
Wskaźniki grupowe
Wskaźniki grupowe służą do definiowania zestawów powiązanych elementów.
Element Groups
grupy elementów są zdefiniowane z deklaracją grupy w następujący sposób:
<xs:group name="groupname">
...
</xs:group>
Musisz zdefiniować wszystko, wybór, lub element sekwencji wewnątrz deklaracji grupowej. Poniższy przykład definiuje grupę o nazwie "persongroup" , który definiuje grupę elementów, które muszą wystąpić w dokładnej 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 zdefiniowaniu grupy, można odwoływać się do niej w innej definicji, jak poniżej:
<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>
Atrybut Groups
grupy atrybutów są zdefiniowane z deklaracją attributeGroup coś takiego:
<xs:attributeGroup name="groupname">
...
</xs:attributeGroup>
Poniższy przykład definiuje grupę atrybut 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 zdefiniowaniu grupy atrybutów, można odwoływać się do niej w innej definicji, jak poniżej:
<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>