8.8Transformationen mit XSLT *
XSLT ist eine XML-Applikation zur Umwandlung von XML-Dateien in andere textbasierte Dateien. Die Ausgabedatei kann ein beliebiges Format haben. Die XSLT-Datei, in der Umwandlungsregeln festgelegt werden, muss ebenfalls eine XML-Datei sein. Das bedeutet insbesondere, dass HTML-Tags in der XSLT-Datei die Regeln für XML-Elemente erfüllen müssen.
8.8.1Templates und XPath als Kernelemente von XSLT
In der XSLT-Datei werden die Elemente der XML-Quelldatei durch Templates ausgewählt und wird die Formatierung der Ausgabe beschrieben. Es ist möglich, die Formatierung von Bedingungen abhängig zu machen, Elemente in der Ausgabe auszublenden und die Reihenfolge der Ausgabe festzulegen.
Die Auswahl der Elemente wird durch XPath-Ausdrücke beschrieben. XPath ist eine XML-Applikation, in der eine XML-Datei als Baumstruktur abgebildet wird. Durch eine Notation, die an die Baumstruktur von Verzeichnisbäumen angelehnt ist, können einzelne Elemente oder ganze Unterbäume ausgewählt werden.
Für unser Beispiel ist hier eine einfache XSLT-Datei angegeben, die eine XML-Ausgabe aus der Datei party.xml erzeugt. Dabei wird in dem ersten Template ein HTML-Rumpf erzeugt, in den die Ausgabe der anderen Templates eingebettet wird. Mit dem Element party wird eine Überschrift für die Ausgabedatei erzeugt. Das Element <gast> wird in einem Template benutzt, um für jeden Gast eine persönliche Anrede zu erzeugen. Jedem Gast wird sein Lieblingsgetränk serviert. Zum Schluss beschreibt noch jeder kurz, wie es ihm geht und ob er noch ledig ist. Hier ist die XSLT-Datei für die Umwandlung:
Listing 8.44party.xsl
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<!-- Match auf das Root-Element des XPath-Baums -->
<!-- Ausgabe von HTML-Kopf und -Fuss -->
<xsl:template match="/">
<html>
<head>
<title>Wir machen eine Party</title>
</head>
<body>
<!-- An dieser Stelle wird tiefer in den XPath-Baum -->
<!-- verzweigt. Die Ausgabe der anderen Templates -->
<!-- wird an dieser Stelle eingefuegt -->
<xsl:apply-templates />
</body>
</html>
</xsl:template>
<!-- Fuer das Element party der XML-Datei wird eine Ueberschrift -->
<!-- fuer die Ausgabe erzeugt. Das Attribut Datum wird in der -->
<!-- Ueberschrift ausgegeben. -->
<xsl:template match="party">
<h1>Partytabelle fuer den
<xsl:value-of select="@datum" />
</h1>
<xsl:apply-templates />
</xsl:template>
<!-- Fuer jeden einzelnen Gast wird eine Begruessung ausgegeben -->
<xsl:template match="gast">
<p>
<h2>Hallo
<xsl:value-of select="@name" />
</h2>
</p>
<xsl:apply-templates />
</xsl:template>
<!-- Jedem Gast wird sein Lieblingsgetraenk angeboten. -->
<xsl:template match="getraenk">
<p>Hier ist ein
<xsl:value-of select="." />
fuer dich.</p>
</xsl:template>
<!-- Hier wird eine bedingte Ausgabe erzeugt. Jeder Gast -->
<!-- zeigt seinen Zustand und sagt, ob er noch ledig ist. -->
<xsl:template match="zustand">
<xsl:if test="@nuechtern=’true’">
<h3>Ich bin noch nuechtern!</h3>
</xsl:if>
<xsl:if test="@ledig=’true’">
<h3>Ich bin noch zu haben!</h3>
</xsl:if>
<hr />
</xsl:template>
</xsl:stylesheet>
Das Ergebnis der Umwandlung ist folgende HTML-Datei:
<head>
<title>Wir machen eine Party</title>
</head>
<body>
<h1>Partytabelle fuer den 31.12.12</h1>
<p><h2>Hallo Albert Angsthase</h2></p>
<p>Hier ist ein Wein fuer dich.</p>
<p>Hier ist ein Bier fuer dich.</p>
<h3>Ich bin noch zu haben!</h3>
<hr>
<p><h2>Hallo Martina Mutig</h2></p>
<p>Hier ist ein Apfelsaft fuer dich.</p>
<h3>Ich bin noch nuechtern!</h3>
<h3>Ich bin noch zu haben!</h3>
<hr>
<p><h2>Hallo Zacharias Zottelig</h2></p>
</body>
</html>
Die Ausgabe des Parsers ist nicht so schön formatiert, aber das ist für die Ausgabe in HTML nicht relevant. Diese Datei wurde nachträglich formatiert, damit die Ausgabe besser lesbar ist. Trotz der Definition des Zeichensatzes im Kopf der XSLT-Datei sind Umlaute immer noch ein Problem.
8.8.2Umwandlung von XML-Dateien mit JDOM und JAXP
Damit die Umwandlung mit JDOM möglich ist, wird das JDOM-Dokument von einem Wrapper-Objekt aufgenommen und mit einem XSLT-Parser von JAXP umgewandelt. Das Ergebnis ist ein Wrapper-Objekt und kann in eine JDOM-Datenstruktur umgewandelt werden:
Listing 8.45com/tutego/insel/xml/xslt/XslTransformer.java, main()
Source xmlFile = new JDOMSource( doc );
JDOMResult htmlResult = new JDOMResult();
Transformer transformer =
TransformerFactory.newInstance().newTransformer(
new StreamSource("party.xsl") );
transformer.transform( xmlFile, htmlResult );
XMLOutputter xmlOutputter = new XMLOutputter();
xmlOutputter.output( doc, System.out );
xmlOutputter.output( htmlResult.getDocument(), System.out );
Das JDOM-Dokument doc wird vom Objekt xmlFile vom Typ JDOMSource ummantelt, das ein javax.xml.transform.Source ist. Das Ergebnis der Transformation nimmt ein JDOMResult-Objekt entgegen, das vom Typ javax.xml.transform.Result ist.
Eine Fabrikmethode der TransformerFactory erzeugt ein Objekt der Klasse Transformer. Dies ist ein Objekt aus dem JAXP-Paket, und es übernimmt die Umwandlung von XML-Dateien mithilfe einer XSLT-Datei. Für die Ein- und Ausgabe können Streams, SAX-Eigenschaften oder eine DOM-Datenstruktur verwendet werden. In diesem Beispiel wird die Datei als Stream an den Transformer übergeben. Mit dem Transformer-Objekt und einem Source- und Result-Objekt aus JAXP stößt transform(…) die Übersetzung an.
Das Ergebnis der Umwandlung steht in unserem JDOMResult-Objekt, und die Methode getDocument() wandelt es wieder in eine JDOM-Datenstruktur um.
Dieses Beispiel zeigt das Zusammenspiel von JDOM und JAXP. JDOM ist kein Ersatz für JAXP, sondern bietet eine komfortable Möglichkeit, XML-Dateien mit einer gewohnten Java-API zu verarbeiten. Dabei können Elemente aus JAXP, die nicht in JDOM implementiert sind, genutzt werden, ohne auf die Vorteile von JDOM zu verzichten.