XSD 限定/Facets

ข้อจำกัด (restriction) ใช้เพื่อกำหนดค่าที่ยอมรับได้สำหรับ XML องค์ประกอบหรืออาทิตย์

ข้อจำกัดค่า

ตัวอย่างดังนี้กำหนดองค์ประกอบที่มีข้อจำกัดและมีชื่อว่า "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 โดยแต่ละตัวเลขต้องอยู่ในระหว่าง 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 定義空白字符（換行、回車、空格以及制表符）的處理方式。