在Java中处理XML数据时，StAX（Streaming API for XML）是一种基于流的解析方式，它允许程序以事件驱动的模式逐个读取XML文档中的节点，不需要一次性将整个文档加载到内存中，非常适合处理体积较大的XML文件，相比DOM解析更节省内存，相比SAX解析更灵活，开发者可以主动控制解析的进度。
StAX解析的核心组件
StAX解析主要依赖XMLInputFactory和XMLStreamReader两个核心类。XMLInputFactory用于创建解析工厂实例，XMLStreamReader则是实际的解析器，它会逐个返回XML文档中的事件，比如开始元素、结束元素、文本内容等。
常用事件类型
XMLStreamReader中定义了多种事件常量，常用的包括：
- START_DOCUMENT：文档开始事件
- START_ELEMENT：元素开始事件
- CHARACTERS：文本内容事件
- END_ELEMENT：元素结束事件
- END_DOCUMENT：文档结束事件
- ATTRIBUTE：元素属性事件
基础解析示例
下面通过一个简单的示例演示如何使用StAX解析一个包含用户信息的XML文件，假设待解析的XML内容如下：
<users>
<user id="1">
<name>张三</name>
<age>25</age>
</user>
<user id="2">
<name>李四</name>
<age>30</age>
</user>
</users>
对应的解析代码如下：
import javax.xml.stream.XMLInputFactory;
import javax.xml.stream.XMLStreamConstants;
import javax.xml.stream.XMLStreamReader;
import java.io.StringReader;
public class StAXParseDemo {
public static void main(String[] args) {
// 待解析的XML字符串
String xmlContent = "<users>" +
"<user id="1">" +
"<name>张三</name>" +
"<age>25</age>" +
"</user>" +
"<user id="2">" +
"<name>李四</name>" +
"<age>30</age>" +
"</user>" +
"</users>";
try {
// 创建XML输入工厂
XMLInputFactory factory = XMLInputFactory.newInstance();
// 创建XMLStreamReader解析器
XMLStreamReader reader = factory.createXMLStreamReader(new StringReader(xmlContent));
String currentElement = null;
// 循环读取所有事件
while (reader.hasNext()) {
int eventType = reader.next();
switch (eventType) {
case XMLStreamConstants.START_ELEMENT:
// 元素开始事件，获取元素名称
currentElement = reader.getLocalName();
System.out.println("开始元素: " + currentElement);
// 如果有属性，遍历属性
if (reader.getAttributeCount() > 0) {
for (int i = 0; i < reader.getAttributeCount(); i++) {
System.out.println("属性名: " + reader.getAttributeLocalName(i) + ", 属性值: " + reader.getAttributeValue(i));
}
}
break;
case XMLStreamConstants.CHARACTERS:
// 文本内容事件，过滤空白字符
String text = reader.getText().trim();
if (!text.isEmpty()) {
System.out.println(currentElement + "的文本内容: " + text);
}
break;
case XMLStreamConstants.END_ELEMENT:
// 元素结束事件
System.out.println("结束元素: " + reader.getLocalName());
currentElement = null;
break;
default:
break;
}
}
// 关闭解析器
reader.close();
} catch (Exception e) {
e.printStackTrace();
}
}
}
解析过程说明
上述代码的执行流程如下：
- 首先创建
XMLInputFactory实例，这是StAX解析的入口工厂。 - 通过工厂的
createXMLStreamReader方法创建XMLStreamReader对象，传入XML输入源，这里使用StringReader包装XML字符串，实际开发中也可以传入FileReader读取本地文件，或者InputStream读取网络流。 - 通过
while (reader.hasNext())循环逐个读取事件，调用reader.next()获取下一个事件的类型。 - 根据事件类型做不同的处理：遇到开始元素时记录当前元素名称，遍历元素的属性；遇到文本内容时过滤空白字符后输出；遇到结束元素时输出结束信息。
- 解析完成后关闭
XMLStreamReader释放资源。
注意事项
- 解析文本时需要过滤空白字符，因为XML中的换行、缩进也会被识别为
CHARACTERS事件，直接输出会包含无用的空白内容。 - 如果XML中包含命名空间，需要使用
reader.getNamespaceURI()获取命名空间信息，而不是仅通过元素名称判断。 - 解析过程中如果出现XML格式错误，会抛出
XMLStreamException，需要做好异常处理。 - 相比SAX解析，StAX的优势在于开发者可以主动控制解析的进度，不需要像SAX那样被动等待回调，适合需要灵活控制解析流程的场景。
写入XML的扩展说明
StAX除了支持解析XML，还支持通过XMLStreamWriter流式写入XML，不需要提前构建整个文档树，同样适合生成大体积的XML文件，使用方式和解析类似，通过XMLOutputFactory创建XMLStreamWriter实例，然后逐个调用writeStartElement、writeCharacters、writeEndElement等方法写入内容即可。
StAXXML解析JavaXMLStreamReader修改时间：2026-07-22 09:12:15