XSD的redefine元素是什么,它与include有何不同?

redefine 是 XSD 中用于同名同命名空间下有限修改已有类型(如扩展复杂类型、限制简单类型)的机制,要求原类型未设 final 禁止重定义;include 则是无修改地拼接同命名空间的外部 schema 组件。

redefine 是 XSD 中用于在当前模式文档中重新定义(即覆盖或扩展)另一个模式文档中已声明的简单类型、复杂类型、元素或属性声明的机制。它要求被 redefined 的组件必须是可重定义的(即原始定义中 final 属性未禁止重定义),且只能用于同名、同命名空间的组件。

redefine 的核心用途:有限制地“修改已有类型”

它不是导入,也不是合并,而是允许你在不改动原 schema 文件的前提下,对其中某些类型做轻量级调整。典型场景包括:

  • 给已有的复杂类型添加新元素(通过
  • 收紧已有简单类型的值域(例如把 string 限制为特定正则模式)
  • 重定义一个类型以适配本地业务规则,同时保持命名空间和名称不变

注意:redefine 只能重定义 同名、同命名空间 的组件;不能新增未在原 schema 中声明的类型;也不能重定义 final="#all"final="restriction extension" 的类型。

include 是“拼接”,redefine 是“改写”

include 的作用是把另一个同命名空间的 schema 文档中的组件直接引入当前作用域,就像把代码文件复制粘贴进来一样——所有声明都可用,但不做任何修改。

  • include 不改变原类型定义,只是让它们在当前文档中可见
  • include 支持跨文件组织,常用于模块化拆分 schema(如 types.xsd + elements.xsd)
  • include 没有重定义逻辑,不存在“覆盖”行为

实际使用中的关键区别

假设你有一个基础 schema base.xsd 声明了 PersonType,你想在项目 A 中加一个 employeeId 字段,在项目 B 中限制 name 长度不超过 20:

  • include:只能直接用原 PersonType,或基于它新建一个类型(如 ExtendedPersonType),不改动原定义
  • redefine:可在新 schema 中写 ...,内部用 ... 来扩展它

但要注意:多数现代工具(如 Xerces、Saxon)对 redefine 支持较弱,甚至默认禁用;而 include 稳定、通用、无争议。

为什么不推荐轻易用 redefine?

它破坏了 schema 的稳定性和可预测性:

  • 同一个类型名在不同上下文中含义可能不同
  • 验证时需严格按重定义链解析,容易出错
  • IDE 和校验器支持差,调试困难
  • W3C 已在 XSD 1.1 中将 redefine 标记为“deprecated”(不推荐使用)

替代方案更常用:用 include + restriction/extension 定义新类型,或升级到 XSD 1.1 使用 (更明确、更安全)。

基本上就这些。redefine 是个有历史包袱的冷门功能,理解它有助于读懂老系统,但新设计尽量绕开。