📚 课程目录第3章 XML Schema入门

XML Schema 入门：基本结构与声明实战

好，咱们进入 Schema 的世界。说实话，我当年刚接触 XML 时，觉得 DTD 就够用了。直到有一次在项目中做数据交换，对方发来的 XML 文件里，本该是数字的字段写成了「N/A」，本该必填的节点直接缺失——整个解析流程直接崩了。从那天起，我再也不敢轻视 Schema 约束。

XML Schema 是什么？说白了，它是一套「规则说明书」。你写一个 XML 文件，Schema 就是裁判，告诉你哪里犯规了。跟 DTD 比，Schema 本身就是 XML 文件，不用学新语法，而且支持数据类型、命名空间这些硬核能力。

Schema 的基本骨架

一个标准的 XSD（XML Schema Definition）文件长什么样？我直接给你看最简结构：

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">

    <!-- 你的元素和类型声明写在这里 -->

</xs:schema>

注意根元素是 <xs:schema>，xs 是命名空间前缀。我个人习惯用 xs，也有人用 xsd，都行，保持一致就好。

核心要点：Schema 文件本身必须遵守 XML 规范，所以它也有版本声明和编码声明。根元素必须指定 W3C 的 Schema 命名空间。

元素声明：从简单到复杂

元素声明是 Schema 最基础的操作。咱们先看最简单的——声明一个只包含文本内容的元素：

<xs:element name="productName" type="xs:string"/>

这就定义了一个叫 productName 的元素，内容只能是字符串。你想想看，如果对方传了个数字进来，Schema 校验直接报错。

那如果元素有属性呢？比如：

<product id="P001">笔记本电脑</product>

对应的 Schema 声明：

<xs:element name="product">
    <xs:complexType>
        <xs:simpleContent>
            <xs:extension base="xs:string">
                <xs:attribute name="id" type="xs:string" use="required"/>
            </xs:extension>
        </xs:simpleContent>
    </xs:complexType>
</xs:element>

嗯，这里要注意：只要元素包含属性或子元素，就必须用 complexType。纯文本内容加属性，用 simpleContent + extension。

属性声明：细节决定成败

属性声明比元素简单，但坑不少。基本语法：

<xs:attribute name="currency" type="xs:string" use="optional" default="CNY"/>

几个关键点：

name：属性名，必须唯一
type：数据类型，可以是内置类型或自定义类型
use：required（必填）、optional（可选）、prohibited（禁止）
default：默认值，当属性未出现时使用
fixed：固定值，属性必须等于这个值

我曾经踩过的坑：有一次我把 use="required" 写成了 use="require"，少了个 d，结果所有校验都通过了——因为 Schema 解析器把不认识的值当成了 optional。从那以后，我每次写完 Schema 都会用工具做一次语法检查。

内置数据类型：你的武器库

Schema 提供了丰富的数据类型，我列几个最常用的：

类型	说明	示例值
`xs:string`	字符串	"Hello"
`xs:integer`	整数	42
`xs:decimal`	小数	3.14
`xs:boolean`	布尔值	true / false
`xs:date`	日期	2024-03-15
`xs:dateTime`	日期时间	2024-03-15T14:30:00
`xs:anyURI`	URI 链接	https://example.com

为什么强调数据类型？我在项目中遇到过：某系统把产品价格存成字符串，结果排序时「100」排在了「20」前面——因为字符串是按字典序比较的。用 xs:decimal 就能避免这种低级错误。

综合示例：一个完整的产品 Schema

咱们把刚才的知识点串起来，写一个真实场景的 Schema：

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">

    <xs:element name="product">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="name" type="xs:string"/>
                <xs:element name="price" type="xs:decimal"/>
                <xs:element name="quantity" type="xs:integer"/>
                <xs:element name="available" type="xs:boolean"/>
                <xs:element name="releaseDate" type="xs:date" minOccurs="0"/>
            </xs:sequence>
            <xs:attribute name="id" type="xs:string" use="required"/>
            <xs:attribute name="category" type="xs:string" use="optional" default="general"/>
        </xs:complexType>
    </xs:element>

</xs:schema>

对应的 XML 实例：

<product id="P001" category="electronics">
    <name>无线鼠标</name>
    <price>89.50</price>
    <quantity>200</quantity>
    <available>true</available>
    <releaseDate>2024-01-15</releaseDate>
</product>

我的习惯：写 Schema 时，我会先画一个简单的结构图，理清元素之间的层级关系，再动手写代码。这样不容易漏掉必填字段或搞错嵌套层次。

知识体系总览

下面这张图帮你把本章的知识点串起来：

避坑指南

最后分享几个我实战中踩过的坑：

命名空间别写错：http://www.w3.org/2001/XMLSchema 这个 URL 必须一字不差，少个斜杠都不行
大小写敏感：xs:string 不能写成 xs:String，xs:integer 不能写成 xs:Integer
minOccurs / maxOccurs：默认值都是 1，如果你想让某个子元素可选，记得显式写 minOccurs="0"
属性顺序不重要：XML 属性没有顺序要求，但子元素在 xs:sequence 里必须按声明顺序出现

Schema 入门其实不难，关键是动手写。我建议你找一份真实的 XML 数据，试着为它写一份 Schema，然后拿工具做校验。出错不要紧，每个错误都是学习的机会。