HTTP 与 Web 标准 / 系统课时
version 属性表示什么
version 属性表示什么
XML 声明中的 version 用来告诉解析器:这份文档遵循哪一版 XML 语法规则。它描述的是 XML 规范版本,不是业务数据、接口或应用程序的版本。实际项目中最常见的是 1.0,理解这一点可以避免把它误当成自定义版本号。
学习目标
- 说明 XML 声明中
version的真实含义 - 识别
1.0与1.1两种常见写法 - 判断什么时候应保持
version="1.0"
version 约束的是 XML 语法
典型 XML 声明如下:
<?xml version="1.0" encoding="UTF-8"?>
<message>Hello</message>这里的 version="1.0" 表示后续内容按照 XML 1.0 的语法和字符规则解释。它不会改变元素名、属性名或业务字段的含义,也不表示“message 数据结构的第 1.0 版”。
如果业务本身需要版本号,应把它放进业务数据中,例如:
<message schemaVersion="2.0">Hello</message>这个 schemaVersion 是应用自定义属性,与 XML 声明中的 version 属于两个不同层次。
常见版本形式
日常开发中主要会见到 XML 1.0 和 XML 1.1。XML 1.0 兼容性最好,也是配置文件、接口报文和数据交换中最常见的选择。XML 1.1 调整了部分字符与换行处理规则,但许多系统没有使用它的必要。
因此,在没有明确兼容性需求时,通常直接使用:
<?xml version="1.0" encoding="UTF-8"?>不要自行写成 1.2、2.0 或产品版本号。XML 解析器只接受规范定义的 XML 版本形式,随意修改可能直接导致文档无法解析。
声明存在时 version 不能省略
在 XML 1.0 文档中,XML 声明本身可以省略;但如果写了 XML 声明,version 必须出现,而且应位于声明中的首要位置。
下面是合法的常见形式:
<?xml version="1.0"?>
<message>Hello</message>encoding 和 standalone 可以按需要补充,而 version 是 XML 声明的核心字段。实践中,为了让编码意图也清晰可见,通常会同时写出 encoding="UTF-8"。
判断 version 时只问一个问题:这份文档采用哪版 XML 规范解析? 如果需求没有明确要求 XML 1.1,使用 version="1.0" 通常就是最稳妥的选择。