# XSD 限定 / Facets 限定（restriction）用于為 XML 元素或者屬性定義可接受的值。對 XML 元素的限定被稱為 facet。 ## 對值的限定 下面的例子定義了帶有一個限定且名為 "age" 的元素。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 元素的內容限制為一組可接受的值，我們要使用枚舉約束（enumeration constraint）。 下面的例子定義了帶有一個限定的名為 "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 元素的內容限制定義為一系列可使用的數字或字母，我們要使用模式約束（pattern constraint）。 下面的例子定義了帶有一個限定的名為 "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" 的元素。可接受的值是由 8 個字符組成的一行字符，這些字符必須是大寫或小寫字母 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 characters）的處理方式，我們需要使用 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" 的元素。其值必須精確到 8 個字符： ``` <xs:element name="password"> ? <xs:simpleType> ??? <xs:restriction base="xs:string"> ????? <xs:length value="8"/> ??? </xs:restriction> ? </xs:simpleType> </xs:element> ``` 這個例子也定義了帶有一個限定的名為 "password" 的元素。其值最小為 5 個字符，最大為 8 個字符： ``` <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 | 定義所允許的最大的小數位數。必須大于等于0。 | | length | 定義所允許的字符或者列表項目的精確數目。必須大于或等于0。 | | maxExclusive | 定義數值的上限。所允許的值必須小于此值。 | | maxInclusive | 定義數值的上限。所允許的值必須小于或等于此值。 | | maxLength | 定義所允許的字符或者列表項目的最大數目。必須大于或等于0。 | | minExclusive | 定義數值的下限。所允許的值必需大于此值。 | | minInclusive | 定義數值的下限。所允許的值必需大于或等于此值。 | | minLength | 定義所允許的字符或者列表項目的最小數目。必須大于或等于0。 | | pattern | 定義可接受的字符的精確序列。 | | totalDigits | 定義所允許的阿拉伯數字的精確位數。必須大于0。 | | whiteSpace | 定義空白字符（換行、回車、空格以及制表符）的處理方式。 |