Jakarta XML Binding
Template:Short description
Template:Infobox software
Jakarta XML Binding (JAXB; formerly Java Architecture for XML Binding) is a software framework that allows Java EE developers to map Java classes to XML representations. JAXB provides two main features: the ability to marshal Java objects into XML and the inverse, i.e. to unmarshal XML back into Java objects. In other words, JAXB allows storing and retrieving data in memory in any XML format, without the need to implement a specific set of XML loading and saving routines for the program's class structure. It is similar to xsd.exe and XmlSerializer in the .NET Framework.
JAXB is particularly useful when the specification is complex and changing. In such a case, regularly changing the XML Schema definitions to keep them synchronised with the Java definitions can be time-consuming and error-prone.
JAXB is one of the APIs in the Jakarta EE platform (formerly Java EE), part of the Java Web Services Development Pack (JWSDP), and one of the foundations for WSIT. It was also part of the Java SE platform (in version Java SE 6–10). As of Java SE 11, JAXB was removed. For details, see JEP 320.
JAXB 1.0 was released in 2003, having been developed under the Java Community Process as JSR 31.<ref>Template:Cite web</ref> In 2006 JAXB 2.0 was released under JSR 222 and Maintenance Release 2 released in December 2009.<ref>Template:Cite web</ref> Reference implementations for these specifications were available under the CDDL open source license at java.net.
Usage
The tool "Template:Mono" can be used to convert XML Schema and other schema file types (as of Java 1.6, RELAX NG, XML DTD, and WSDL are supported experimentally) to class representations.<ref>Template:Cite web</ref> Classes are marked up using annotations from Template:Mono namespace, for example, Template:Mono and Template:Mono. XML list sequences are represented by attributes of type Template:Mono. Marshallers and Unmarshallers are created through an instance of JAXBContext.
In addition, JAXB includes a "Template:Mono" tool that can essentially perform the inverse of "Template:Mono", creating an XML Schema from a set of annotated classes.
Default data type bindings
The table below lists the mappings of XML Schema (XSD) data types to Java data types in JAXB.<ref> Template:Cite web </ref>
| XML Schema Type | Java Data Type |
|---|---|
xsd:string
|
java.lang.String
|
xsd:integer
|
java.math.BigInteger
|
xsd:positiveInteger
|
java.math.BigInteger
|
xsd:int
|
int
|
xsd:long
|
long
|
xsd:short
|
short
|
xsd:decimal
|
java.math.BigDecimal
|
xsd:float
|
float
|
xsd:double
|
double
|
xsd:boolean
|
boolean
|
xsd:byte
|
byte
|
xsd:QName
|
javax.xml.namespace.QName
|
xsd:dateTime
|
javax.xml.datatype.XMLGregorianCalendar
|
xsd:base64Binary
|
byte[]
|
xsd:hexBinary
|
byte[]
|
xsd:unsignedInt
|
long
|
xsd:unsignedShort
|
int
|
xsd:unsignedByte
|
short
|
xsd:unsignedLong
|
java.math.BigDecimal
|
xsd:time
|
javax.xml.datatype.XMLGregorianCalendar
|
xsd:date
|
javax.xml.datatype.XMLGregorianCalendar
|
xsd:g
|
javax.xml.datatype.XMLGregorianCalendar
|
xsd:anySimpleType<ref>for xsd:element of this type</ref>
|
java.lang.Object
|
xsd:anySimpleType<ref>for xsd:attribute of this type</ref>
|
java.lang.String
|
xsd:duration
|
javax.xml.datatype.Duration
|
xsd:NOTATION
|
javax.xml.namespace.QName
|
Versions
- Java SE 9: JAXB 2.3.0 <ref>Template:Cite web</ref> (in module
java.xml.bind; this module is marked as deprecated <ref>Template:Cite web</ref>) - Java SE 8: JAXB 2.2.8 <ref>Template:Cite web</ref>
- Java SE 7: JAXB 2.2.3 (JSR 222, maintenance release 2) <ref>Template:Cite web</ref>
- Java SE 6: JAXB 2.0 (JSR 222) <ref>Template:Cite web</ref>
See also
- XML data binding
- JiBX
- XMLBeans – a similar and complementary technology to JAXB from Apache Software Foundation
- TopLink – an object to relational and object to XML mapper from Oracle that supports JAXB 1.0
- EclipseLink MOXy – open source implementation of JAXB and object XML mapping services under the Eclipse Foundation
- Liquid XML Studio – Commercial tool for XML data binding code generation
References
External links
- Template:Official website Reference Implementation on Project GlassFish
- Previous JAXB home page Template:Webarchive
- Original JAXB home page Template:Webarchive
- A JAXB Tutorial Template:Webarchive by Wolfgang Laun
- JSR 222 (JAXB 2.0)
- JSR 31 (JAXB 1.0)
- The Java EE 5 Tutorial - Binding between XML Schema and Java Classes JAXB chapter of the Java EE 5 Tutorial
- JAXB Wizard Template:Webarchive
- JAXB Tutorials