XSD的xs:override怎么覆盖引入的schema定义-XML/RSS教程-PHP中文网

XSD的xs:override怎么覆盖引入的schema定义

畫卷琴夢

发布： 2025-12-18 10:59:02

原创

729人浏览过

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

xsd的xs:override怎么覆盖引入的schema定义

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"`：

百度文心百中

百度大模型语义搜索体验中心

263

查看详情

<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 升级。

以上就是XSD的xs:override怎么覆盖引入的schema定义的详细内容，更多请关注php中文网其它相关文章！