87.139.216.203: Komma vor "und" entfernt, es handelt sich um eine Aufzählung

2025-06-18T09:36:11Z

Komma vor "und" entfernt, es handelt sich um eine Aufzählung

Neue Seite

{{Infobox Software
|Name = Java Architecture for XML Binding (JAXB)
|Logo =
|Screenshot =
|Beschreibung = 
|Maintainer = [[Metro (Java)|Metro]] Projekt
|Hersteller = [[Sun Microsystems]]
|Management =
|Erscheinungsjahr =
|AktuelleVersion = 
|AktuelleVersionFreigabeDatum = 
|AktuelleVorabVersion = 4.0
|AktuelleVorabVersionFreigabeDatum = 15. Oktober 2021
|Betriebssystem = [[Plattformunabhängig]]
|Programmiersprache = 
|Kategorie = [[Extensible Markup Language|XML]] API
|Lizenz = 
|Deutsch =
|Website = 
|Dateien =
}}

'''Jakarta XML Binding''' (JAXB; früher Java Architecture for XML Binding) ist eine [[Programmschnittstelle]] in [[Java (Programmiersprache)|Java]], die es ermöglicht, Daten aus einer XML-Schema-Instanz heraus automatisch an Java-Klassen zu binden und diese Java-Klassen aus einem [[XML-Schema]] heraus zu generieren. Diesen Vorgang nennt man [[XML-Datenbindung]].

Somit ist ein Arbeiten mit XML-Dokumenten möglich, ohne dass der Entwickler direkt Schnittstellen zur Verarbeitung von XML wie [[Simple API for XML|SAX]] oder [[Document Object Model|DOM]] verwenden muss.

