XML Schema 字符串数据类型及约束详解

原创

小万哥

发布于 2024-05-24 20:29:23

1310

发布于 2024-05-24 20:29:23

文章被收录于专栏：程序人生丶

字符串数据类型用于包含字符字符串的值。字符串数据类型可以包含字符、换行符、回车符和制表符。

以下是模式中字符串声明的示例：

<xs:element name="customer" type="xs:string"/>

您文档中的一个元素可能如下所示：

<customer>John Smith</customer>

或者可能是这样的：

<customer>       John Smith     </customer>

注意：如果使用字符串数据类型，XML 处理器将不会修改值。

NormalizedString 数据类型

normalizedString 数据类型派生自 String 数据类型。

normalizedString 数据类型也包含字符，但 XML 处理器将删除换行符、回车符和制表符。

以下是模式中 normalizedString 声明的示例：

<xs:element name="customer" type="xs:normalizedString"/>

您文档中的一个元素可能如下所示：

<customer>John Smith</customer>

或者可能是这样的：

<customer>     John Smith     </customer>

注意：在上面的示例中，XML 处理器将用空格替换制表符。

Token 数据类型

token 数据类型也派生自 String 数据类型。

token 数据类型也包含字符，但 XML 处理器将删除换行符、回车符、制表符、前导和尾随空格，以及多个空格。

以下是模式中 token 声明的示例：

<xs:element name="customer" type="xs:token"/>

您文档中的一个元素可能如下所示：

<customer>John Smith</customer>

或者可能是这样的：

<customer>     John Smith     </customer>

注意：在上面的示例中，XML 处理器将删除制表符。

数据类型

请注意，以下所有数据类型均源自字符串数据类型（除了字符串本身）！

名称	描述
`ENTITIES`
`ENTITY`
`ID`	表示 XML 中的 ID 属性的字符串（仅与模式属性一起使用）
`IDREF`	表示 XML 中的 IDREF 属性的字符串（仅与模式属性一起使用）
`IDREFS`
`language`	包含有效语言标识的字符串
`Name`	包含有效 XML 名称的字符串
`NCName`
`NMTOKEN`	表示 XML 中的 NMTOKEN 属性的字符串（仅与模式属性一起使用）
`NMTOKENS`
`normalizedString`	不包含换行符、回车或制表符的字符串
`QName`
`string`	字符串
`token`	不包含换行符、回车、制表符、前导或尾随空格或多个空格的字符串

字符串数据类型的限制

可以与字符串数据类型一起使用的限制：

枚举
长度
最大长度
最小长度
模式（NMTOKENS、IDREFS 和 ENTITIES 不能使用此约束）
空白

XSD 日期和时间数据类型

日期和时间数据类型用于包含日期和时间值。

日期数据类型

日期数据类型用于指定日期。

日期以以下形式指定：“YYYY-MM-DD”，其中：

YYYY 表示年份
MM 表示月份
DD 表示日期

注意：所有组件都是必需的！

以下是模式中日期声明的示例：

<xs:element name="start" type="xs:date"/>

您文档中的元素可能如下所示：

<start>2002-09-24</start>

时区

要指定时区，您可以通过在时间后面添加“Z”来输入 UTC 时间的时间，如下所示：

<start>09:30:10Z</start>

或者您可以通过在时间后面添加正数或负数时间来指定 UTC 时间的偏移量，如下所示：

<start>09:30:10-06:00</start>

或

<start>09:30:10+06:00</start>

日期时间数据类型

日期时间数据类型用于指定日期和时间。

日期时间以以下形式指定：“YYYY-MM-DDThh:mm:ss”，其中：

YYYY 表示年份
MM 表示月份
DD 表示日期
T 表示所需时间部分的开始
hh 表示小时
mm 表示分钟
ss 表示秒

注意：所有组件都是必需的！

以下是模式中日期时间声明的示例：

<xs:element name="startdate" type="xs:dateTime"/>

您文档中的元素可能如下所示：

<startdate>2002-05-30T09:00:00</startdate>

或者可能如下所示：

<startdate>2002-05-30T09:30:10.5</startdate>

时区

要指定时区，您可以通过在时间后面添加“Z”来输入 UTC 时间的日期时间，如下所示：

