Woodstox 是 Java 中高性能、功能完备的 StAX 实现，解析速度快、内存占用低、线程安全，支持 XML 1.0/1.1、命名空间、DTD/XSD 验证等；Maven 引入 6.5.1 版本依赖，JDK 8+ 可直接使用；通过 WstxInputFactory 创建解析器并配置参数，采用 pull 模式高效遍历事件；写入端同样优化，支持缩进、编码控制与复用实例。
Woodstox 是 Java 中最成熟、高性能的 StAX（Streaming API for XML）实现之一，比 JDK 自带的 StAX 实现（如 Sun XMLInputFactory）在解析速度、内存占用、功能完整性和线程安全性上都有明显优势。它支持 XML 1.0/1.1、命名空间、DTD、XML Schema 验证、自定义事件处理器等，适合处理大文件、高吞吐场景。
添加 Woodstox 依赖
使用 Maven，在 pom.xml 中引入：
注意：Woodstox 6.x 要求 JDK 8+，且已完全模块化，不再需要额外引入 stax-api（JDK 8+ 内置）。旧版（如 4.x/5.x）需配合 stax2-api 使用，新项目推荐用 6.x。
创建 Woodstox XMLInputFactory 和解析器
Woodstox 提供了增强的工厂类 WstxInputFactory，可通过静态方法获取实例，无需强制类型转换：
立即学习“Java免费学习笔记（深入）”；
- 直接调用
WstxInputFactory.newInstance()创建高性能输入工厂 - 设置关键性能参数，例如禁用 DTD（默认启用，影响安全与速度）：
factory.setFeature(XMLInputFactory.SUPPORT_DTD, false); - 启用命名空间支持（默认开启，但显式声明更清晰）：
factory.setFeature(XMLInputFactory.IS_NAMESPACE_AWARE, true); - 创建
XMLStreamReader：XMLStreamReader reader = factory.createXMLStreamReader(new FileInputStream("data.xml"));
高效遍历 XML 事件（Pull 解析）
Woodstox 的 pull 解析模式让你按需读取事件，避免 DOM 的内存开销。典型循环结构如下：
- 用
reader.hasNext()判断是否还有事件 - 用
reader.next()获取当前事件类型（返回int，如XMLStreamConstants.START_ELEMENT），并自动前进到下一事件 - 用
reader.getLocalName()、reader.getAttributeValue(null, "id")等快速提取内容 - 遇到
START_ELEMENT时可嵌套处理子元素；遇到CHARACTERS时注意合并相邻文本（调用reader.getText()即可，Woodstox 默认自动合并）
相比 JDK 原生 StAX，Woodstox 对空白字符、CDATA、实体引用等处理更鲁棒，且解析速度通常快 2–3 倍（尤其在含大量属性或嵌套较深的文档中）。
写入 XML（XMLStreamWriter）同样高性能
Woodstox 同样优化了输出端：
- 用
WstxOutputFactory.newInstance()创建写入工厂 - 支持流式写入、自动缩进（
factory.setProperty(WstxOutputProperties.P_OUTPUT_INDENTATION, "true")）、编码控制（如 UTF-8）、以及延迟写入缓冲区管理 - 写入时建议复用
XMLStreamWriter实例（线程不安全，但可池化），避免频繁创建开销 - 调用
writeStartElement("user")→writeAttribute("id", "123")→writeCharacters("Alice")→writeEndElement()即可生成规范 XML
对于日志导出、API 响应生成等高频 XML 构建场景，Woodstox 的写入吞吐量显著优于标准实现。
