XSD 复合类型指示器

通过指示器,我们可以控制在文档中使用元素的方式。

指示器

有七种指示器:

Order 指示器:

  • All
  • Choice
  • Sequence

Occurrence 指示器:

  • maxOccurs
  • minOccurs

Group 指示器:

  • Group name
  • attributeGroup name

Order 指示器

Order 指示器用于定义元素的顺序。

All 指示器

<all> 指示器规定子元素可以按照任意顺序出现,且每个子元素必须只出现一次:

  1. <xs:element name="person">
  2. <xs:complexType>
  3. <xs:all>
  4. <xs:element name="firstname" type="xs:string"/>
  5. <xs:element name="lastname" type="xs:string"/>
  6. </xs:all>
  7. </xs:complexType>
  8. </xs:element>

注释:当使用 <all> 指示器时,你可以把 <minOccurs> 设置为 0 或者 1,而只能把 <maxOccurs> 指示器设置为 1(稍后将讲解 <minOccurs> 以及 <maxOccurs>)。

Choice 指示器

<choice> 指示器规定可出现某个子元素或者可出现另外一个子元素(非此即彼):

  1. <xs:element name="person">
  2. <xs:complexType>
  3. <xs:choice>
  4. <xs:element name="employee" type="employee"/>
  5. <xs:element name="member" type="member"/>
  6. </xs:choice>
  7. </xs:complexType>
  8. </xs:element>

提示:如需设置子元素出现任意次数,可将 <maxOccurs> (稍后会讲解)设置为 unbounded(无限次)。

Sequence 指示器

<sequence> 规定子元素必须按照特定的顺序出现:

  1. <xs:element name="person">
  2. <xs:complexType>
  3. <xs:sequence>
  4. <xs:element name="firstname" type="xs:string"/>
  5. <xs:element name="lastname" type="xs:string"/>
  6. </xs:sequence>
  7. </xs:complexType>
  8. </xs:element>

Occurrence 指示器

Occurrence 指示器用于定义某个元素出现的频率。

注释:对于所有的 "Order" 和 "Group" 指示器(any、all、choice、sequence、group name 以及 group reference),其中的 maxOccurs 以及 minOccurs 的默认值均为 1。

maxOccurs 指示器

<maxOccurs> 指示器可规定某个元素可出现的最大次数:

  1. <xs:element name="person">
  2. <xs:complexType>
  3. <xs:sequence>
  4. <xs:element name="full_name" type="xs:string"/>
  5. <xs:element name="child_name" type="xs:string" maxOccurs="10"/>
  6. </xs:sequence>
  7. </xs:complexType>
  8. </xs:element>

上面的例子表明,子元素 "child_name" 可在 "person" 元素中最少出现一次(其中 minOccurs 的默认值是 1),最多出现 10 次。

minOccurs 指示器

<minOccurs> 指示器可规定某个元素能够出现的最小次数:

  1. <xs:element name="person">
  2. <xs:complexType>
  3. <xs:sequence>
  4. <xs:element name="full_name" type="xs:string"/>
  5. <xs:element name="child_name" type="xs:string"
  6. maxOccurs="10" minOccurs="0"/>
  7. </xs:sequence>
  8. </xs:complexType>
  9. </xs:element>

上面的例子表明,子元素 "child_name" 可在 "person" 元素中出现最少 0 次,最多出现 10 次。

提示:如需使某个元素的出现次数不受限制,请使用 maxOccurs="unbounded" 这个声明:

一个实际的例子:

名为 "Myfamily.xml" 的 XML 文件:

  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2.  
  3. <persons xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4. xsi:noNamespaceSchemaLocation="family.xsd">
  5.  
  6. <person>
  7. <full_name>Tony Smith</full_name>
  8. <child_name>Cecilie</child_name>
  9. </person>
  10.  
  11. <person>
  12. <full_name>David Smith</full_name>
  13. <child_name>Jogn</child_name>
  14. <child_name>mike</child_name>
  15. <child_name>kyle</child_name>
  16. <child_name>mary</child_name>
  17. </person>
  18.  
  19. <person>
  20. <full_name>Michael Smith</full_name>
  21. </person>
  22.  
  23. </persons>

上面这个 XML 文件含有一个名为 "persons" 的根元素。在这个根元素内部,我们定义了三个 "person" 元素。每个 "person" 元素必须含有一个 "full_name" 元素,同时它可以包含多至 5 个 "child_name" 元素。

这是schema文件"family.xsd":

  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2. <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
  3. elementFormDefault="qualified">
  4.  
  5. <xs:element name="persons">
  6. <xs:complexType>
  7. <xs:sequence>
  8. <xs:element name="person" maxOccurs="unbounded">
  9. <xs:complexType>
  10. <xs:sequence>
  11. <xs:element name="full_name" type="xs:string"/>
  12. <xs:element name="child_name" type="xs:string"
  13. minOccurs="0" maxOccurs="5"/>
  14. </xs:sequence>
  15. </xs:complexType>
  16. </xs:element>
  17. </xs:sequence>
  18. </xs:complexType>
  19. </xs:element>
  20.  
  21. </xs:schema>

Group 指示器

Group 指示器用于定义相关的数批元素。

元素组

元素组通过 group 声明进行定义:

  1. <xs:group name="组名称">
  2. ...
  3. </xs:group>

您必须在 group 声明内部定义一个 all、choice 或者 sequence 元素。下面这个例子定义了名为 "persongroup" 的 group,它定义了必须按照精确的顺序出现的一组元素:

  1. <xs:group name="persongroup">
  2. <xs:sequence>
  3. <xs:element name="firstname" type="xs:string"/>
  4. <xs:element name="lastname" type="xs:string"/>
  5. <xs:element name="birthday" type="xs:date"/>
  6. </xs:sequence>
  7. </xs:group>

在您把 group 定义完毕以后,就可以在另一个定义中引用它了:

  1. <xs:group name="persongroup">
  2. <xs:sequence>
  3. <xs:element name="firstname" type="xs:string"/>
  4. <xs:element name="lastname" type="xs:string"/>
  5. <xs:element name="birthday" type="xs:date"/>
  6. </xs:sequence>
  7. </xs:group>
  8.  
  9. <xs:element name="person" type="personinfo"/>
  10.  
  11. <xs:complexType name="personinfo">
  12. <xs:sequence>
  13. <xs:group ref="persongroup"/>
  14. <xs:element name="country" type="xs:string"/>
  15. </xs:sequence>
  16. </xs:complexType>

属性组

属性组通过 attributeGroup 声明来进行定义:

  1. <xs:attributeGroup name="组名称">
  2. ...
  3. </xs:attributeGroup>

下面这个例子定义了名为 "personattrgroup" 的一个属性组:

  1. <xs:attributeGroup name="personattrgroup">
  2. <xs:attribute name="firstname" type="xs:string"/>
  3. <xs:attribute name="lastname" type="xs:string"/>
  4. <xs:attribute name="birthday" type="xs:date"/>
  5. </xs:attributeGroup>

在您已定义完毕属性组之后,就可以在另一个定义中引用它了,就像这样:

  1. <xs:attributeGroup name="personattrgroup">
  2. <xs:attribute name="firstname" type="xs:string"/>
  3. <xs:attribute name="lastname" type="xs:string"/>
  4. <xs:attribute name="birthday" type="xs:date"/>
  5. </xs:attributeGroup>
  6.  
  7. <xs:element name="person">
  8. <xs:complexType>
  9. <xs:attributeGroup ref="personattrgroup"/>
  10. </xs:complexType>
  11. </xs:element>