JAXenter

Für die Verarbeitung von XML-Daten stehen inzwischen viele Java-Bibliotheken zur Verfügung. Stellvertretend seien hier Castor und XStream aufgeführt. Für das Einlesen (keine Ausgabemöglichkeit vorhanden) von XML-Daten gesellt sich Xmappr dazu. Die Bibliothek steht unter der BSD-Lizenz (Variante aus dem Jahr 2008) zur Verfügung. Als Voraussetzung gilt Java 5. Das Mapping der XML-Daten auf Java-Klassen kann mittels Annotationen oder XML-Konfiguration erfolgen. Für das Parsen setzt Xmappr (aktuelle Version: 0.9.2) auf den JSR-173-Standard StaX (Streaming API for XML). Im Fall von Java 6 ist dieses API durch das Paket javax.xml.stream bereits als Bordmittel dabei. Bei Java 5 muss es noch nachgerüstet werden. In den FAQ zu Xmappr wird als StaX-Parser Woodstock empfohlen.

Integration ins Projekt

Für die Integration in ein Java-6-Projekt reicht der Download der 86 KB großen Bibliothek (Name: xmappr-0.9.2.jar) aus. Im Fall von Java 5 wird noch ein StaX-Parser benötigt. Der empfohlene Parser Woodstock steht auch als Binärdatei zum Download bereit.

Für die Integration in ein Maven-Projekt steht ein Repository zur Verfügung. Nachfolgende Zeilen müssen der Projekt-POM an den entsprechenden Stellen hinzugefügt werden:

1. <dependency>
2. <groupId>org.xmappr</groupId>
3. <artifactId>xmappr</artifactId>
4. <version>0.9.2</version>
5. </dependency>
7. <repository>
8. <id>xmappr-repo-googlecode</id>
9. <name>Xmappr Repository</name>
10. <url>http://xmappr.googlecode.com/svn/repo/</url>
11. </repository>

Auf Tuchfühlung

Die Stärken von Xmappr zeigen sich am schnellsten in einem Beispiel. Als Grundlage soll nachfolgende XML-Datei dienen.

1. <book language="de">
2. <name>Buchname</name>
3. <isbn>123456</isbn>
4. </book>

Wie schon zu Anfang erwähnt, existieren in Xmappr zwei Möglichkeiten zur Abbildung von XML-Daten auf Java-Klassen: über Annotationen und über XML-Konfiguration.

Zunächst zu den Annotationen. Die Klasse selbst muss über die Annotation @RootElement markiert werden. Hierbei wird der Name des Einstiegsknotens angegeben. Elemente werden über die Annotation @Element und Attribute über @Attribute konfiguriert. Wenn keine direkte Korrelation über den Namen hergestellt werden kann, dann ist der Name als Parameter der Annotation anzugeben. Nachfolgendes Quellcodebeispiel mappt die obere XML-Datei auf die entsprechenden Instanzvariablen der Klasse Buch.

1. @RootElement(name="book")
2. public class Buch {
3. @Element
4. private String name;
5. @Element
6. private String isbn;
7. @Attribute(name="language")
8. private String language;
10. public String getName() {
11. return name;
12. }
13. public void setName(String name) {
14. this.name = name;
15. }
16. public String getIsbn() {
17. return isbn;
18. }
19. public void setIsbn(String isbn) {
20. this.isbn = isbn;
21. }
22. public String getLanguage() {
23. return language;
24. }
25. public void setLanguage(String language) {
26. this.language = language;
27. }
28. }