Woodstox Download
Package types
Both binary and source code packages are available, and they come in following flavours:
The stable version is the latest release from a branch that has been frozen, i.e. no API changes will be made, only critical fixes.
The current version is the latest release from the current development branch. Although API may still evolve (until this branch becomes the stable one), release are functional, and changes between releases are documented.
- Last revisions of earlier major releases may also be included as necessary.
(to access the source code repository, go to Woodstox Project page.
In addition to the core Woodstox packages, there are couple of additional packages available:
Stax API is needed when accessing Woodstox via Stax API (the usual case). (note: latest revision, 1.0.1, is recommended)
Extended experimental Stax2 API jars are distributed along with Woodstox jars; this jar is required by Woodstox (even if accessing Woodstox basic Stax API).
* For RelaxNG and W3C Schema validation, you will also need additional jars, because the functionality is implemented using Sun Multi-Schema Validator (MSV): optional since it is not required if NOT using these validation schemas.
Note: Stax2 interface is also used by StaxMate stax helper library.
Licensing
Woodstox is dual-licensed under 2 alternative Open Source/Free licenses: LGPL 2.1 and Apache License 2.0. (starting with Woodstox 2.0 release).
What this means is that one can choose either one of these licenses (for purposes of re-distributing Woodstox; usually by including it as one of jars another application or library uses) by downloading corresponding jar file, using it, and living happily everafter. With source code distribution licensing does not matter; except that it is good to know that by default Ant will build 2 distributions, one under each license.
Availability, Compatibility
Woodstox artifacts are available via Codehaus Maven repositories (maven 1.x and maven2).
Starting with Woodstox 4.0.0, jars are also complete OSGi bundles, allowing deployment on OSGi containers.
Stable Version (4.0.7)
This is the currently recommended version to use.
- Version: 4.0.7
- Release date: 16-Dec-2009
- Binaries (jar):
stax2-api-3.0.1 jar (extended API Woodstox implements above and beyond standard Stax (1.0) API). NOTE: this jar MUST be used along with the core package, it is not optional.
For MSV-based Relax NG validation you will also need MSV jars. The best place for getting these is from MSV home page, but here are latest snapshots (from Nov 2008) of 3 relevant jars (note that these have been augmented as valid OSGi bundles, unlike original jars):
- Source packages:
Gzipped tar: woodstox-core-src-V.tar.gz
- Documentation:
Previous versions
Earlier released versions are available from the Old Woodstox Download page.