The gold standard Stax XML API implementation. Now at Github.
The most common way is to use Maven (or Ivy) to access it from Maven Central repository. Coordinates for this are:
- Group id:
com.fasterxml.woodstox - Artifact id:
woodstox-core - Latest published version: 6.0.0 (2019-08-29)
Note that Maven id has changed since Woodstox 4.x.
Woodstox 5 and above require Java 6 (JDK 1.6); as well as Stax API that is included in JDK. The only other mandatory dependency is Stax2 API, extended API implemented by Woodstox and some other Stax implementations (like Aalto.
Optional dependency is Multi-Schema Validator (MSV) that is needed if using XML Schema or RelaxNG validation functionality
Woodstox 5.x is licensed under Apache 2 license.
Most configuration is handled using standard Stax mechanism, property access via
XMLInputFactory.setProperty(propertyName, value)for configuring XML reading aspectsXMLOutputFactory.setProperty(propertyName, value)for configuring XML writing aspects
Names of properties available, including standard Stax 1.x ones, are documented in a series of blog posts:
- Stax 1.x standard configuration properties
- Stax2 extension configuration properties
- Woodstox-specific configuration properties
There are 2 types of support available:
- Community support via mailing lists: woodstox-user
- Optional Commercial Support is available via Tidelift Subscriptions
For simple bug reports and fixes, and feature requests, please simply use projects Issue Tracker, with exception of security-related issues for which we recommend filing a Tidelift security contact (NOTE: you do NOT have to be a subscriber to do this).
- Check out project Wiki for javadocs