XMLSchema 注解

注解

在XML文档中提供附加信息的通常方式是使用注释，即在"<!--"和"-->"之间给出注释信息。在XML Schema中，注释仍然可以使用，不过为了方便其他读者和应用程序来理解模式文档，XML Schema提供了三个元素来为模式提供注解。这三个元素是：xs:annotation、xs:documentation和xs:appinfo，其中xs:documentation和xs:appinfo是作为xs:annotation元素的子元素使用的。xs:documentation元素用于放置适合人阅读的信息，而xs:appinfo元素则用于为工具、样式表和其他应用程序提供信息。

我们看例4-32。

例4-32  hr.xsd

<?xml version="1.0" encoding="GB2312"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation xml:lang="zh">
这是一份用于企业雇员信息描述的模式文档
</xs:documentation>
</xs:annotation>
<xs:element name="hr">
<xs:annotation>
<xs:documentation xml:lang="zh">
hr元素是文档的根元素，使用匿名类型定义来声明
</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:annotation>
<xs:documentation xml:lang="zh">
根元素hr下可以有多个employee子元素
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="employee" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>

xs:annotation元素常常在元素声明或类型定义的开头使用，用于对元素的作用、类型的定义提供附加的描述信息。为了说明这些描述信息所使用的语言，可以在xs:documentation元素上使用xml:lang属性来指定语言，xml:lang属性的值是在IETF RFC 3066（Tags for the Identification of Languages）或它的后继版本中定义的语言标识符。

xs:appinfo元素用于为计算机自动处理提供信息，它没有且也不需要xml:lang属性。xs:annotation元素和xs:appinfo元素还有一个可选的source属性，它的值是一个URI引用，指向一个包含了描述信息的文档位置。