zoukankan      html  css  js  c++  java

  • XML Schema

    XSD文档至少要包含：schema根元素和XML模式命名空间的定义、元素定义。需要注意的是XSD中必须定义一个且只能定义一个schema根元素，根元素中包括模式的约束，XML模式命名空间的定义，其他命名空间的定义、版本信息、语言信息和其他一些信息。

    　　1、schema根元素

    　　语法如下：

    <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  ...
</xsd:schema>

    　　2、元素

    　　语法如下：

    <xsd:element name="user" type="xsd:string" />

    　　XSD中元素是利用element标识符来声明，在上面的示例中name属性是元素的名字，type属性是元素值的类型，可以使XML Schema中内置的数据类型或其他类型。

    　　全部元素如下：

    元素 说明
    name 元素的名称
    type 元素值的类型
    minOccurs 该元素在父元素中最少出现的次数(默认为1，必须大于等于0)
    maxOccurs 该元素在父元素中最多出现的次数(默认为1，必须大于等于0)，当设置为unbounded表示不限制。

    　　3、引用元素

    　　引用元素是利用element标记符的ref属性实现的。主要适用于避免在文档中多次定义同一个元素。表示当前元素与被引用的元素相同。

    　　语法如下：

    <xsd:element name="user" type="xsd:string" />
<xsd:sequence>
    <xsd:element ref="user" />　　<!--当前元素就是user元素-->
</xsd:sequence>

    　　4、别名

    　　别名主要利用element标识符中的属性substitutionGroup实现的。

    　　语法：

    <xsd:element name="user" type="xsd:string" substitutionGroup="yonghu" />

    　　该语句表示该行的元素名可以是user或用户，如：

    <yonghu>admin</yonghu>
<user>admin</user>

    　　这两行xml都是符合条件的。

    　　5、设置默认值与固定值

    　　语法如下：

    <xsd:element name="city" type="xsd:string" default="xian" />
<xsd:element name="country" type="xsd:string" fixed="china" />

    　　通过default属性的设置，可以在XML文档中没有对city定义时赋予默认值，而是用fixed属性，可以给元素country设定一个固定的值china，并且不允许改变。

    　　6、利用组合器控制结构

    　　1、sequence组合器，定义了一列元素必须按照模式中指定的顺序显示(如果是可选的，也可以不显示)。

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

    　　2、all组合器，允许所定义的元素可以按照任意顺序显示，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>

    　　　　(3)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>

    　　7、定义属性

    　　在XML Schema文档中可以按照定义元素的方法定义属性，但受限制程度较高。可以应用在attribute元素定义中的属性如下表所示。

    属性 含义
    defalt 初始默认值
    fixed 不能修改和覆盖的固定属性值
    name 属性的名称
    ref 对前一个属性定义的引用
    type 该属性的XSD类型或者简单类型
    use 如何使用属性 optional(可选属性，即属性不是必须的，默认是这个)、prohibited(禁止使用)或者required(强制必须)。
    form 确定attributeFormDefault的本地址
    id 模式文档中属性唯一的ID

    　　8、创建属性

    　　语法如下：

    <xsd:attribute name="age" type="xsd:integer" />

    　　该语句定义了一个名为age的属性，它的值必须为整数。把它添加到模式中时，它必须是schema元素，complexType元素或者attributeGroup元素的子元素。

    　　代码示例：

    复制代码
    <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" />　　　<!--将属性添加到元素name属性中-->　　
　　</xsd:complexType>
</xsd:element>
    复制代码

    　　以上文档对应有效的XML文档如下：

    <?xml version="1.0"?>
<name age="27">
　　<first>string</first>
</name>

    　　该示例不但说明了如下约束属性，还展示了组合器的用法。

    三、XML Schema数据类型

    　　1、Schema基本数据类型

    　　Schema的基本数据类型如下：

    数据类型 说明
    boolean true/false
    datetime 格式:CCYY-MM-DDThh:mm:ss
    decimal 任意精度的十进制数字
    string 字符串数据
    int 整型
    nonNegativeInteger 大于或等于0的整型
    nonPositiveInteger 小于或等于0的整型
    short 短整型 -32768到32767

    　　2、约束

    　　内置的数据类型功能虽然已经有一定的限制功能，但是还是远远不足够的，更进一步的约束还是来看看约束。

    约束 说明
    enumeration 用空格分开的一组指定的数值，它把数据类型约束为指定的值
    fractionDigit 指定小数点后的最大位数
    length 长度单位
    minExclusive 下限值
    maxExclusive 上限值
    minLength 最小长度单位
    maxLength 最大长度单位
    minInclusive 最小值，所有的值都应该大于或等于该值
    maxInclusive 最大值，所有的值都应该小于或等于该值
    pattern 数据类型的值必须匹配的指定模式，必须是一个正则表达式
    totalDigits 指定小数最大位数的值
    whiteSpace 其值为preserve(值中的空格不能改变)、replace(所有的制表符、换行符、回车符都用空格代替)、collapse(执行replace，删除相邻的、结尾处和开头处的空格)。

    　　要使用上面约束表的约束，就要利用元素restriction。这个元素中有两个属性：ID属性是模式文档中restriction元素的位置标识符；base属性设置为一个内置的XSD数据类型或者现有的简单类型定义，它是一种被限制的类型。

    　　示例：将一个整数的取值范围设置为1~100之间。

    <xsd:restriction base="xsd:int">
