XSD 限制/方面
限制用于定义 XML 元素或属性的允许值。对 XML 元素的限制称为方面。
值的限制
以下示例定义了一个名为“age”的元素,它有一个限制。年龄的值不能低于 0 或高于 120
<xs:element name="age">
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:minInclusive value="0"/>
<xs:maxInclusive value="120"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
对一组值的限制
要将 XML 元素的内容限制为一组允许的值,我们将使用枚举约束。
以下示例定义了一个名为“car”的元素,它有一个限制。唯一允许的值是:Audi、Golf、BMW
<xs:element name="car">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="Audi"/>
<xs:enumeration value="Golf"/>
<xs:enumeration value="BMW"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
上面的示例也可以这样写
<xs:element name="car" type="carType"/>
<xs:simpleType name="carType">
<xs:restriction base="xs:string">
<xs:enumeration value="Audi"/>
<xs:enumeration value="Golf"/>
<xs:enumeration value="BMW"/>
</xs:restriction>
</xs:simpleType>
注意:在这种情况下,类型“carType”可以被其他元素使用,因为它不是“car”元素的一部分。
对一系列值的限制
要将 XML 元素的内容限制为定义一系列可以使用的数字或字母,我们将使用模式约束。
以下示例定义了一个名为“letter”的元素,它有一个限制。唯一允许的值是从 a 到 z 的小写字母中的一个
<xs:element name="letter">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[a-z]"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
下一个示例定义了一个名为“initials”的元素,它有一个限制。唯一允许的值是从 a 到 z 的大写字母中的三个
<xs:element name="initials">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[A-Z][A-Z][A-Z]"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
下一个示例也定义了一个名为“initials”的元素,它有一个限制。唯一允许的值是从 a 到 z 的小写或大写字母中的三个
<xs:element name="initials">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[a-zA-Z][a-zA-Z][a-zA-Z]"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
下一个示例定义了一个名为“choice”的元素,它有一个限制。唯一允许的值是以下字母之一:x、y 或 z
<xs:element name="choice">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[xyz]"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
下一个示例定义了一个名为“prodid”的元素,它有一个限制。唯一允许的值是五个数字的序列,每个数字必须在 0 到 9 的范围内
<xs:element name="prodid">
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:pattern value="[0-9][0-9][0-9][0-9][0-9]"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
对一系列值的其它限制
以下示例定义了一个名为“letter”的元素,它有一个限制。允许的值是从 a 到 z 的小写字母的零个或多个出现
<xs:element name="letter">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="([a-z])*"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
下一个示例也定义了一个名为“letter”的元素,它有一个限制。允许的值是一个或多个字母对,每个对都由一个小写字母后跟一个大写字母组成。例如,“sToP”将通过此模式验证,但“Stop”、“STOP”或“stop”将不会通过
<xs:element name="letter">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="([a-z][A-Z])+"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
下一个示例定义了一个名为“gender”的元素,它有一个限制。唯一允许的值是 male 或 female
<xs:element name="gender">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="male|female"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
下一个示例定义了一个名为“password”的元素,它有一个限制。必须有恰好八个字符的序列,这些字符必须是从 a 到 z 的小写或大写字母,或从 0 到 9 的数字
<xs:element name="password">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[a-zA-Z0-9]{8}"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
对空白字符的限制
要指定如何处理空白字符,我们将使用 whiteSpace 约束。
此示例定义了一个名为“address”的元素,它有一个限制。whiteSpace 约束设置为“preserve”,这意味着 XML 处理器将不会删除任何空白字符
<xs:element name="address">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:whiteSpace value="preserve"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
此示例也定义了一个名为“address”的元素,它有一个限制。whiteSpace 约束设置为“replace”,这意味着 XML 处理器将用空格替换所有空白字符(换行符、制表符、空格和回车符)
<xs:element name="address">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:whiteSpace value="replace"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
此示例也定义了一个名为“address”的元素,它有一个限制。whiteSpace 约束设置为“collapse”,这意味着 XML 处理器将删除所有空白字符(换行符、制表符、空格和回车符被替换为空格,开头和结尾的空格被删除,多个空格被缩减为单个空格)
<xs:element name="address">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:whiteSpace value="collapse"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
对长度的限制
要限制元素中值的长度,我们将使用 length、maxLength 和 minLength 约束。
此示例定义了一个名为“password”的元素,它有一个限制。该值必须正好是八个字符
<xs:element name="password">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="8"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
此示例定义了另一个名为“password”的元素,它有一个限制。该值必须至少是五个字符,最多是八个字符
<xs:element name="password">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="5"/>
<xs:maxLength value="8"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
数据类型的限制
约束 | 描述 |
---|---|
enumeration | 定义允许值的列表 |
fractionDigits | 指定允许的小数位数的最大值。必须等于或大于零 |
length | 指定允许的字符或列表项的确切数量。必须等于或大于零。 |
maxExclusive | 指定数值的上限(值必须小于此值)。 |
maxInclusive | 指定数值的上限(值必须小于或等于此值)。 |
maxLength | 指定允许的最大字符数或列表项数。必须等于或大于零。 |
minExclusive | 指定数值的下限(值必须大于此值)。 |
minInclusive | 指定数值的下限(值必须大于或等于此值)。 |
minLength | 指定允许的最小字符数或列表项数。必须等于或大于零。 |
pattern | 定义可接受的字符的精确序列。 |
totalDigits | 指定允许的确切位数。必须大于零。 |
whiteSpace | 指定如何处理空白(换行符、制表符、空格和回车符)。 |