Deklaration

Beschreibung

• Anfang und Ende des Dokuments
• Anfang und Ende eines Elements
• Antreffen einer Processing Instruction
• Antreffen von Zeichendaten
• Antreffen von vernachlässigbaren Whitespace-Zeichen
• Überspringen von Entities

Methoden im Detail

public void characters(char[] ch, int start, int length)

Benachrichtigt die XML-Applikation vom Antreffen von Zeichendaten. Die Zeichendaten befinden sind in den ersten length Zeichen ab der Position start in ch. Die XML-Applikation darf nur den durch start und length definierten Bereich von ch auslesen.

Exception: SAXException

• Wenn bei der Verarbeitung ein Fehler auftritt.

public void endDocument()

Wird aufgerufen, wenn das Ende des Dokuments erreicht wird.

Exception: SAXException

• Wenn bei der Verarbeitung ein Fehler auftritt.

public void endElement(String namespaceURI, String localName, String qName)

Wird aufgerufen, wenn das Ende eines Elements erreicht wird. In Abhängigkeit von der Unterstützung für Namensräume wird der Name des Elements in localName oder qName übergeben. namespaceURI enthält gegebenenfalls den Namensraum, dem das Element zugeordnet ist.

Exception: SAXException

• Wenn bei der Verarbeitung ein Fehler auftritt.

public void endPrefixMapping(String prefix)

Signalisiert das Ende der Präfix/URI-Zuordnung für prefix.

Exception: SAXException

• Wenn bei der Verarbeitung ein Fehler auftritt.

public void ignorableWhitespace(char[] ch, int start, int length)

Benachrichtigt die XML-Applikation vom Antreffen von Whitespace-Zeichen, die nach der Spezifikation ignoriert werden können. Die Zeichen befinden sind in den ersten length Zeichen ab der Position start in ch enthalten. Die XML-Applikation darf nur den durch start und length definierten Bereich von ch auslesen.

Exception: SAXException

• Wenn bei der Verarbeitung ein Fehler auftritt.

public void processingInstruction(String target, String data)

Wird aufgerufen, wenn eine Processing Instruction angetroffen wird. target ist das Target, für data wird die Anweisung übergeben.

Exception: SAXException

• Wenn bei der Verarbeitung ein Fehler auftritt.

public void setDocumentLocator(Locator locator)

Mit dieser Methode liefert der Parser der XML-Applikation ein Locator-Objekt, mit dem die sie bei der Traversierung des Parse-Baums die Position der einzelnen Events im Dokument (Zeile und Spalte) ermitteln kann. Die SAX-API schreibt nicht zwingend vor daß der Parser diese Methode aufrufen muß. Falls er diese Methode aber unterstützt, muß sie vor allen anderen Methoden dieses Interface aufgerufen werden. Das übergebene Locator-Objekt enthält nur während des Aufrufs der Event-Handler-Methoden gültige Werte.

public void skippedEntity(String name)

Wird aufgerufen, wenn eine Entity mit dem Namen name überlesen wird. Falls es sich um eine Referenz auf eine externe DTD handelt, wird "[dtd]" geliefert.

Exception: SAXException

• Wenn bei der Verarbeitung ein Fehler auftritt.

public void startDocument()

Wird aufgerufen, wenn der Anfang des Dokuments erreicht wird.

Exception: SAXException

• Wenn bei der Verarbeitung ein Fehler auftritt.

public void startElement(String namespaceURI, String localName, String qName, Attributes atts)

Wird aufgerufen, wenn der Anfang eines Elements erreicht wird. In atts werden die Attribute übergeben. In Abhängigkeit von der Unterstützung für Namensräume wird der Name des Elements in localName oder qName übergeben. namespaceURI enthält gegebenenfalls den Namensraum, dem das Element zugeordnet ist.

Exception: SAXException

• Wenn bei der Verarbeitung ein Fehler auftritt.

public void startPrefixMapping(String prefix, String uri)

Teilt der XML-Applikation mit, welcher URI mit dem Präfix prefix assoziiert ist.

Exception: SAXException

• Wenn bei der Verarbeitung ein Fehler auftritt.