Woodstox

General

Category
Free
Tag
XML
License
Apache License, Version 2.0
Registered
Jul 5, 2014
Favorites
0
Link
https://github.com/FasterXML/woodstox
See also
JDOM
VTD-XML
XmlToJson
Simple
kXML

Additional

Language
Java
Version
N/A
Created
Aug 2, 2014
Updated
Aug 18, 2021
Owner
FasterXML, LLC (FasterXML)
Contributors
Tatu Saloranta (cowtowncoder)
Paul Brown (prb)
Nicolas Raoul (nicolas-raoul)
valery1707
Wilco Greven (wgreven)
Wilco Greven (wgreven-ibr)
Daniel Kulp (dkulp)
Alexis Hafner (hxc9)
Marc Magon (GedMarc)
Colm O hEigeartaigh (coheigea)
Blaine Bublitz (phated)
Nico Kutscherauer (nkutsche)
Konrad Windszus (kwin)
genisysram
michael-siegel-github
ChrisTrenkamp
16
Activity
Badge
Generate
Download
Source code

Advertising

Overview

The gold standard Stax XML API (javax.xml.stream) implementation. Now at Github.

For longer overview, check out:

Status

Type Status
Build (CI)
Artifact
OSS Sponsorship
Javadocs
Code coverage (6.x)
CodeQ (LGTM.com)

Get it!

Maven

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.2.6 (2021-04-19)

Note that Maven id has changed since Woodstox 4.x but API is still compatible (despite nominal major version upgrade -- major version upgrades in this case were only due to package coordinate changes)

Requirements

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

License

Woodstox 4.x and above licensed under Apache 2 license.

Documentation etc

Configuration

Most configuration is handled using standard Stax mechanism, property access via

  • XMLInputFactory.setProperty(propertyName, value) for configuring XML reading aspects
  • XMLOutputFactory.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:

Support

Community support

Woodstox is supported by the community via the mailing list: woodstox-user

Enterprise support

Available as part of the Tidelift Subscription.

The maintainers of woodstox and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source dependencies you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use. Learn more.

Contributing

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).

Other