Table of Contents
This document contains information that should help you use this software library more effectively. See the Frequently Asked Questions for additional information.
The most up-to-date version of this document can be found on-line.
This release of the JAXB Reference Implementation requires J2SE 5.0 or higher.
Jars required to deploy a JAXB 2.x client
Jars required to deploy an older JAXB 1.0 client
Jars required at your development environment (but not runtime)
You may find information about the normative binding schema defined in the JAXB Specification at http://java.sun.com/xml/ns/jaxb.
The JAXB 2.x RI is a major reimplementation to meet the requirements of the 2.x specifications.
Please refer to the ??? for older releases.
Fixed version number in OSGi bundles
JAX_WS-1059 - wsimport Ant tasks causes NoClassDefFoundError
* [JAXB-415] - Marshaller.marshall throws NPE if an adapter adapts a non-null bound value to null. * [JAXB-488] - compatibility issue with JAXB 2.0 * [JAXB-608] - javax.xml.bind.DatatypeConverter.parseBoolean incorrect * [JAXB-616] - XMLCatalog not used from xjc/xjctask when strict validation is enabled * [JAXB-617] - setting Marshaller CharacterEncodingHandler with utf-8 does not work * [JAXB-790] - Whitespace processing for xs:anyURI type * [JAXB-794] - Classes annotated with @XmlTransient are still mapped to XML * [JAXB-795] - Catalog passed to XJC is not used during the schema correctness check * [JAXB-814] - Failing with 'no-arg default constructor' on @XmlTransient * [JAXB-825] - Attribute with default generates different types for get and set methods * [JAXB-831] - Memory leak in com.sun.xml.bind.v2.ClassFactory * [JAXB-834] - Cannot use binding file on Windows * [JAXB-836] - CLONE -Marshaller.marshall throws NPE if an adapter adapts a non-null bound value to null. * [JAXB-837] - XJC generated code misses out some fields from XML * [JAXB-843] - Marshaller holds reference after marshalling for the writer that was used to marshal into * [JAXB-844] - Memory Leak in com.sun.xml.bind.v2.runtime.Coordinator * [JAXB-847] - DataTypeConverterImpl patch causes corrupted stream generation in some cases * [JAXB-849] - JAXB:Invalid boolean values added to lists as 'false' * [JAXB-856] - xs:import namespace="http://www.w3.org/2005/05/xmlmime" is not generated * [JAXB-858] - xjc generates no JAXBElement for nillable element with required attribute * [JAXB-859] - Corrupt license file in the distribution * [JAXB-860] - NullPointerException com.sun.xml.bind.v2.runtime.ClassBeanInfoImpl.checkOverrideProperties(ClassBeanInfoImpl.java:205) * [JAXB-867] - jax-ws / jax-b / glassfish 3.1.1 web services fail to send data from beans based on variable name. * [JAXB-868] - Escape policy for quote (") is different when the serialization is performed to OutputStream or Writer * [JAXB-869] - Multiple <any></any> elements on a schema : second element is not loaded * [JAXB-882] - Marshalling Objects extending JAXBElement linked by @XmlElementRef * [JAXB-445] - Generated episode bindings should contain target package name * [JAXB-499] - Umbrella issue for all XJC related encoding issues wrt xjc itself and maven plugins/ant tasks * [JAXB-839] - More Schema Annotations/Documentation to Javadoc
834 - Cannot use binding file on Windows
835 - XJC fails with project path that contains spaces
413 - Redundant cast to byte in code generated by XJCTask
416 - Ant XJC task problems with spaces in paths
450 - Reusing unmarshaller results in an unexpected result
549 - Unescaped javadoc in
602 - Different unmarshalling behavior between primitive type and simpletype with enumeration under restriction
618 - XJC generates certain code lines in a random order
620 - Problems with abstract classes and
652 - JAXB 2.2 API should be changed to work with old 2.1 jaxb implementation in JDK
696 - Incorrect implementation/documentation of javax.xml.bind.annotation.adapters.NormalizedStringAdapter
726 - Missing keyword 'throw'
761 - DatatypeConverterInterface.printDate inconsistencies
774 - Extra slash in XSD location prevents customization
803 - 2.2.2 strips schemaLocation in binding files
804 - JAXB 2.x : How to override an XmlElement annotation from parent class - Mission Impossible?
813 - Preserving white-space in XML (xs:string enumeration value) does not work
815 - Binding file cannot refer to schema file with space in file name.
816 - Incorrect System property to define the provider factory class
821 - Global customization are not applied to xjc when input document is WSDL
824 - API files in javax.xml.bind need to be updated for references to JLS with editions/hyperlinks
826 - JAXB fails to unmarshal attributes as properties on aix
268 - Map handling broken
470 - Potential changes to make JAXB work better with OSGi
478 - jaxb2-sources : Allow compilation under Java 6
633 - JDefinedClass getMods()
768 - Mailing list consolidation suggestions
784 - JAnnotationUse should provide getters for clazz and memberValues properties
406 - Allow setting of access modifiers in JMods
769 - Update to command-line help text
772 - Updates to XJC.html page and -Xpropertyaccessors plugin
783 - I18N: xjc generates localized strings of AM/PM so compilation fails
826 - JAXB fails to unmarshal attributes as properties on AIX
805 - SpecJ performance regression
6975714 - JAXB 2.2 throws IAE for invalid Boolean values
620 - Problems with abstract classes (xsi type processing)
Regression in Jersey JSON mapping
This minor-minor release contains only changes relevant to GlassFish OSGi environment
Minor licencing and legal fixes. No changes to source code.
Fixed documentation that incorrectly showed that JAXB RI is CDDL only (it's actually CDDL/GPLv2+classpath dual license)
JavaSE 6 release is expected to include this version of the JAXB RI (certainly as of build 102.)
Java to schema samples are added
Added <xjc:javaType> vendor customization
Added experimental <xjc:simple> vendor customization, which brings in a new simpler and better binding mode
The spec has renamed
Various error handling improvements
Experimental canonicaliztion support is added.
The '-b' option can now take a directory and recursively search for all "*.xjb" files.
Fixed various issues regarding using JAXB from codef inside a restricted security sandbox.
Added more pluggability points for plugins to customize the code generation behavior.
Some of the code is split into a separate
istack-commons project to promote more reuse among
Made a few changes so that RetroTranslator can translate the JAXB RI (and its generated code) to run it on JDK 1.4 and earlier
Improved the quality of the generated code by removing unnecessary imports.
Other countless bug fixes
Map property can be now correctly bound to XML Schema
Default marshaller error handling behavior became draconian (previously errors were ignored.)
@link to a parameterized type is now correctly generated
started producing architecture document for those who want to build plugins or play with the RI internal.
XJC now uses the platform default proxy setting by default.
@XmlJavaTypeAdapter on a class/package is implemented
Marshaller life-cycle events are implemented
Integration to FastInfoset is improved in terms of performance
XJC can generate
The unmarshaller is significantly rewritten for better performance
Added schemagen tool and its Ant task
Various improvements in error reporting during unmarshalling/marshalling
JAXB RI is now under CDDL
The default for
@XmlAccessorType was changed to
Optimized binary data handling enabled by callbacks in package javax.xml.bind.attachment. Standards supported include MTOM/XOP and WS-I AP 1.0 ref:swaRef.
Unmarshal/marshal support of element defaulting
Improved the quality of the generated Java code
Fixed bugs in default value handling
Runtime performance improvements, memory usage improvements
Added support for <xjc:superInterface> vendor extension
Migrated source code to http://jaxb2-sources.dev.java.net
Published NetBeans project file for JAXB RI
Added more support to the schema generator: anonymous complex types, attribute refs, ID/IDREF, etc
javax.xml.bind.Binder support (not 100% done
Implemented marshal-time validation
Improved xjc command line interface - better support for proxy options, more options for specifying schema files
Added schema-2-Java support for simple type substitution
Added support for the new
<jaxb:globalBindings localScoping="nested" |
"toplevel"> customization which helps control deeply
Made the default
ValidationEventHandler more forgiving in 2.0 than it
was in 1.0 (The class still behaves the same as it did when
used by a 1.0 app)
Added wildcard support for DTD
Numerous other small changes and bugfixes....
Support for 100% W3C XML Schema (not all in EA, but planned for FCS)
Support for binding Java to XML
javax.xml.bind.annotation package for controling the
binding from Java to XML
Significant reduction in the number of generated schema-derived classes
Per complex type definition, generate one value class instead of an interface and implementation class.
Per global element declaration, generate a factory method instead of generating a schema-derived interface and implementation class.
Replaced the validation capabilities in 1.0 with JAXP 1.3 validation API's
Smaller runtime libraries
Numerous other changes...