StAX: So parst man XML-Code mit Java

Das Schreiben von XML erfolgt über die XMLStreamWriter-Schnittstelle. Dabei werden Methoden zum Festlegen von Elementen, Attributen, Kommentaren, Text und allen anderen Teilen eines XML-Dokuments bereitgestellt. Ein XMLStreamWriter wird wie folgt von einer XMLOutputFactory erstellt:

OutputStream out = new FileOutputStream("data.xml");
XMLOutputFactory factory = XMLOutputFactory.newInstance();
XMLStreamWriter writer = factory.createXMLStreamWriter(out);

Anschließend kommen unterschiedliche writeXXX()– Methoden zum Einsatz:

writer.writeStartDocument("ISO-8859-1", "1.0");
writer.writeStartElement("greeting"); writer.writeAttribute("id", "g1");
writer.writeCharacters("Hello StAX"); writer.writeEndDocument();

Ist das Dokument fertiggestellt, sollten der Speicher bereinigt und der Writer geschlossen werden. Doch das beendet nicht gleichzeitig den zugrundeliegenden Output-Stream. Daher gilt es, diesen ebenfalls zu schließen:

writer.flush(); writer.close(); out.close();

XMLStreamWriter hilft, für die Vollständigkeit des XML-Codes zu sorgen. So schließt beispielsweise endDocument alle ungeschlossenen Start-Tags. writeCharacters führt sämtliche erforderlichen Maskierungen von reservierten Zeichen wie „&“ oder „<“ durch. Allerdings fällt die Überprüfung nur minimal aus.

Welche StAX-Implementierungen gibt es?

Eine Reihe von StAX-Implementierungen ist verfügbar. Am wichtigsten sind die StAX-Implementierung von Sun, Woodstox (eine Open-Source-Implementierung von StAX) sowie die StAX-Referenzimplementierung von Codehaus.

Darüber hinaus bietet das StAX-Utils-Project eine Reihe von Utility-Klassen, die eine Integration von StAX in vorhandene Anwendungen zur XML-Verarbeitung erleichtern. StAX-Utils enthält zum Beispiel Klassen zum Einrücken und Formatieren des Codes in XML-Dateien.

Weitere Quellen:

• JSR 173: eine Streaming-API für XML
• Die JAXP-Referenzimplementierung enthält ebenfalls StAX.
• JAXP JavaDoc