XML Schema 限定 / Facets

2018-02-24 17:56 更新

XSD 限定 / Facets

你可以為 XML 中的元素或?qū)傩远x限定值。

限定(restriction)用于為 XML 元素或者屬性定義可接受的值。對(duì) XML 元素的限定被稱為 facet。


對(duì)值的限定

下面的例子定義了帶有一個(gè)限定且名為 "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>


對(duì)一組值的限定

如需把 XML 元素的內(nèi)容限制為一組可接受的值,我們要使用枚舉約束(enumeration constraint)。

下面的例子定義了帶有一個(gè)限定的名為 "car" 的元素??山邮艿闹抵挥校篈udi, 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" 可被其他元素使用,因?yàn)樗皇?"car" 元素的組成部分。


對(duì)一系列值的限定

如需把 XML 元素的內(nèi)容限制定義為一系列可使用的數(shù)字或字母,我們要使用模式約束(pattern constraint)。

下面的例子定義了帶有一個(gè)限定的名為 "letter" 的元素??山邮艿闹抵挥行懽帜?a - z 其中的一個(gè):

<xs:element name="letter">
  <xs:simpleType>
    <xs:restriction base="xs:string">
      <xs:pattern value="[a-z]"/>
    </xs:restriction>
  </xs:simpleType>
</xs:element>

下一個(gè)例子定義了帶有一個(gè)限定的名為 "initials" 的元素??山邮艿闹凳谴髮懽帜?A - Z 其中的三個(gè):

<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>

下一個(gè)例子也定義了帶有一個(gè)限定的名為 "initials" 的元素??山邮艿闹凳谴髮懟蛐懽帜?a - z 其中的三個(gè):

<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>

下一個(gè)例子定義了帶有一個(gè)限定的名為 "choice 的元素??山邮艿闹凳亲帜?x, y 或 z 中的一個(gè):

<xs:element name="choice">
  <xs:simpleType>
    <xs:restriction base="xs:string">
      <xs:pattern value="[xyz]"/>
    </xs:restriction>
  </xs:simpleType>
</xs:element>

下一個(gè)例子定義了帶有一個(gè)限定的名為 "prodid" 的元素。可接受的值是五個(gè)阿拉伯?dāng)?shù)字的一個(gè)序列,且每個(gè)數(shù)字的范圍是 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>


對(duì)一系列值的其他限定

下面的例子定義了帶有一個(gè)限定的名為 "letter" 的元素??山邮艿闹凳?a - z 中零個(gè)或多個(gè)字母:

<xs:element name="letter">
  <xs:simpleType>
    <xs:restriction base="xs:string">
      <xs:pattern value="([a-z])*"/>
    </xs:restriction>
  </xs:simpleType>
</xs:element>

下面的例子定義了帶有一個(gè)限定的名為 "letter" 的元素。可接受的值是一對(duì)或多對(duì)字母,每對(duì)字母由一個(gè)小寫字母后跟一個(gè)大寫字母組成。舉個(gè)例子,"sToP"將會(huì)通過這種模式的驗(yàn)證,但是 "Stop"、"STOP" 或者 "stop" 無法通過驗(yàn)證:

<xs:element name="letter">
  <xs:simpleType>
    <xs:restriction base="xs:string">
      <xs:pattern value="([a-z][A-Z])+"/>
    </xs:restriction>
  </xs:simpleType>
</xs:element>

下面的例子定義了帶有一個(gè)限定的名為 "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>

下面的例子定義了帶有一個(gè)限定的名為 "password" 的元素??山邮艿闹凳怯?8 個(gè)字符組成的一行字符,這些字符必須是大寫或小寫字母 a - z 亦或數(shù)字 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>


對(duì)空白字符的限定

如需規(guī)定對(duì)空白字符(whitespace characters)的處理方式,我們需要使用 whiteSpace 限定。

下面的例子定義了帶有一個(gè)限定的名為 "address" 的元素。這個(gè) whiteSpace 限定被設(shè)置為 "preserve",這意味著 XML 處理器不會(huì)移除任何空白字符:

<xs:element name="address">
  <xs:simpleType>
    <xs:restriction base="xs:string">
      <xs:whiteSpace value="preserve"/>
    </xs:restriction>
  </xs:simpleType>
</xs:element>

這個(gè)例子也定義了帶有一個(gè)限定的名為 "address" 的元素。這個(gè) whiteSpace 限定被設(shè)置為 "replace",這意味著 XML 處理器將移除所有空白字符(換行、回車、空格以及制表符):

<xs:element name="address">
  <xs:simpleType>
    <xs:restriction base="xs:string">
      <xs:whiteSpace value="replace"/>
    </xs:restriction>
  </xs:simpleType>
</xs:element>

這個(gè)例子也定義了帶有一個(gè)限定的名為 "address" 的元素。這個(gè) whiteSpace 限定被設(shè)置為 "collapse",這意味著 XML 處理器將移除所有空白字符(換行、回車、空格以及制表符會(huì)被替換為空格,開頭和結(jié)尾的空格會(huì)被移除,而多個(gè)連續(xù)的空格會(huì)被縮減為一個(gè)單一的空格):

<xs:element name="address">
  <xs:simpleType>
    <xs:restriction base="xs:string">
      <xs:whiteSpace value="collapse"/>
    </xs:restriction>
  </xs:simpleType>
</xs:element>


對(duì)長度的限定

如需限制元素中值的長度,我們需要使用 length、maxLength 以及 minLength 限定。

本例定義了帶有一個(gè)限定且名為 "password" 的元素。其值必須精確到 8 個(gè)字符:

<xs:element name="password">
  <xs:simpleType>
    <xs:restriction base="xs:string">
      <xs:length value="8"/>
    </xs:restriction>
  </xs:simpleType>
</xs:element>

這個(gè)例子也定義了帶有一個(gè)限定的名為 "password" 的元素。其值最小為 5 個(gè)字符,最大為 8 個(gè)字符:

<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>


數(shù)據(jù)類型的限定

限定 描述
enumeration 定義可接受值的一個(gè)列表
fractionDigits 定義所允許的最大的小數(shù)位數(shù)。必須大于等于0。
length 定義所允許的字符或者列表項(xiàng)目的精確數(shù)目。必須大于或等于0。
maxExclusive 定義數(shù)值的上限。所允許的值必須小于此值。
maxInclusive 定義數(shù)值的上限。所允許的值必須小于或等于此值。
maxLength 定義所允許的字符或者列表項(xiàng)目的最大數(shù)目。必須大于或等于0。
minExclusive 定義數(shù)值的下限。所允許的值必需大于此值。
minInclusive 定義數(shù)值的下限。所允許的值必需大于或等于此值。
minLength 定義所允許的字符或者列表項(xiàng)目的最小數(shù)目。必須大于或等于0。
pattern 定義可接受的字符的精確序列。
totalDigits 定義所允許的阿拉伯?dāng)?shù)字的精確位數(shù)。必須大于0。
whiteSpace 定義空白字符(換行、回車、空格以及制表符)的處理方式。
以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)