Dieser Artikel beschreibt die Integration von JAXB als neue Schnittstelle zur Enterprise Integration und setzt damit die Serie von Artikeln zu diesem Thema fort.

Marshaling

Unter Marshaling versteht man die Erzeugung eines XML-Dokumentes aus einem Java-Objekts (einer Instanz einer Java-Klasse). dWb+ bietet dazu ein Modul, das in der Lage ist, Instanzen jeglicher mittels des Werkzeugs xjc instrumentierten Java-Klassen in einen XML-String umzuwandeln.

Falls also die Notwendigkeit entsteht, für die Umsetzung einer bestimmten Anforderung neue Klassen zu schaffen, deren Instanzen per JAXB in XML-Dokumente gewandelt werden sollen, genügt es, diese Klassen zu kompilieren und dem Modul-ClassLoader zugänglich zu machen

Unmarshaling

Unter Unmarshaling versteht man das Einlesen und Parsen eines XML-Dokumentes, um mittels der gewonnenen Informationen eine Instanz einer Java-Klasse daraus erzeugen und ihren internen Status rekonstruieren zu können.

Leider kann man dazu kein allgemeingültiges Modul schaffen, da ein solches Modul ja naturgemäß immer einen aneren Ausgangstyp haben müsste. Möchte man XML-Dokumente in dWb+ benutzen können, um daraus Instanzen von Java-Klassen zu erzeugen und diese dann weiterzuverwenden, muß man diese Klassen zunächst schaffen. Das kann zum Beispiel durch Anwendung des Werkzeugs xjc auf das entsprechende XML-Schema geschehen. Anschließend müssen diese Klassen kompiliert und dem Modul-ClassLoader zugänglich gemacht werden.

Zusätzlich dazu muß noch ein Modul pro Java-Klasse geschrieben werden, die aus XML-Dokumenten rekonstruiert werden sollen.

Selber machen oder Basisklasse benutzen?

Man kann natürlich einen JAXB-Parser auch selbst schreiben - allerdings besteht dazu kein Grund, solange man damit leben kann, daß der Inhalt des XML-Dokuments als Java-String vorliegen muß: Es existiert bereits eine Basisklasse, von der man einfach ableiten kann. Diese abgeleitete Klasse muß einen Typparameter spezifizieren und die Klasse angeben, für deren Unmarshaling sie verantwortlich sein soll: In dem folgenden Beispiel soll ein Modul entstehen, das in der Lage ist, Dokumente in Instanzen der Klasse Shiporder aus dem Namensraum generated.example1 zu wandeln:

import de.elbosso.dataflowframework.modules.JaxbBase;
import generated.example1.Shiporder;
		
public class ShipOrder extends JaxbBase<Shiporder>
{
	public ShipOrder()
	{
		super(Shiporder.class);
	}	
}
			

Das ist tatsächlich schon alles - Damit können jetzt Dokumente, die dem Schema folgen, aus dem die Klasse Shiporder im Namensraum generated.example1 generiert wurde, in Instanzen dieser Klasse umgewandelt werden.

Artikel, die hierher verlinken