课时

对 XML 的简短且实用的入门介绍：基本结构（元素、属性、文本节点、注释、 CDATA）、序言的构成，尤其是——为何需要命名空间以及如何通过 xmlns 与 xmlns:prefix 属性来声明与应用它们。我们将讲解前缀、默认命名空间（ xmlns= "URI"）、在同一文档中混用不同“词汇表”，以及常见的解析错误。

在本讲中，我们将讲解两种经典的 XML 解析方式：基于树的 DOM 与基于事件的 SAX。你将学习通过树结构（ Document、 Element、 NodeList）读取和修改文档，并使用事件处理器（ SAXParser、 DefaultHandler、 startElement/ characters/ endElement）以流式方式处理大型文件。我们会展示每种方式的优缺点、实用示例，并拆解常见错误（内存问题、 characters 中的文本分割、在 SAX 中尝试修改 XML 等）。

通过 StAX 解析 XML 的流式处理：pull 模型与 SAX 的 push 方式有何不同，如何通过 XMLInputFactory 创建解析器并用 XMLStreamReader 的循环调用 reader. next() 读取事件；有哪些事件类型（ START_ELEMENT、 CHARACTERS、 END_ELEMENT、 END_DOCUMENT），以及在何种情况下 StAX 比 DOM/ SAX 更可取。另附：方法对比表、Mermaid 图，以及常见错误分析（流/资源泄漏、元素嵌套、 XMLStreamException、 IOException 等异常）。

如何使用 JAXB（Jakarta XML Binding）将 Java 对象与 XML 相互转换：关键注解 @XmlRootElement、 @XmlElement、 @XmlAttribute、 @XmlType、 @XmlTransient；基础类 JAXBContext、 Marshaller、 Unmarshaller；通过属性 Marshaller.JAXB_FORMATTED_OUTPUT 配置格式化输出。讲解适用于 Java 11+ 的 Maven 依赖（ jakarta.xml.bind-api、 jaxb-runtime）、处理集合与嵌套对象、控制元素顺序（ propOrder）、字段排除以及常见错误。

如何让 JAXB 序列化“非标准”类型并以所需格式呈现数据：使用注解 @XmlJavaTypeAdapter，并基于 XmlAdapter<ValueType, BoundType> 编写自定义适配器。我们将讲解日期格式化（ LocalDate → "dd.MM.yyyy"）、数字（ BigDecimal）、与集合的配合、通过 @XmlAttribute 将值放到属性、通过 @XmlElement 作为元素，以及用 @XmlTransient 排除字段。还将练习通过 Marshaller/ Unmarshaller 进行序列化/反序列化，并分析常见错误。