xsd限定/Facets
如何对元素的属性或者值进行约束呢,这里需要引入一个概念————restriction(限定)
在xml中对元素的限定叫做facet。
对数值的限定
一个栗子——
这里定义一个age元素,我们定义age>=0 && age<=100:
<xs:element name="age"> <xs:simpleType> <xs:restriction base="xs:integer"> <xs:minInclusive value="0"/> <!--注意此处是包含最小值0--> <xs:maxInclusive value="100"/> <!--注意此处是包含最大值100--> </xs:restriction> </xs:simpleType> </xs:element>
对一组同类型数据的限定
这里的一组数据表示限制为一组可接受的值,即我们所说的枚举类型。
combo一个栗子——
定义一个level元素,可限定的值为:low,medium,high:
方法一:
<xs:element name="level"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:enumeration value="low"/> <xs:enumeration value="medium"/> <xs:enumeration value="high"/> </xs:restriction> </xs:simpleType> </xs:element>
方法二:
<xs:element name="level" type="levelType"/> <xs:simpleType name="levelType"> <xs:restriction base="xs:string"> <xs:enumeration value="low"/> <xs:enumeration value="medium"/> <xs:enumeration value="high"/> </xs:restriction> </xs:simpleType>
在方法二中的"levelType"可以被其他元素引用,个人推荐使用方法二。
对混合型数据的限定
更多时候我们需要限定XML元素的内容为一系列数字或者字母的组合,这个时候就需要使用模式约束(pattern constraint)。
combo N个栗子——
该实例定义了一个"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>
该实例定义了一个"letters"元素,可接受的值为a~z或者A~Z中的三个:
<xs:element name="letters"> <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>
该实例定义了一个"letter"元素,可接受的值为a,b,c中的一个:
<xs:element name="letter"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:pattern value="[abc]"/> </xs:restriction> </xs:simpleType> </xs:element>
该实例定义了一个"letters"元素,可接受的值为a~z中零个或多个字母:
<xs:element name="letters"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:pattern value="([a-z])*"/> </xs:restriction> </xs:simpleType> </xs:element>
该实例定义了一个"word"元素,可接受的值是由一个大写字母开头,后面紧跟一个小写字母组成的任意字符,比如Getter满足该元素,而getter不能通过该验证:
<xs:element name="word"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:pattern value="([A-Z][a-z])+"/> </xs:restriction> </xs:simpleType> </xs:element>
该实例定义了一个"student"元素,可接受的值是boy或者girl:
<xs:element name="student"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:pattern value="boy|girl"/> </xs:restriction> </xs:simpleType> </xs:element>
该实例定义了一个"username"元素,可接受的值是12个大小写字母a~z或者数字0~9组成的:
<xs:element name="username"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:pattern value="[a-zA-Z0-9]{12}"/> </xs:restriction> </xs:simpleType> </xs:element>
对空白字符的限定
对空白字符(换行,回车,空格以及制表符)我们需要使用whiteSpace限定
该实例定义了"name"元素,whiteSpace限定为"preserve",表示XML不会移除任何空白字符:
<xs:element name="name"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:whiteSpace value="preserve"/> </xs:restriction> </xs:simpleType> </xs:element>
该实例定义了一个"name"元素,whiteSpace限定为"replace",表示XML会移除任何空白字符:
<xs:element name="name"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:whiteSpace value="replace"/> </xs:restriction> </xs:simpleType> </xs:element>
该实例定义了一个"name"元素,whiteSpace限定为"collapse",表示XML会移除任何空白字符,与replace不同的是,换行、回车、空格以及制表符会被替换为空格,开头和结尾的空格会被移除,而多个连续的空格会被缩减为一个单一的空格:
<xs:element name="name"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:whiteSpace value="collapse"/> </xs:restriction> </xs:simpleType> </xs:element>
对长度的限定
元素中值的长度,通过length、maxLength以及minLength限定。
该实例定义了一个"username"元素,最小长度为5个字符,最大长度为12个字符:
<xs:element name="username"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:minLength value="5"/> <xs:maxLength value="12"/> </xs:restriction> </xs:simpleType> </xs:element>
数据类型的限定
enumeration | 定义可接受值的一个列表 |
fractionDigits | 定义所允许的最大的小数位数。必须大于等于0。 |
length | 定义所允许的字符或者列表项目的精确数目。必须大于或等于0。 |
maxExclusive | 定义数值的上限。所允许的值必须小于此值。 |
maxInclusive | 定义数值的上限。所允许的值必须小于或等于此值。 |
maxLength | 定义所允许的字符或者列表项目的最大数目。必须大于或等于0。 |
minExclusive | 定义数值的下限。所允许的值必需大于此值。 |
minInclusive | 定义数值的下限。所允许的值必需大于或等于此值。 |
minLength | 定义所允许的字符或者列表项目的最小数目。必须大于或等于0。 |
pattern | 定义可接受的字符的精确序列。 |
totalDigits | 定义所允许的阿拉伯数字的精确位数。必须大于0。 |
whiteSpace | 定义空白字符(换行、回车、空格以及制表符)的处理方式。 |