StAX用拉模式边读边处理XML，不加载全文，适合大文件；通过XMLStreamReader读取、XMLStreamWriter写入，需注意CHARACTERS分片、空元素处理及手动维护层级状态。
用Java StAX（Streaming API for XML）处理XML，核心是“边读边处理”，不加载整个文档到内存，适合大文件或内存受限场景。它比DOM轻量，比SAX更易控制——因为是拉模式（pull），程序主动调用next()或hasNext()来获取事件，而不是被动回调。
创建XMLStreamReader读取XML
先用XMLInputFactory创建读取器，支持从文件、输入流或字符串读取：
- 推荐用
Files.newInputStream()配合StandardCharsets.UTF_8避免乱码 - 设置
factory.setProperty(XMLInputFactory.IS_NAMESPACE_AWARE, true)如需处理命名空间 - 遇到格式错误会抛
XMLStreamException，建议包裹在try-with-resources中自动关闭
遍历事件并提取数据
StAX把XML拆成一系列事件（START_ELEMENT、END_ELEMENT、CHARACTERS等）。典型处理逻辑是循环判断当前事件类型：
- 遇到
START_ELEMENT时，用getLocalName()或getAttributeValue()取标签名和属性 - 遇到
CHARACTERS时，用getText().trim()获取文本内容（注意可能有空白或换行，需trim） - 用
isStartElement()和isEndElement()代替硬编码整数常量，代码更可读
写入XML用XMLStreamWriter
生成XML同样简单：用XMLOutputFactory创建写入器，再调用链式方法：
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
立即学习“Java免费学习笔记（深入）”；
-
writeStartDocument()开头，writeEndDocument()结尾 -
writeStartElement("user")写开始标签，writeAttribute("id", "123")加属性 -
writeCharacters("张三")写文本内容，writeEndElement()闭合标签 - 记得调用
flush()确保内容写出，尤其用OutputStreamWriter时指定编码
常见坑与建议
实际用StAX容易忽略几个细节：
- CHARACTERS事件可能被拆成多次（尤其含特殊字符或大段文本），需累积直到下一个非CHARACTERS事件
- 空元素如
<price></price>会触发START_ELEMENT后紧跟END_ELEMENT，没有CHARACTERS事件 - 不支持XPath或CSS选择器，复杂查询得靠状态机自己维护层级或栈
- 如果需要验证DTD/XSD，StAX本身不支持，得搭配
SAXParser或用StAX+SchemaFactory组合
基本上就这些。StAX不是万能的，但对“读一遍就完事”的ETL、配置解析、日志转储这类任务，够快、够稳、够直接。