　　<xsd:minInclusive value="1" />
　　<xsd:maxInclusive value="100" />
</xsd:restriction>

    　　3、简单类型

    　　简单类型是对一个节点的可能值进一步限制的自定义数据类型。创建简单类型需要利用simpleType元素，其定义如下：

    <simpleType id="ID" name="NCName" final="(#all|((list|union|restriction)))" />

    　　ID属性应唯一地标明文档内的simpleType元素，name不能使用冒号字符。simpleType不能包含元素，也不能有属性，它基本上是一个值，或者是一个值的集合。

    　　例如：　　

    复制代码
    <xsd:simpleType name="USState">
　　<xsd:restriction base="xsd:string">
　　　　<xsd:enumeration value="AK">
　　　　<xsd:enumeration value="AL">
　　　　<xsd:enumeration value="AR">
　　</xsd:restriction>
</xsd:simpleType>
<xsd:element name="statement" type="USState" />
    复制代码

    　　以上文档对应有效的xml文档如下：

    <statement>AK</statement>　　

    　　注意取值只能够为AK、AR、AL中的一个。

    　　4、列表类型

    　　list可以用来定义列表类型。

    <xsd:simpleType name="listOfIntType">
　　<xsd:list itemType="Integer"/>
</xsd:simpleType>
<xsd:element name="listOfMyInt" type="listOfType"/>

    　　listIfIntType这个类型被定义为一个Integet的列表，元素listOfMyInt的值可以是几个整数，他们之间用空格分开。

    　　有效的xml文档如下：

    <listOfMyInt>1 2 3 123</listOfMyInt>

    　　5、联合类型

    　　union可以用来定义一个联合类型。例如：

    <xsd:simpleType name="zipUnion">
　　<xsd:union memberTypes="USState listOfMyIntType"/>
</xsd:simpleType>
<xsd:element name="zips" type="zipUnion"/>

    　　用union来定义一个联合类型，里面的成员类型保罗USState和listOfMyIntType，应用了联合类型的元素的值可以是这些原子类型或列表类型中的一个类型的示例，但是一个元素实例不能同时包含两个类型。

    　　有效的XML文档如下：

    <zips>CA</zips>
<zips>9192 192391 129</zips>
<zips>AK</zips>

    　　无效的XML文档如下：

    <zips>AL 2231</zips>

    　　同时包含两个是错误的。

    　　6、匿名类型

    　　前面定义元素类型的时候总是先定义一个数据类型，然后再把元素的type设成新定义的数据类型。如果这个新的数据类型只会用一次，我们就可以直接设置在元素定义里面，而不用另外来设置。

    　　例如：

    复制代码
    　　<xsd:element name="quantity">
　　　　<xsd:simpleType>
　　　　　　<xsd:restriction base="xsd:positiveInteger">
　　　　　　    <xsd:maxExclusive value="100"/>
　　　　　　</xsd:restriction>
　　　　</xsd:simpleType>
　　</xsd:element>
    复制代码

    　　元素quantity的类型就是一个从1~99的整数。对于这种没有用type引入，直接定义在element元素里面的类型，我们称之为匿名类型。

    　　7、复杂类型

    　　复杂类型的定义必须使用complexType元素，在这里可以包含属性和元素。在复杂类型的使用中，主要是complexType和simpleType配合使用。

    　　8、内容模型

    　　内容模型可以对在XML文档内使用的元素、属性和类型进行限制，确定用户可以再XML实例的那些等级添加自己的元素和属性。

    　　1、any内容模型

    　　在XML中声明元素时，any是默认的内容模型，该模型可以包含文本、元素和空格。

    　　例如：

    复制代码
    <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <xsd:element name="name">
    <xsd:complexType>
      <xsd:sequence>
        <xsd:element name="first" type="xsd:string" />
        <xsd:element name="middle" type="OtherNames" />
        <xsd:element name="last" type="xsd:string" />
      </xsd:sequence>
    </xsd:complexType>
  </xsd:element>
  <xsd:complexType name="OtherNames">
    <xsd:sequence>
      <xsd:any namespace="##any" processContents="lax" minOccurs="0" maxOccurs="unbounded" />
    </xsd:sequence>
  </xsd:complexType>
</xsd:schema>
    复制代码

    　　例子中xsd:any元素说明该类型允许添加内容。

    XSD文档至少要包含：schema根元素和XML模式命名空间的定义、元素定义。需要注意的是XSD中必须定义一个且只能定义一个schema根元素，根元素中包括模式的约束，XML模式命名空间的定义，其他命名空间的定义、版本信息、语言信息和其他一些信息。

    　　1、schema根元素

    　　语法如下：

    <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  ...
</xsd:schema>

    　　2、元素

    　　语法如下：

    <xsd:element name="user" type="xsd:string" />

    　　XSD中元素是利用element标识符来声明，在上面的示例中name属性是元素的名字，type属性是元素值的类型，可以使XML Schema中内置的数据类型或其他类型。

    　　全部元素如下：

    元素 说明
    name 元素的名称
    type 元素值的类型
    minOccurs 该元素在父元素中最少出现的次数(默认为1，必须大于等于0)
    maxOccurs 该元素在父元素中最多出现的次数(默认为1，必须大于等于0)，当设置为unbounded表示不限制。

    　　3、引用元素

    　　引用元素是利用element标记符的ref属性实现的。主要适用于避免在文档中多次定义同一个元素。表示当前元素与被引用的元素相同。

    　　语法如下：

    <xsd:element name="user" type="xsd:string" />
<xsd:sequence>
    <xsd:element ref="user" />　　<!--当前元素就是user元素-->
</xsd:sequence>

    　　4、别名

    　　别名主要利用element标识符中的属性substitutionGroup实现的。

    　　语法：

    <xsd:element name="user" type="xsd:string" substitutionGroup="yonghu" />

    　　该语句表示该行的元素名可以是user或用户，如：

    <yonghu>admin</yonghu>
<user>admin</user>

    　　这两行xml都是符合条件的。

    　　5、设置默认值与固定值

    　　语法如下：

    <xsd:element name="city" type="xsd:string" default="xian" />
<xsd:element name="country" type="xsd:string" fixed="china" />

    　　通过default属性的设置，可以在XML文档中没有对city定义时赋予默认值，而是用fixed属性，可以给元素country设定一个固定的值china，并且不允许改变。

    　　6、利用组合器控制结构

    　　1、sequence组合器，定义了一列元素必须按照模式中指定的顺序显示(如果是可选的，也可以不显示)。

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

    　　2、all组合器，允许所定义的元素可以按照任意顺序显示，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>

    　　　　(3)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>

    　　7、定义属性

    　　在XML Schema文档中可以按照定义元素的方法定义属性，但受限制程度较高。可以应用在attribute元素定义中的属性如下表所示。

    属性 含义
    defalt 初始默认值
    fixed 不能修改和覆盖的固定属性值
    name 属性的名称
    ref 对前一个属性定义的引用
    type 该属性的XSD类型或者简单类型
    use 如何使用属性 optional(可选属性，即属性不是必须的，默认是这个)、prohibited(禁止使用)或者required(强制必须)。
    form 确定attributeFormDefault的本地址
    id 模式文档中属性唯一的ID

    　　8、创建属性

    　　语法如下：

    <xsd:attribute name="age" type="xsd:integer" />

    　　该语句定义了一个名为age的属性，它的值必须为整数。把它添加到模式中时，它必须是schema元素，complexType元素或者attributeGroup元素的子元素。

    　　代码示例：

    复制代码
    <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" />　　　<!--将属性添加到元素name属性中-->　　
　　</xsd:complexType>
</xsd:element>
    复制代码

    　　以上文档对应有效的XML文档如下：

    <?xml version="1.0"?>
<name age="27">
　　<first>string</first>
</name>

    　　该示例不但说明了如下约束属性，还展示了组合器的用法。

    三、XML Schema数据类型

    　　1、Schema基本数据类型

    　　Schema的基本数据类型如下：

    数据类型 说明
    boolean true/false
    datetime 格式:CCYY-MM-DDThh:mm:ss
    decimal 任意精度的十进制数字
    string 字符串数据
    int 整型
    nonNegativeInteger 大于或等于0的整型
    nonPositiveInteger 小于或等于0的整型
    short 短整型 -32768到32767

    　　2、约束

    　　内置的数据类型功能虽然已经有一定的限制功能，但是还是远远不足够的，更进一步的约束还是来看看约束。

    约束 说明
    enumeration 用空格分开的一组指定的数值，它把数据类型约束为指定的值
    fractionDigit 指定小数点后的最大位数
    length 长度单位
    minExclusive 下限值
    maxExclusive 上限值
    minLength 最小长度单位
    maxLength 最大长度单位
    minInclusive 最小值，所有的值都应该大于或等于该值
    maxInclusive 最大值，所有的值都应该小于或等于该值
    pattern 数据类型的值必须匹配的指定模式，必须是一个正则表达式
    totalDigits 指定小数最大位数的值
    whiteSpace 其值为preserve(值中的空格不能改变)、replace(所有的制表符、换行符、回车符都用空格代替)、collapse(执行replace，删除相邻的、结尾处和开头处的空格)。

    　　要使用上面约束表的约束，就要利用元素restriction。这个元素中有两个属性：ID属性是模式文档中restriction元素的位置标识符；base属性设置为一个内置的XSD数据类型或者现有的简单类型定义，它是一种被限制的类型。

    　　示例：将一个整数的取值范围设置为1~100之间。

    <xsd:restriction base="xsd:int">
　　<xsd:minInclusive value="1" />
　　<xsd:maxInclusive value="100" />
</xsd:restriction>

    　　3、简单类型

    　　简单类型是对一个节点的可能值进一步限制的自定义数据类型。创建简单类型需要利用simpleType元素，其定义如下：

    <simpleType id="ID" name="NCName" final="(#all|((list|union|restriction)))" />

    　　ID属性应唯一地标明文档内的simpleType元素，name不能使用冒号字符。simpleType不能包含元素，也不能有属性，它基本上是一个值，或者是一个值的集合。

    　　例如：　　

    复制代码
    <xsd:simpleType name="USState">
　　<xsd:restriction base="xsd:string">
　　　　<xsd:enumeration value="AK">
　　　　<xsd:enumeration value="AL">
　　　　<xsd:enumeration value="AR">
　　</xsd:restriction>
</xsd:simpleType>
<xsd:element name="statement" type="USState" />
    复制代码

    　　以上文档对应有效的xml文档如下：

    <statement>AK</statement>　　

    　　注意取值只能够为AK、AR、AL中的一个。

    　　4、列表类型

    　　list可以用来定义列表类型。

    <xsd:simpleType name="listOfIntType">
　　<xsd:list itemType="Integer"/>
</xsd:simpleType>
<xsd:element name="listOfMyInt" type="listOfType"/>

    　　listIfIntType这个类型被定义为一个Integet的列表，元素listOfMyInt的值可以是几个整数，他们之间用空格分开。

    　　有效的xml文档如下：

    <listOfMyInt>1 2 3 123</listOfMyInt>

    　　5、联合类型

    　　union可以用来定义一个联合类型。例如：

    <xsd:simpleType name="zipUnion">
　　<xsd:union memberTypes="USState listOfMyIntType"/>
</xsd:simpleType>
<xsd:element name="zips" type="zipUnion"/>

    　　用union来定义一个联合类型，里面的成员类型保罗USState和listOfMyIntType，应用了联合类型的元素的值可以是这些原子类型或列表类型中的一个类型的示例，但是一个元素实例不能同时包含两个类型。

    　　有效的XML文档如下：

    <zips>CA</zips>
<zips>9192 192391 129</zips>
<zips>AK</zips>

    　　无效的XML文档如下：

    <zips>AL 2231</zips>

    　　同时包含两个是错误的。

    　　6、匿名类型

    　　前面定义元素类型的时候总是先定义一个数据类型，然后再把元素的type设成新定义的数据类型。如果这个新的数据类型只会用一次，我们就可以直接设置在元素定义里面，而不用另外来设置。

    　　例如：

    复制代码
    　　<xsd:element name="quantity">