<startdate>2002-05-30T09:30:10Z</startdate>

或者您可以通过在时间后面添加正数或负数时间来指定 UTC 时间的偏移量，如下所示：

<startdate>2002-05-30T09:30:10-06:00</startdate>

或

<startdate>2002-05-30T09:30:10+06:00</startdate>

持续时间数据类型

持续时间数据类型用于指定时间间隔。

时间间隔以以下形式指定：“PnYnMnDTnHnMnS”，其中：

P 表示周期（必需）
nY 表示年数
nM 表示月数
nD 表示天数
T 表示时间部分的开始（如果您要指定小时、分钟或秒，则必需）
nH 表示小时数
nM 表示分钟数
nS 表示秒数

以下是模式中持续时间声明的示例：

<xs:element name="period" type="xs:duration"/>

您文档中的元素可能如下所示：

<period>P5Y</period>

上面的示例表示五年的周期。

或者可能如下所示：

<period>P5Y2M10D</period>

上面的示例表示五年、两个月和 10 天的周期。

或者可能如下所示：

<period>P5Y2M10DT15H</period>

上面的示例表示五年、两个月、10 天和 15 小时的周期。

或者可能如下所示：

<period>PT15H</period>

上面的示例表示 15 小时的周期。

负持续时间

要指定负持续时间，请在 P 之前输入减号：

<period>-P10D</period>

上面的示例表示负 10 天的周期。

日期和时间数据类型

名称	描述
`date`	定义日期值
`dateTime`	定义日期和时间值
`duration`	定义时间间隔
`gDay`	定义日期的一部分 - 日（DD）
`gMonth`	定义日期的一部分 - 月（MM）
`gMonthDay`	定义日期的一部分 - 月和日（MM-DD）
`gYear`	定义日期的一部分 - 年（YYYY）
`gYearMonth`	定义日期的一部分 - 年和月（YYYY-MM）
`time`	定义时间值

日期数据类型的限制

可以与日期数据类型一起使用的限制：

枚举
最大独占
最大包容
最小独占
最小包容
模式
空白

XSD 数值数据类型

十进制数据类型用于表示数值。

十进制数据类型

十进制数据类型用于指定数值。

以下是模式中十进制声明的示例：

<xs:element name="price" type="xs:decimal"/>

您文档中的元素可能如下所示：

<price>999.50</price>

或者可能如下所示：

<price>+999.5450</price>

或者可能如下所示：

<price>-999.5230</price>

或者可能如下所示：

<price>0</price>

或者可能如下所示：

<price>14</price>

整数数据类型

整数数据类型用于指定没有小数部分的数值。

以下是模式中整数声明的示例：

<xs:element name="price" type="xs:integer"/>

您文档中的元素可能如下所示：

<price>999</price>

或者可能如下所示：

<price>+999</price>

或者可能如下所示：

<price>-999</price>

或者可能如下所示：

<price>0</price>

数值数据类型

请注意，以下所有数据类型均源自十进制数据类型（除了十进制本身）！

名称	描述
`byte`	一个带符号的 8 位整数
`decimal`	一个十进制值
`int`	一个带符号的 32 位整数
`integer`	一个整数值
`long`	一个带符号的 64 位整数
`negativeInteger`	只包含负值（..,-2,-1）的整数
`nonNegativeInteger`	只包含非负值（0,1,2,..）的整数
`nonPositiveInteger`	只包含非正值（..,-2,-1,0）的整数
`positiveInteger`	只包含正值（1,2,..）的整数
`short`	一个带符号的 16 位整数
`unsignedLong`	一个无符号的 64 位整数
`unsignedInt`	一个无符号的 32 位整数
`unsignedShort`	一个无符号的 16 位整数
`unsignedByte`	一个无符号的 8 位整数

数值数据类型的限制

可以与数值数据类型一起使用的限制：

枚举
小数位数
最大独占
最大包容
最小独占
最小包容
模式
总位数
空白

XSD 杂项数据类型

其他杂项数据类型包括布尔型、base64Binary、hexBinary、float、double、anyURI、QName 和 NOTATION。

布尔型数据类型

布尔型数据类型用于指定真值或假值。

以下是模式中布尔型声明的示例：

<xs:attribute name="disabled" type="xs:boolean"/>

