xs:override 是 xml schema 1.1 引入的安全重定义机制,用于在不修改原始 schema 文件的前提下,精确覆盖或增强已引入的类型、元素等定义,需严格匹配名称与类别,且仅支持 xsd 1.1 处理器。

xs:override 是 XML Schema 1.1 中引入的机制,用于安全地替换或增强已有的 schema 定义(比如来自 xs:include 或 xs:import 的类型、元素、属性等),而无需修改原始 schema 文件。它不是“覆盖”语义上的简单覆盖,而是有约束的、显式的重定义,必须严格遵循规则。
下面直接说明怎么用 xs:override 正确覆盖引入的 schema 定义:
前提:只能用于 XML Schema 1.1
确保你的处理器支持 XSD 1.1(如 Xerces-J 2.12+、Saxon EE、libxml2 2.9.12+)。XSD 1.0 不支持 `xs:override`,用了会报错。
语法结构:用 xs:override 包裹被覆盖的目标定义
你不能在任意位置写 `xs:override`。它必须是 schema 文档的**顶层元素之一**(和 `xs:include`、`xs:import` 同级),且其内容必须只包含对原 schema 中已存在组件的重定义 —— 且名称、种类(element/type/attribute 等)必须完全匹配。
例如,要覆盖 `common.xsd` 中定义的 `xs:complexType name="Person"`:
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns="http://example.com"
targetNamespace="http://example.com"
version="1.1">
<p><!-- 引入原始 schema -->
<xs:include schemaLocation="common.xsd"/></p><p><!-- 覆盖其中的 Person 类型 -->
<xs:override schemaLocation="common.xsd">
<xs:complexType name="Person">
<xs:sequence>
<xs:element name="name" type="xs:string"/>
<xs:element name="age" type="xs:positiveInteger"/>
<xs:element name="email" type="xs:string" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:override></p><p></xs:schema>关键限制:什么能覆盖,什么不能
- 必须精确匹配名称和类别:`name="Person"` + `xs:complexType` 必须和 `common.xsd` 中声明的一模一样(包括是否带 `targetNamespace`)
-
不能新增组件:`xs:override` 内部只能出现已在被覆盖 schema 中存在的声明;多一个 `
` 就算非法 - 不能改变顶层结构语义:比如把 `xs:simpleType` 改成 `xs:complexType`,或把全局元素改成局部元素 —— 这些不被允许
- 可以扩展/收紧约束:比如在原 `Person` 中增加可选字段、改 `minOccurs`、加 `xs:assert`、细化 `xs:restriction` —— 这些是典型合法用法
覆盖 import 的 schema 要注意命名空间
如果 `common.xsd` 是通过 `xs:import`(而非 `xs:include`)引入的,它必然有 `namespace`。此时 `xs:override` 的 `schemaLocation` 指向它,但内部重定义必须带上正确的 `targetNamespace`(或用 `xmlns:tns="..."` + `tns:Person`)。
例如 `common.xsd` 声明了 `targetNamespace="http://common.example"`,那么 override 片段应为:
<xs:override schemaLocation="common.xsd">
<xs:complexType name="Person"
xmlns:cm="http://common.example"
targetNamespace="http://common.example">
<!-- ... -->
</xs:complexType>
</xs:override>基本上就这些。xs:override 不复杂但容易忽略版本和匹配精度,用对了就能解耦维护、实现渐进式 schema 升级。










