XML Schema 中的 key 和 keyref 用于实现文档内主键—外键约束:key 确保指定字段值全局唯一且非空,keyref 要求字段值必须匹配某 key 或 unique 声明的键值,二者均在 XSD 验证阶段由解析器检查。

XML Schema 中的 key 和 keyref 用于在 XML 文档内部实现类似数据库中“主键—外键”的约束机制,确保元素/属性值的唯一性与引用有效性。它们不依赖外部数据库,而是在 XML 解析(如 XSD 验证)阶段由处理器检查。
key:定义唯一标识符(相当于主键)
key 声明一个字段(或字段组合)在整个文档范围内必须唯一,且非空。它必须出现在 或 的 子元素中,作用域是该元素及其后代。
关键点:
- 用
指定要约束的元素集合(XPath 表达式,相对路径) - 用
指定作为“键值”的子项(可多个,对应联合主键) - 每个
的 XPath 必须返回**单个原子值**(不能是元素节点集)
示例:要求每个 的 isbn 属性全局唯一
keyref:定义引用关系(相当于外键)
keyref 声明某个字段的取值必须匹配某个 key(或 unique)声明的键值,从而建立引用完整性。
关键点:
- 必须通过
refer属性指向一个已定义的key或unique的name -
和的写法与key完全一致,但语义是“被引用的值” - 引用字段和被引用字段的数据类型需兼容(通常都为字符串或 xs:ID/xs:IDREF,但 XSD 1.0 不强制类型一致,仅比对字面值)
示例:要求 中的 book_isbn 必须等于某个 的 isbn
完整 XSD 片段示例(含 key + keyref)
以下是一个简化的图书订单 Schema,体现主键(book/@isbn)与外键(order/book_isbn)约束:
注意事项与常见问题
使用 key/keyref 时需注意:
-
作用域限制:key/keyref 只对
选中的元素及其后代生效,不能跨顶层元素引用(除非把 key 定义在更外层) -
空值不参与约束:若
对应的值为空字符串或不存在,该实例不参与唯一性/引用检查(即不报错) -
ID/IDREF 更轻量但能力有限:如果只需简单单值引用,可用
xs:ID(自动保证唯一)和xs:IDREF(自动验证存在),但不支持 XPath 定位、不支持复合键、且 ID 值必须符合 NCName 规则 -
验证时机:只有启用 XSD 全验证(如使用
xsi:schemaLocation并由支持 key/keyref 的解析器处理)才触发检查;DOM/SAX 解析本身不执行该逻辑










