StAX: So parst man XML-Code mit Java

Peter Mikhalenko

13. August 2008

1 Kommentar

Empfehlen

Die Cursor-API

Die XMLStreamReader-Schnittstelle repräsentiert einen Cursor, der vom Anfang bis zum Ende eines XML-Dokuments bewegt wird. Zu jedem Zeitpunkt zeigt dieser Cursor auf eines der folgenden Elemente: einen Textknoten, einen Start-Tag, einen Kommentar, den Anfang des Dokuments und so weiter. Der Cursor bewegt sich immer vorwärts, in der Regel jeweils nur um ein Element.

Der Aufruf von Methoden wie getName() oder getText() auf dem XMLStreamReader liefert Informationen über das Element, an dem der Cursor derzeit positioniert ist.

Mehr zu ...

Und so wird üblicherweise ein Parser geladen, der von der installierten StAX-Implementierung abhängt:

Der XMLStreamReader lässt sich aus jeder anderen Nachfolgerklasse von java.io.Reader erstellen. Die next()-Methode bewegt den Cursor zum nächsten Element. Wenn der Cursor am aktuellen Element positioniert ist, stehen unterschiedliche Getter-Methoden zur Verfügung, um Daten vom aktuellen Element abzurufen. Dies sind die wichtigsten Getter-Methoden:

public QName    getName()
public String   getLocalName()
public String   getNamespaceURI()
public String   getText()
public String   getElementText()
public int      getEventType()
public Location getLocation()
public int      getAttributeCount()
public QName    getAttributeName(int index)
public String   getAttributeValue(String namespaceURI, String localName)
//Die Schleife mit switch-Klausel ist ein sehr häufiges Muster in StAX. Es gibt mehrere Möglichkeiten, den Ereignisstrom zu filtern: Beispielsweise lässt sich anstelle der switch-Klausel eine Folge von if-else-Anweisungen einsetzen. Aber fast alle StAX-Programme werden eine Ereignisschleife ähnlich wie diese verwenden:
int inHeader = 0;
for (int event = parser.next();
event != XMLStreamConstants.END_DOCUMENT;
event = parser.next()) {
switch (event) {
case XMLStreamConstants.START_ELEMENT:
if (isHeader(parser.getLocalName())) {
inHeader++;
}
break;
case XMLStreamConstants.END_ELEMENT:
if (isHeader(parser.getLocalName())) {
inHeader--;
if (inHeader == 0) System.out.println();
}
break;
case XMLStreamConstants.CHARACTERS:
if (inHeader > 0)  System.out.print(parser.getText());
break;
case XMLStreamConstants.CDATA:
if (inHeader > 0)  System.out.print(parser.getText());
break;
} // Ende switch
} // Ende while
//Die isHeader()-Funktion überprüft, ob das aktuelle Element eine h1- oder h2-Überschrift in HTML darstellt:
private static boolean isHeader(String name) {
if (name.equals("h1")) return true;
if (name.equals("h2")) return true;
return false;
}

Der letzte Codeschnipsel liest ein XHTML-Dokument und druckt den Inhalt aller Überschriften-Elemente h1 und h2 aus.

Inhalt

Teil 1: StAX: So parst man XML-Code mit Java
Teil 2: Beispielcode
Teil 3: Die Cursor-API
Teil 4: XML-Code schreiben

Fanden Sie diesen Artikel nützlich?
3 von 5 Lesern fanden diesen Artikel nützlich.

Lesermeinungen zum Artikel

Kommentar verfassen

von Det

am 2. Juni 2009, 13:58 Uhr

Unleserliche Codepräsentation macht den Artikel zu einer Qual

Hallo,

dieser Artikel könnte vielleicht sehr nützlich sein (ich hätte die Info für ein Terminprojekt gerade dringend gebrauchen können).

Leider habe ich keine Lust, jedes Codebeispiel erst aus dem Scroll-Feld herauszukopieren und durch einen Beautifyer zu schicken, damit ich das Ganze nachvollziehen kann.

Wenn der Artikel bspw. auch druckbar sein soll, dann sollte man den Code schon qualifizierter präsentieren. Im Druck wird 1.) die Schmalspaltensicht beibehalten und zum Anderen nur der Viewport gezeigt. Alles andere wird abgeschnitten.

Diese Codepräsentation finde ich auf einer IT-lastigen Site wie ZDNet doch eher lächerlich!

Auf diesen Kommentar antworten