Configuring Woodstox

The way StAX API defines configuration is such that Readers and Writers are mostly configured by configuring factory instances that create them.
Configurable options in StAX are called properties. Properties fall into couple of categories:

• standard properties defined by StAX specification
• semi-standard properties defined by the experimental Stax2 API specification, implemented by Woodstox
• implementation-dependant additional properties that Woodstox adds beyond StAX and Stax2

All of these properties are set the same way; what differs is where the property names are defined, and whether these properties can be used with other implementations than Woodstox.

Configuring XMLStreamReaders

Readers are configured via XMLInputFactory instance: readers use configuration settings the factory that created them had when instantiating the reader (so that future changes to the factory settings do not affect instances created earlier).

See full list of Woodstox reader configuration options for details.

Configuring XMLStreamWriters

Readers are configured via XMLOutputFactory instance: writers use configuration settings the factory that created them had when instantiating the writer.

See full list of Woodstox writer configuration options for details.

Back to Documentation page.