Welcome to the 1.1.6a Production Release

This 1.1.6a production release is a minor correction to the 1.1.6 release, which fixes two particular issues: Paths on Windows were handled incorrectly in 1.1.6, leading to failures when default values were specified for primitive values, and the starter project sample had an error in the "bind" Ant task definition. It includes all the other features of 1.1.6, with support for StAX parsers and writers, "flexible" unmarshalling for unordered groups, required elements in unordered groups, and a host of other features added since the 1.0 release. Check the Status page of the included documentation for a more complete list of changes.

Incompatibility Note: The 1.1.6 release contains a backward-incompatible change to the actual binding factory structure. If you compile a binding using the 1.1.6 binding compiler and then try to use the bound classes with an older runtime you'll get an error like:


Unable to access binding information for class xxx.xxx.xxx.Xxx
Make sure classes generated by the binding compiler are available at runtime

This change was necessary to solve a problem with very large binding definitions, which previously could create methods in the generated factory class which were larger than the JVM limit. With this change in place, there should be no practical limit on the size of bindings.

The docs subdirectory contains the full JiBX documentation, mirroring the version posted on the web site as of the date of this release. Even though you've got the documentation locally, you may still want to check the web site for updates on known problems or new subprojects. The online Status page will give you information on problems and updates, so it's good to check that page periodically for new information.

To help you get started using JiBX, you can find a simple starter project in the starter directory The starter project is based on the first sample from the binding tutorial. The source codes for the full set of samples in the tutorial are also provided, separately.

Acknowledgements

This download includes the XPP3 Pull Parser implementation of the XMLPull parser API. See the XPP3 home page for details on the parser.

This download includes the Apache BCEL Byte Code Engineering Library. See the BCEL home page for details on the library.

This download includes the StAX 1.0 API and WoodStox parser implementation from the Apach Axis2 project. See the Apache Axis2 home page for details on these libraries.