XSD詳解二 - 簡易元素、屬性、內容限定


一、XSD 簡易元素

XML Schema 可定義 XML 文件的元素。

簡易元素指那些只包含文本的元素。它不會包含任何其他的元素或屬性。

1、什么是簡易元素?

簡易元素指那些僅包含文本的元素。它不會包含任何其他的元素或屬性。

不過,“僅包含文本”這個限定卻很容易造成誤解。文本有很多類型。它可以是 XML Schema 定義中包括的類型中的一種(布爾、字符串、數據等等),或者它也可以是您自行定義的定制類型。

 

2、定義簡易元素

定義簡易元素的語法:

<xs:element name="xxx" type="yyy"/>

 此處 xxx 指元素的名稱,yyy 指元素的數據類型。XML Schema 擁有很多內建的數據類型。

最常用的類型是:

  • xs:string
  • xs:decimal
  • xs:integer
  • xs:boolean
  • xs:date
  • xs:time

例子:

這是一些 XML 元素:

<lastname>Smith</lastname>
<age>28</age>
<dateborn>1980-03-27</dateborn>

 這是相應的簡易元素定義:

<xs:element name="lastname" type="xs:string"/>
<xs:element name="age" type="xs:integer"/>
<xs:element name="dateborn" type="xs:date"/> 

 

3、簡易元素的默認值和固定值

簡易元素可擁有指定的默認值或固定值。

當沒有其他的值被規定時,默認值就會自動分配給元素。

在下面的例子中,缺省值是 "red":

<xs:element name="color" type="xs:string" default="red"/>

 固定值同樣會自動分配給元素,並且您無法規定另外一個值。

在下面的例子中,固定值是 "red":

<xs:element name="color" type="xs:string" fixed="red"/>

 

二、XSD 屬性

 所有的屬性均作為簡易類型來聲明。 

1、什么是屬性?

簡易元素無法擁有屬性。假如某個元素擁有屬性,它就會被當作某種復合類型,復合元素將在下節中進行介紹。但是屬性本身總是作為簡易類型被聲明的。

 

2、如何聲明屬性?

定義屬性的語法是:

<xs:attribute name="xxx" type="yyy"/>

 在此處,xxx 指屬性名稱,yyy 則規定屬性的數據類型。XML Schema 擁有很多內建的數據類型。

 實例

這是帶有屬性的 XML 元素:

<lastname lang="EN">Smith</lastname>

這是對應的屬性定義:

<xs:attribute name="lang" type="xs:string"/>

 

3、屬性的默認值和固定值

屬性可擁有指定的默認值或固定值。

當沒有其他的值被規定時,默認值就會自動分配給元素。

在下面的例子中,缺省值是 "EN":

<xs:attribute name="lang" type="xs:string" default="EN"/>

固定值同樣會自動分配給元素,並且您無法規定另外的值。

在下面的例子中,固定值是 "EN":

<xs:attribute name="lang" type="xs:string" fixed="EN"/>

 

4、可選的和必需的屬性

在缺省的情況下,屬性是可選的。如需規定屬性為必選,請使用 "use" 屬性:

<xs:attribute name="lang" type="xs:string" use="required"/>

 

5、內建數據類型

因為屬性本身是作為簡易類型被聲明的,所以屬性的內建數據類型根元素是simpleType。

具體使用可以在參考手冊中查閱,就不一一細說。

實例:

<xs:element name="person">
        <xs:complexType>
            <xs:attribute type="t_sex" name="sex"/>
        </xs:complexType>
    </xs:element>
    
    <xs:simpleType name="t_sex">
        <xs:restriction>
            <xs:pattern value="man|woman"/>
        </xs:restriction>
    </xs:simpleType>

 

三、對內容的限定

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

假如 XML 元素的類型是 "xs:date",而其包含的內容是類似 "Hello World" 的字符串,元素將不會(通過)驗證。 

1、數據類型的限定

限定 描述

enumeration

定義可接受值的一個列表

<xs:enumeration value="a"/>
<xs:enumeration value="b"/>
<xs:enumeration value="c"/>

fractionDigits

定義所允許的最大的小數位數。必須大於等於0。

<xs:restriction base="xs:decimal">
<xs:fractionDigits value="2"/>
</xs:restriction>

length

定義所允許的字符或者列表項目的精確數目。必須大於或等於0。

<xs:length value="8"/>

maxExclusive

定義數值的上限。所允許的值必須小於此值。

<xs:maxExclusive value="8"/>

maxInclusive

定義數值的上限。所允許的值必須小於或等於此值。

maxLength

定義所允許的字符或者列表項目的最大數目。必須大於或等於0。

minExclusive

定義數值的下限。所允許的值必需大於此值。

minInclusive

定義數值的下限。所允許的值必需大於或等於此值。

minLength

定義所允許的字符或者列表項目的最小數目。必須大於或等於0。

pattern

定義可接受的字符的精確序列。類似正則表達式

<xs:pattern value="[a-zA-Z0-9]{8}"/>

totalDigits

定義所允許的阿拉伯數字的精確位數。必須大於0。

whiteSpace

定義空白字符(換行、回車、空格以及制表符)的處理方式。

preserve - 不會移除任何空白字符
replace - 移除所有空白字符(換行、回車、空格以及制表符)
collapse - 移除所有空白字符(換行、回車、空格以及制表符會被替換為空格,開頭和結尾的空格會被移除,而多個連續的空格會被縮減為一個單一的空格)
<xs:whiteSpace value="preserve"/>

 

2、兩種不同的寫法

下面的例子定義了帶有一個限定的名為 "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" 元素的組成部分。

 

3、部分類型的限定示例

對值的限定

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

 

對一系列值的限定

如需把 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> 

  

參考地址:http://www.w3school.com.cn/schema/schema_facets.asp

轉載請注明出處:http://www.cnblogs.com/cjh-notes/p/7989468.html

 

 

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM