XSD-5 Schema 面向对象之 simpleType

5 Schema 面向对象之简易元素 SimpleType

在已有的基础数据类型之上以某个基础数据类型为基础，然后添加一些限定，就像这样：

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

XSD 限定 / Facets
限定（restriction）用于为 XML 元素或者属性定义可接受的值。对 XML 元素的限定被称为 facet。
XSD Restrictions/Facets for Datatypes

对值的限定

限定	描述
enumeration	定义可接受值的一个列表
fractionDigits	定义所允许的最大的小数位数。必须大于等于0。
length	定义所允许的字符或者列表项目的精确数目。必须大于或等于0。
maxExclusive	定义数值的上限。所允许的值必须小于此值。
maxInclusive	定义数值的上限。所允许的值必须小于或等于此值。
maxLength	定义所允许的字符或者列表项目的最大数目。必须大于或等于0。
minExclusive	定义数值的下限。所允许的值必需大于此值。
minInclusive	定义数值的下限。所允许的值必需大于或等于此值。
minLength	定义所允许的字符或者列表项目的最小数目。必须大于或等于0。
pattern	定义可接受的字符的精确序列(正则匹配)。
totalDigits	定义所允许的阿拉伯数字的精确位数。必须大于0。
whiteSpace	定义空白字符（换行、回车、空格以及制表符）的处理方式。 preserve 不会移除任何空白字符， replace 移除所有空白字符（换行、回车、空格以及制表符）， collapse 移除所有空白字符（换行、回车、空格以及制表符会被替换为空格，开头和结尾的空格会被移除，而多个连续的空格会被缩减为一个单一的空格）

5.1 对值的限定 minInclusive maxInclusive

下面的例子定义了带有一个限定且名为 “age” 的元素。age 的值不能低于 0 或者高于 120：

<xs:element name="age" type="AgeType">

<xs:simpleType name="AgeType">
  <xs:restriction base="xs:integer">
    <xs:minInclusive value="0"/>
    <xs:maxInclusive value="120"/>
  </xs:restriction>
</xs:simpleType>

</xs:element> 

5.2 对一组值的限定 enumeration

如需把 XML 元素的内容限制为一组可接受的值，我们要使用枚举约束（enumeration constraint）。

下面的例子定义了带有一个限定的名为 “car” 的元素。可接受的值只有：Audi, Golf, BMW：

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

对应的枚举类型如下：

@XmlType(name = "carType")
@XmlEnum
public enum CarType {

    @XmlEnumValue("Audi")
    AUDI("Audi"),
    @XmlEnumValue("Golf")
    GOLF("Golf"),
    BMW("BMW");
    private final String value;

    CarType(String v) {
        value = v;
    }
    public String value() {
        return value;
    }
    public static CarType fromValue(String v) {
        for (CarType c: CarType.values()) {
            if (c.value.equals(v)) {
                return c;
            }
        }
        throw new IllegalArgumentException(v);
    }
}

5.3 对一系列值的限定 pattern

如需把 XML 元素的内容限制定义为一系列可使用的数字或字母，我们要使用模式约束（pattern constraint）。

下面的例子定义了带有一个限定的名为 “letter” 的元素。可接受的值只有小写字母 a - z 其中的一个：

<xs:element name="letter" type="LetterType">

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

</xs:element> 

可接受的值只有小写字母 a - z 其中的一个：
<xs:pattern value="[a-z]"/>
可接受的值是大写字母 A - Z 其中的三个：
<xs:pattern value="[A-Z][A-Z][A-Z]"/>
可接受的值是大写或小写字母 a - z 其中的三个：
<xs:pattern value="[a-zA-Z][a-zA-Z][a-zA-Z]"/>
可接受的值是字母 x, y 或 z 中的一个：
<xs:pattern value="[xyz]"/>
可接受的值是五个阿拉伯数字的一个序列，且每个数字的范围是 0-9：
<xs:pattern value="[0-9][0-9][0-9][0-9][0-9]"/>
可接受的值是 a - z 中零个或多个字母：
<xs:pattern value="([a-z])*"/>
可接受的值是一对或多对字母，每对字母由一个小写字母后跟一个大写字母组成。举个例子，"sToP"将会通过这种模式的验证，但是 “Stop”、“STOP” 或者 “stop” 无法通过验证：
<xs:pattern value="([a-z][A-Z])+"/>
可接受的值是 male 或者 female：
<xs:pattern value="male|female"/>
可接受的值是由 8 个字符组成的一行字符，这些字符必须是大写或小写字母 a - z 亦或数字 0 - 9：
<xs:pattern value="[a-zA-Z0-9]{8}"/>

5.4 对空白字符的限定 whiteSpace

如需规定对空白字符（whitespace characters）的处理方式，我们需要使用 whiteSpace 限定。

下面的例子定义了带有一个限定的名为 “address” 的元素。这个 whiteSpace 限定被设置为 “preserve”，这意味着 XML 处理器不会移除任何空白字符：

<xs:element name="address" type="AddressType">

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

</xs:element> 

这个 whiteSpace 限定被设置为 “preserve”，这意味着 XML 处理器不会移除任何空白字符：
<xs:whiteSpace value="preserve"/>
这个 whiteSpace 限定被设置为 “replace”，这意味着 XML 处理器将移除所有空白字符（换行、回车、空格以及制表符）：
<xs:whiteSpace value="replace"/>
这个 whiteSpace 限定被设置为 “collapse”，这意味着 XML 处理器将移除所有空白字符（换行、回车、空格以及制表符会被替换为空格，开头和结尾的空格会被移除，而多个连续的空格会被缩减为一个单一的空格）：
<xs:whiteSpace value="collapse"/>

5.5 对长度的限定 length

如需限制元素中值的长度，我们需要使用 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>

---

上一章：XSD-4 Schema 面向对象之基础数据类型
目录：学习 JAXB
下一章：XSD-6 Schema 面向对象之复合元素 complexType

---