Latest web development tutorials

XML Schema 限定/ 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 定義空白字符（換行、回車、空格以及製表符）的處理方式。