.NET Framework 定義的標準文件中,對 XML 格式的描述都採用 XML Schema。由於 Schema 在許多方面展現出優勢,已有取代 DTD 的趨勢,值得花時間弄懂。以下直接進入語法主題。
XSDL(XML Schema 定義語言)由元素、屬性、命名空間與其他 XML 節點構成。
一份 XSD 文件至少要包含:schema 根元素、XML Schema 命名空間的定義,以及元素定義。
<xsd:schema xmlns:xsd="https://www.w3.org/2001/XMLSchema"> ... </xsd:schema>
XSD 中必須且只能定義一個 schema 根元素。根元素裡包含模式的約束、Schema 命名空間定義、其他命名空間定義、版本資訊、語言資訊與若干屬性。
<xsd:element name="user" type="xsd:string" />
name 是元素名稱,type 是元素值的型別,可以是 Schema 內建的資料型別或其他型別。
<xsd:schema xmlns:xsd="https://www.w3.org/2001/XMLSchema"> <xsd:element name="user" type="xsd:string" /> </xsd:schema> <!-- 對應的有效 XML --> <?XML version="1.0"?> <user>string</user>
元素定義另有兩個常用屬性:minOccurs 定義該元素在父元素中出現的最少次數(預設 1,值為 0 以上的整數),maxOccurs 定義最多次數(預設 1,也可設為 unbounded 代表不限次數)。
<xsd:element name="user" type="xsd:string" minOccurs="0" maxOccurs="unbounded" />
這表示 user 型別為 string,出現次數最少 0 次(即可選),最多不限。
<xsd:schema xmlns:xsd="https://www.w3.org/2001/XMLSchema"> <xsd:element name="user" type="xsd:string" /> <xsd:element name="name"> <xsd:complexType> <xsd:sequence> <xsd:element ref="user" /> </xsd:sequence> </xsd:complexType> </xsd:element> </xsd:schema>
引用透過 element 標記的 ref 屬性達成,主要目的是避免在同一份文件中重複定義同一個元素。實務上的建議是:把常用元素定義為根元素的子元素,這樣文件任何位置都能引用它。
你也可以為已定義的元素取一個別名,做法是加上 substitutionGroup 屬性:
<xsd:element name="yonghu" type="xsd:string" substitutionGroup="user" /> <xsd:element name="user" type="xsd:string" />
這樣一來,原本寫 <user>string</user> 的位置,也可以寫成 <yonghu>string</yonghu>,兩者都通過驗證。
<xsd:element name="city" type="xsd:string" default="xian" /> <xsd:element name="country" type="xsd:string" fixed="china" />
default 在文件中未提供 city 時給一個預設值;fixed 則把 country 鎖定為 china,不允許改變。
sequence——元素必須依指定順序出現(若為可選則可不出現):
<xsd:element name="name"> <xsd:complexType> <xsd:sequence> <xsd:element name="first" type="xsd:string" /> <xsd:element name="middle" type="xsd:string" /> <xsd:element name="last" type="xsd:string" /> </xsd:sequence> </xsd:complexType> </xsd:element>
all——允許子元素以任意順序出現,預設每個都必須出現且最多一次:
<xsd:all minOccurs="0"> <xsd:element name="first" type="xsd:string" /> <xsd:element name="middle" type="xsd:string" /> <xsd:element name="last" type="xsd:string" /> </xsd:all>
choice——只能出現其中一組,用於互斥情境:
<xsd:choice> <xsd:element name="first" type="xsd:string" /> <xsd:element name="middle" type="xsd:string" /> <xsd:element name="last" type="xsd:string" /> </xsd:choice>
屬性的定義方式與元素類似,但限制更多:只能是簡單型別、只能包含文字、不能有子屬性。attribute 元素可用的屬性如下:
其中 default、fixed、name、ref、type 的意義與 element 中相同,但 type 只能是簡單型別。use 的取值有三種:optional(非必填,預設值)、required(強制)、prohibited(禁止使用)。
<xsd:attribute name="age" type="xsd:integer" />
這定義了一個名為 age、值必須為整數的屬性。要把它放進模式中,它必須是 schema、complexType 或 attributeGroup 元素的子元素。
<xsd:schema xmlns:xsd="https://www.w3.org/2001/XMLSchema"> <xsd:element name="name"> <xsd:complexType> <xsd:sequence> <xsd:element name="first" type="xsd:string" /> </xsd:sequence> <xsd:attribute name="age" type="xsd:integer" use="optional" /> </xsd:complexType> </xsd:element> </xsd:schema> <!-- 對應的有效 XML --> <?XML version="1.0"?> <name age="27"> <first>string</first> </name>
關鍵細節:要把屬性掛在元素上,attribute 必須定義在 complexType 中、且放在組合器之後。