JAXB 2.0 ist Teil der [[Java Platform, Enterprise Edition]] 5.0 und der [[Java Platform, Standard Edition|Standard Edition]] 6.0. Es ist ein Teil der [[Web Services Interoperability Technology]] (WSIT). JAXB 1.0 wurde vom [[Java Community Process]] als [[Java Specification Request|JSR]] 31 entwickelt, JAXB 2.0 als JSR 222. Die [[Referenzimplementierung]] von JAXB ist Teil des [[Metro (Java)|Metro]]-Projektes der [[GlassFish]]-Community.<ref>{{Webarchiv|url=https://jaxb.dev.java.net/ |wayback=20070711092851 |text=JAXB Reference Implementation |archiv-bot=2019-09-12 20:34:53 InternetArchiveBot }}</ref>

Seit Version 9 ist JAXB nicht mehr Bestandteil der [[Java-Laufzeitumgebung|JRE]] und des JDK.<ref>{{Internetquelle | url=http://cr.openjdk.java.net/~iris/se/9/java-se-9-fr-spec/#APIs-proposed-for-removal | titel= Java SE 9 ( JSR 379) Final Release Specification: APIs proposed for removal | sprache=en | datum= | zugriff=2019-05-14}}</ref><ref>{{Internetquelle | url=http://openjdk.java.net/jeps/320 | titel=JEP 320: Remove the Java EE and CORBA Modules | sprache=en | datum= | zugriff=2019-05-14}}</ref>

== Objekt-zu-XML-Transformation ==
[[Datei:Unmarshalling-Marshalling.PNG|rand|rechts|275px|Marshalling und Unmarshalling]]

''[[Marshalling]]'' generiert bei JAXB aus einem Baum von Java-Objekten ein XML-Dokument. Dies ist eine spezielle Form der [[Serialisierung]]. [[Anwendungsfall|Anwendungsfälle]] für diese Umwandlung sind beispielsweise [[Persistenz (Informatik)|Persistierung]] in einer Datei oder Übertragung über ein Netzwerk. Der umgekehrte Weg heißt ''[[Unmarshalling]]'' – eine spezielle Form der [[Deserialisierung]]. Hierbei wird aus einem gegebenen XML-Dokument wieder ein Baum von Java-Objekten generiert. Um eine solche Umwandlung eindeutig zu realisieren, verwendet man XML-Schemata. Die verwendeten XML-Dokumente gehorchen den im Schema definierten Regeln. Man nennt sie auch Schema-Instanzen.

== Datenbindung ==
Der Begriff der ''Datenbindung'' innerhalb dieses Konzeptes beschreibt einen Satz von Regeln, welche die Abbildung/Repräsentation des XML-Schemas gegenüber den zu generierenden Java-Objekten bestimmen. Auf diese vorgegebenen Regeln kann durch ''Binding Customizations'' Einfluss genommen werden. Dies kann durch Inline-Notizen im [[XML-Schema]] oder durch eine gesonderte Datei geschehen, die dann dem ''Binding Compiler'' mit übergeben wird. Dieser hat dann die Aufgabe, das XML-Schema auf eine entsprechende Java-Objekt-Struktur abzubilden.

Die Tabelle unten listet die Abbildung der [[XML-Schema (W3C)|XML-Schema]]-Datentypen (XSD) zu den entsprechenden Datentypen in Java in JAXB auf.<ref>{{cite web
| url = http://download.oracle.com/docs/cd/E12840_01/wls/docs103/webserv/data_types.html#wp223908
| title = Using JAXB Data Binding: Standard Data Type Mapping
| accessdate=2014-04-25| offline= }}</ref>

{| class="wikitable sortable" style="font-size: 100%; text-align: left; width: 35%;"
|-
! XML-Schematyp
! Java-Datentyp
|-
|<code>xsd:anySimpleType</code><ref>for <code>xsd:element</code> of this type</ref>
|<code>java.lang.Object</code>
|-
|<code>xsd:anySimpleType</code><ref>for <code>xsd:attribute</code> of this type</ref>
|<code>java.lang.String</code>
|-
|<code>xsd:base64Binary</code>
|<code>'''byte[]'''</code>
|-
|<code>xsd:boolean</code>
|<code>'''boolean'''</code>
|-
|<code>xsd:byte</code>
|<code>'''byte'''</code>
|-
|<code>xsd:date</code>
|<code>javax.xml.datatype.XMLGregorianCalendar</code>
|-
|<code>xsd:dateTime</code>
|<code>javax.xml.datatype.XMLGregorianCalendar</code>
|-
|<code>xsd:decimal</code>
|<code>java.math.BigDecimal</code>
|-
|<code>xsd:double</code>
|<code>'''double'''</code>
|-
|<code>xsd:duration</code>
|<code>javax.xml.datatype.Duration</code>
|-
|<code>xsd:float</code>
|<code>'''float'''</code>
|-
|<code>xsd:g</code>
|<code>javax.xml.datatype.XMLGregorianCalendar</code>
|-
|<code>xsd:hexBinary</code>
|<code>'''byte[]'''</code>
|-
|<code>xsd:int</code>
|<code>'''int'''</code>
|-
|<code>xsd:integer</code>
|<code>java.math.BigInteger</code>
|-
|<code>xsd:long</code>
|<code>'''long'''</code>
|-
|<code>xsd:NOTATION</code>
|<code>javax.xml.namespace.QName</code>
|-
|<code>xsd:positiveInteger</code>
|<code>java.math.BigInteger</code>
|-
|<code>xsd:QName</code>
|<code>javax.xml.namespace.QName</code>
|-
|<code>xsd:short</code>
|<code>'''short'''</code>
|-
|<code>xsd:string</code>
|<code>java.lang.String</code>
|-
|<code>xsd:time</code>
|<code>javax.xml.datatype.XMLGregorianCalendar</code>
|-
|<code>xsd:unsignedByte</code>
|<code>'''short'''</code>
|-
|<code>xsd:unsignedInt</code>
|<code>'''long'''</code>
|-
|<code>xsd:unsignedLong</code>
|<code>java.math.BigDecimal</code>
|-
|<code>xsd:unsignedShort</code>
|<code>'''int'''</code>
|}

== JAXB Binding Framework ==
Das ''JAXB Binding Framework'' besteht im Kern aus drei Java-Paketen:

* <code>jakarta.xml.bind</code>
* <code>jakarta.xml.bind.util</code>
* <code>jakarta.xml.bind.helpers</code>

Die letzten beiden Pakete liefern unterstützende Funktionen für das Hauptpaket <code>jakarta.xml.bind</code>.

Die Klasse <code>JAXBContext</code> aus <code>jakarta.xml.bind</code> stellt den Eingangspunkt zur Nutzung des Frameworks innerhalb einer eigenen Java-Anwendung dar.

<syntaxhighlight lang="java">
JAXBContext jc = JAXBContext.newInstance("com.acme.foo:com.acme.bar");
Unmarshaller u = jc.createUnmarshaller();
FooObject fooObj = (FooObject) u.unmarshal(new File("foo.xml"));
BarObject barObj = (BarObject) u.unmarshal(new File("bar.xml"));
</syntaxhighlight>

Aus dem erstellten Kontext-Objekt wird nun ein „Unmarshaller“ generiert. Mit diesem können dann die XML-Daten auf Java-Objekte abgebildet werden.

Seit JAXB 2.1 stellt die Hilfsklasse <code>JAXB</code> aus <code>jakarta.xml.bind</code> einen vereinfachten Weg dar, dies zu erreichen. Die Erzeugung des Kontextes und des Unmarshallers wird durch diese automatisch intern vorgenommen, was gerade Einsteigern die Nutzung von JAXB erheblich erleichtert. Nachteilig hierbei ist jedoch, dass diese Objekte bei jedem Aufruf neu erzeugt werden, sodass in einigen Anwendungsfällen ein Geschwindigkeitsnachteil resultiert:

<syntaxhighlight lang="java">
FooObject fooObj = JAXB.unmarshal(new File("foo.xml"), FooObject.class);
BarObject barObj = JAXB.unmarshal(new File("bar.xml"), BarObject.class);
</syntaxhighlight>

Um die Datenobjekte wieder zurück in die XML-Form zu bringen, wird ein „Marshaller“ aus dem Kontext-Objekt erzeugt. Ihm werden das Datenobjekt und ein Streamobjekt (<code>java.io.OutputStream</code> oder <code>java.io.Writer</code>) übergeben.

<syntaxhighlight lang="java">
Marshaller m = jc.createMarshaller();
m.marshal(fooObj, System.out);
</syntaxhighlight>

Auch an dieser Stelle erleichtert JAXB 2.1 die Programmierung durch die Hilfsklasse <code>JAXB</code>, welche den Marshaller intern erzeugt und somit zu kürzerem Quellcode führt:

<syntaxhighlight lang="java">
JAXB.marshal(fooObj, System.out);
</syntaxhighlight>

== Alternativen ==
Die folgenden Java XML Binding Frameworks können als Alternative zu JAXB verwendet werden:
* [[Apache XMLBeans]]
* [[Castor (Framework)]]
* [[JiBX]]
* [[CookXML]]
* [[XStream]]
* [[Apache Commons Betwixt]]
* [[Simple XML Serialization]]

== Weblinks ==
* [https://jakarta.ee/specifications/xml-binding/ JAXB-Referenzimplementierung] – Referenzimplementierung und JAXB-Spezifikation
* [http://jaxb.java.net/tutorial/ JAXB-Tutorial]
* [http://docs.oracle.com/cd/E17802_01/webservices/webservices/docs/2.0/tutorial/doc/JAXBWorks.html JAXB-Kapitel] aus dem ''Java Web Services Tutorial'' von Sun/Oracle
* [http://www.oracle.com/technetwork/articles/javase/index-140168.html Überblick über JAXB.] Sun/Oracle
* [http://openbook.galileocomputing.de/javainsel/javainsel_16_004.html Deutschsprachiges Tutorial.] In: ''Java ist auch eine Insel''
* [https://jakarta.ee/specifications/xml-binding/3.0/apidocs/jakarta.xml.bind/jakarta/xml/bind/jaxb Die Hilfsklasse <code>JAXB</code>.] jakarta.ee

== Einzelnachweise ==
<references />

[[Kategorie:Java-Programmierschnittstelle]]
[[Kategorie:XML]]

Jakarta XML Binding - Versionsgeschichte

87.139.216.203: Komma vor "und" entfernt, es handelt sich um eine Aufzählung