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免费学习笔记(深入)”;
-
writeStartDocument()开头,writeEndDocument()结尾 -
writeStartElement("user")写开始标签,writeAttribute("id", "123")加属性 -
writeCharacters("张三")写文本内容,writeEndElement()闭合标签 - 记得调用
flush()确保内容写出,尤其用OutputStreamWriter时指定编码
常见坑与建议
实际用StAX容易忽略几个细节:
- CHARACTERS事件可能被拆成多次(尤其含特殊字符或大段文本),需累积直到下一个非CHARACTERS事件
- 空元素如
会触发START_ELEMENT后紧跟END_ELEMENT,没有CHARACTERS事件 - 不支持XPath或CSS选择器,复杂查询得靠状态机自己维护层级或栈
- 如果需要验证DTD/XSD,StAX本身不支持,得搭配
SAXParser或用StAX+SchemaFactory组合
基本上就这些。StAX不是万能的,但对“读一遍就完事”的ETL、配置解析、日志转储这类任务,够快、够稳、够直接。