　　　　<xsd:simpleType>
　　　　　　<xsd:restriction base="xsd:positiveInteger">
　　　　　　    <xsd:maxExclusive value="100"/>
　　　　　　</xsd:restriction>
　　　　</xsd:simpleType>
　　</xsd:element>
    复制代码

    　　元素quantity的类型就是一个从1~99的整数。对于这种没有用type引入，直接定义在element元素里面的类型，我们称之为匿名类型。

    　　7、复杂类型

    　　复杂类型的定义必须使用complexType元素，在这里可以包含属性和元素。在复杂类型的使用中，主要是complexType和simpleType配合使用。

    　　8、内容模型

    　　内容模型可以对在XML文档内使用的元素、属性和类型进行限制，确定用户可以再XML实例的那些等级添加自己的元素和属性。

    　　1、any内容模型

    　　在XML中声明元素时，any是默认的内容模型，该模型可以包含文本、元素和空格。

    　　例如：

    复制代码
    <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <xsd:element name="name">
    <xsd:complexType>
      <xsd:sequence>
        <xsd:element name="first" type="xsd:string" />
        <xsd:element name="middle" type="OtherNames" />
        <xsd:element name="last" type="xsd:string" />
      </xsd:sequence>
    </xsd:complexType>
  </xsd:element>
  <xsd:complexType name="OtherNames">
    <xsd:sequence>
      <xsd:any namespace="##any" processContents="lax" minOccurs="0" maxOccurs="unbounded" />
    </xsd:sequence>
  </xsd:complexType>
</xsd:schema>
    复制代码

    　　例子中xsd:any元素说明该类型允许添加内容。

    <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:element name="config">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="module" type="moduleDeclaration" minOccurs="1" maxOccurs="unbounded" />
            </xs:sequence>
        </xs:complexType>
        <xs:unique name="uniqueModuleName">
            <xs:annotation>
                <xs:documentation>
                    Module name must be unique.
                </xs:documentation>
            </xs:annotation>
            <xs:selector xpath="module"/>
            <xs:field xpath="@name"/>
        </xs:unique>
    </xs:element>

    <xs:complexType name="moduleDeclaration">
        <xs:annotation>
            <xs:documentation>
                Module declaration.
            </xs:documentation>
        </xs:annotation>
        <xs:all>
            <xs:element minOccurs="0" maxOccurs="1" name="sequence" type="moduleSequence">
                <xs:unique name="uniqueSequenceName">
                    <xs:annotation>
                        <xs:documentation>
                            Dependency name must be unique.
                        </xs:documentation>
                    </xs:annotation>
                    <xs:selector xpath=".//*" />
                    <xs:field xpath="@name" />
                </xs:unique>
            </xs:element>
        </xs:all>
        <xs:attribute name="name" type="moduleName" use="required" />
        <xs:attribute name="setup_version" type="setupVersion" use="required" />
    </xs:complexType>

    <xs:complexType name="moduleSequence">
        <xs:annotation>
            <xs:documentation>
                Module dependency root element.
            </xs:documentation>
        </xs:annotation>
        <xs:sequence maxOccurs="unbounded">
            <xs:element minOccurs="0" maxOccurs="unbounded" name="module">
                <xs:complexType>
                    <xs:annotation>
                        <xs:documentation>
                            Module dependency that represents another module.
                        </xs:documentation>
                    </xs:annotation>
                    <xs:attribute name="name" type="moduleName" use="required" />
                </xs:complexType>
            </xs:element>
        </xs:sequence>
    </xs:complexType>

    <xs:simpleType name="moduleName">
        <xs:annotation>
            <xs:documentation>
                Module name attribute can contain only [A-Za-z0-9_].
            </xs:documentation>
        </xs:annotation>
        <xs:restriction base="xs:string">
            <xs:pattern value="[A-Z]+[A-Za-z0-9]{1,}_[A-Z]+[A-Z0-9a-z]{1,}" />
        </xs:restriction>
    </xs:simpleType>

    <xs:simpleType name="setupVersion">
        <xs:annotation>
            <xs:documentation>
                Schema version attribute can contain only [0-9.].
            </xs:documentation>
        </xs:annotation>
        <xs:restriction base="xs:string">
            <xs:pattern value="[0-9.]+" />
        </xs:restriction>
    </xs:simpleType>
</xs:schema>
    作者：冯亮
    　　　　 　　　　
    能力有限，水平一般。如有错误，欢迎指正
  • 相关阅读:
    nmap扫描工具
    cobbler全自动批量安装部署linux
    使用ngxtop实时监控nginx
    Nginx 错误汇总
    定制sudo的密码保持时间以及如何不需要密码
    解决eclipse中出现Resource is out of sync with the file system问题
    log4j:ERROR Category option " 1 " not a decimal integer.错误解决
    properties文件中中文不能显示或者中文乱码
    Log4j使用总结
    eclipse, Log4j配置（真心的详细～）
  • 原文地址：https://www.cnblogs.com/fengliang/p/6734184.html
Copyright © 2011-2022 走看看