java.lang.Object
   |
   +--org.xml.sax.HandlerBase

Deklaration

Beschreibung

HandlerBase stellt in Analogie zu den Adapter-Klassen des AWT oder Swing eine Dummy-Implementierung der Interfaces EntityResolver, DTDHandler, DocumentHandler und ErrorHandler dar. Sämtliche Methoden sind »leer« implementiert. XML-Applikationen können von dieser Klasse abgeleitet werden und brauchen dann nur die tatsächlich benötigten Methoden zu überschreiben.

Konstruktoren im Detail

public HandlerBase()

Erzeugt ein neues Exemplar.

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. Diese Methode ist leer implementiert.

Exception: SAXException

• Wenn bei der Verarbeitung ein Fehler auftritt.

public void endDocument()

Wird aufgerufen, wenn das Ende des Dokuments erreicht wird. Diese Methode ist leer implementiert.

Exception: SAXException

• Wenn bei der Verarbeitung ein Fehler auftritt.

public void endElement(String name)

Wird aufgerufen, wenn das Ende des Elements name erreicht wird. Diese Methode ist leer implementiert.

Exception: SAXException

• Wenn bei der Verarbeitung ein Fehler auftritt.

public void error(SAXParseException e)

Signalisiert der XML-Applikation einen Fehler (»error«) im Sinne der XML-Spezifikation. Nach dem Aufruf dieser Methode fährt der Parser mit der Verarbeitung des Dokuments fort. Diese Methode ist leer implementiert.

Exception: SAXException

• Wenn bei der Verarbeitung ein Fehler auftritt.

public void fatalError(SAXParseException e)

Signalisiert der XML-Applikation einen kritischen Fehler (»fatal error«) im Sinne der XML-Spezifikation. Nach dem Aufruf dieser Methode kann der Parser die Verarbeitung des Dokuments abbrechen. Diese Methode ist leer implementiert.

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. Diese Methode ist leer implementiert.

Exception: SAXException

• Wenn bei der Verarbeitung ein Fehler auftritt.

public void notationDecl(String name, String publicId, String systemId)

Wird aufgerufen, wenn eine Definition einer Notation mit dem Namen name angetroffen wird. publicId oder systemId enthält die Public- oder die System-ID der Notation, je nachdem, was angegeben wurde. Für den jeweils anderen Parameter wird null übergeben. Diese Methode ist leer implementiert.

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. Diese Methode ist leer implementiert.

Exception: SAXException

• Wenn bei der Verarbeitung ein Fehler auftritt.

public InputSource resolveEntity(String publicId, String systemId)

Löst die durch die Parameter bezeichnete externe Entity auf. Diese Methode ist so implementiert, daß sie grundsätzlich null liefert, wodurch der Parser veranlaßt wird, die mit systemId bezeichnete Datei zu laden.

Exception: SAXException

• Wenn bei der Verarbeitung ein Fehler auftritt.

public void setDocumentLocator(Locator locator)

Registriert ein Locator-Objekt bei der XML-Applikation. Diese Methode ist leer implementiert.

public void startDocument()

Wird aufgerufen, wenn der Anfang des Dokuments erreicht wird. Diese Methode ist leer implementiert.

Exception: SAXException

• Wenn bei der Verarbeitung ein Fehler auftritt.

public void startElement(String name, AttributeList attributes)

Wird aufgerufen, wenn der Anfang des Elements name erreicht wird. In atts werden die Attribute übergeben. Dieses Objekt ist nur während der Ausführung dieser Methode gültig. Falls es darüber hinaus gespeichert werden soll, kann mit dem parameterbehafteten Konstruktor der Klasse AttributeListImpl im Unterpaket helpers eine Kopie erzeugt werden. Diese Methode ist leer implementiert.

Exception: SAXException

• Wenn bei der Verarbeitung ein Fehler auftritt.

public void unparsedEntityDecl(String name, String publicId, String systemId, String notationName)

Wird aufgerufen, wenn eine Definition einer nicht-analysierten Entity mit dem Namen name angetroffen wird. publicId enthält die Public-ID. Diese Methode ist leer implementiert.

public void warning(SAXParseException e)

Signalisiert der XML-Applikation ein Ereignis, das weder ein Fehler (»error«) noch ein kritischer Fehler (»fatal error«) im Sinne der XML-Spezifikation ist. Nach dem Aufruf dieser Methode fährt der Parser mit der Verarbeitung des Dokuments fort. Diese Methode ist leer implementiert.

Exception: SAXException

• Wenn bei der Verarbeitung ein Fehler auftritt.