Deklaration

Beschreibung

Parser definiert eine Schnittstelle, die von allen SAX-konformen Parsern implementiert werden muß. Ein Parser-Exemplar kann für mehrere Parse-Vorgänge benutzt werden, d. h., die Methode parse() kann mehrfach hintereinander aufgerufen werden. Unzulässig sind dagegen parallele Aufrufe von parse() auf demselben Exemplar von mehreren Threads aus.

Methoden im Detail

public void parse(InputSource source)

Parst das durch source gegebenen Dokument und benachrichtigt die registrierten Handler-Objekte entsprechend.

Exception: SAXException

• Falls beim Parsen des Dokuments ein Fehler aufgetreten ist.

Exception: IOException

• Falls beim Lesen aus source ein Fehler aufgetreten ist.

public void parse(String systemId)

Parst das durch die System-ID systemId gegebenen Dokument und benachrichtigt die registrierten Handler-Objekte entsprechend.

Exception: SAXException

• Falls beim Parsen des Dokuments ein Fehler aufgetreten ist.

Exception: IOException

• Falls beim Lesen der durch systemId bezeichneten Quelle ein Fehler aufgetreten ist.

public void setDocumentHandler(DocumentHandler handler)

Setzt den Event-Handler für Exemplar-bezogene Ereignisse auf handler. Falls zuvor bereits ein Event-Handler registriert war, wird dieser ersetzt. Diese Methode kann auch während eines Parse-Durchgangs aufgerufen werden, wodurch der Parser sofort auf den neuen Event-Handler »umschaltet«.

public void setDTDHandler(DTDHandler handler)

Setzt den Event-Handler für DTD-bezogene Ereignisse auf handler. Falls zuvor bereits ein Event-Handler registriert war, wird dieser ersetzt. Diese Methode kann auch während eines Parse-Durchgangs aufgerufen werden, wodurch der Parser sofort auf den neuen Event-Handler »umschaltet«.

public void setEntityResolver(EntityResolver resolver)

Setzt den verwendeten Entity-Resolver auf resolver. Wenn eine XML-Applikation keinen Resolver setzt, löst der Parser die Entitites durch Laden der durch die System-Id bezeichneten Datei auf. Durch Übergabe von null kann dieses voreingestellte Verhalten wieder aktiviert werden. Diese Methode kann auch während eines Parse-Durchgangs aufgerufen werden, wodurch der Parser sofort auf den neuen Resolver »umschaltet«.

public void setErrorHandler(ErrorHandler handler)

Setzt den Event-Handler für auftretende Fehler auf handler. Falls zuvor bereits ein Fehler-Handler registriert war, wird dieser ersetzt. Diese Methode kann auch während eines Parse-Durchgangs aufgerufen werden, wodurch der Parser sofort auf den neuen Fehler-Handler »umschaltet«.

public void setLocale(Locale locale)

Mit dieser Methode kann dem Parser eine Vorgabe für länderspezifische Warn- und Fehlermeldungen gemacht werden. Falls der Parser locale nicht unterstützt, wird eine SAXException ausgelöst.

Exception: SAXException

• Falls locale nicht unterstützt wird.