您文档中的元素可能如下所示：

<price disabled="true">999</price>

注意：布尔型的合法值为 true、false、1（表示 true）和 0（表示 false）。

二进制数据类型

二进制数据类型用于表示二进制格式的数据。

我们有两种二进制数据类型：

base64Binary（Base64 编码的二进制数据）
hexBinary（十六进制编码的二进制数据）

以下是模式中十六进制二进制声明的示例：

<xs:element name="blobsrc" type="xs:hexBinary"/>

任意 URI 数据类型

任意 URI 数据类型用于指定 URI。

以下是模式中任意 URI 声明的示例：

<xs:attribute name="src" type="xs:anyURI"/>

注意：如果 URI 包含空格，请用 %20 替换。

杂项数据类型

名称	描述
`anyURI`
`base64Binary`
`boolean`
`double`
`float`
`hexBinary`
`NOTATION`
`QName`

杂项数据类型的限制

可以与其他数据类型一起使用的限制：

枚举（布尔型数据类型不能使用此约束）
长度（布尔型数据类型不能使用此约束）
最大长度（布尔型数据类型不能使用此约束）
最小长度（布尔型数据类型不能使用此约束）
模式
空白

XSD 元素

元素	说明
`all`	指定子元素可以以任何顺序出现。每个子元素可以出现 0 次或 1 次
`annotation`	指定用于模式注释的顶级元素
`any`	允许作者使用模式未指定的元素扩展 XML 文档
`anyAttribute`	允许作者使用模式未指定的属性扩展 XML 文档
`appinfo`	指定应用程序使用的信息（必须位于注释内部）
`attribute`	定义属性
`attributeGroup`	定义用于复杂类型定义中的属性组
`choice`	允许<choice>声明中包含的元素中只有一个出现在包含元素内部
`complexContent`	定义包含混合内容或仅包含元素的复杂类型上的扩展或限制
`complexType`	定义复杂类型元素
`documentation`	在模式中定义文本注释（必须位于注释内部）
`element`	定义元素
`extension`	扩展现有的 simpleType 或 complexType 元素
`field`	指定用于定义标识约束中使用的值的 XPath 表达式
`group`	定义用于复杂类型定义中的元素组
`import`	将具有不同目标命名空间的多个模式添加到文档中
`include`	将具有相同目标命名空间的多个模式添加到文档中
`key`	指定作为键的属性或元素值（在实例文档中作为唯一、非空且始终存在的）
`keyref`	指定属性或元素值与指定键或唯一元素的值相对应
`list`	将简单类型元素定义为值列表
`notation`	描述 XML 文档中非 XML 数据的格式
`redefine`	从外部模式中重新定义简单和复杂类型、组和属性组
`restriction`	在 simpleType、simpleContent 或 complexContent 上定义限制
`schema`	定义模式的根元素
`selector`	指定选择一组元素以进行标识约束的 XPath 表达式
`sequence`	指定子元素必须按顺序出现。每个子元素可以出现 0 次到任意次数
`simpleContent`	包含仅扩展或限制文本类型复杂类型或简单类型的内容，并且不包含元素
`simpleType`	定义简单类型并指定有关属性或仅文本元素的值的约束和信息
`union`	将简单类型定义为指定简单数据类型的值集合（联合）
`unique`	定义元素或属性值必须在范围内是唯一的

XSD 数据类型的限制/特征

约束	描述
`enumeration`	定义可接受值的列表
`fractionDigits`	指定允许的最大小数位数。必须等于或大于零
`length`	指定允许的精确字符或列表项数目。必须等于或大于零
`maxExclusive`	指定数值的上限（该值必须小于此值）
`maxInclusive`	指定数值的上限（该值必须小于或等于此值）
`maxLength`	指定允许的最大字符或列表项数目。必须等于或大于零
`minExclusive`	指定数值的下限（该值必须大于此值）
`minInclusive`	指定数值的下限（该值必须大于或等于此值）
`minLength`	指定允许的最小字符或列表项数目。必须等于或大于零
`pattern`	定义可接受的确切字符序列
`totalDigits`	指定允许的最大数字位数。必须大于零
`whiteSpace`	指定如何处理空格（换行符、制表符、空格和回车符）