Referenz: org.xml.sax.ext.LexicalHandler

Weitere aktuelle Java-Titel finden Sie bei dpunkt.

Interface org.xml.sax.ext.LexicalHandler

SAX 2.0

Deklaration

public interface LexicalHandler

Beschreibung

Dieses Interface definiert eine Zusatzschnittstelle, mit der eine SAX-Applikation Informationen über die lexikalischen Bestandteile im gesamten Dokument erhalten kann. Die Registrierung beim Parser erfolgt nicht über die üblichen setXXHandler()-Methoden, sondern über eine Parser-Property:

  http://xml.org/sax/properties/lexical-handler

Diese Property muß über einen Aufruf von setProperty() des Parser-Objekts auf ein Objekt gesetzt werden, das dieses Interface implementiert.

Methoden
public void	comment(char[] ch, int start, int length)
public void	endCDATA()
public void	endDTD()
public void	endEntity(String name)
public void	startCDATA()
public void	startDTD(String name, String publicId, String systemId)
public void	startEntity(String name)

Methoden im Detail

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

Benachrichtigt die XML-Applikation über einen Kommentar in der DTD oder im Dokument selbst. Der angetroffene Kommentar befindet sich im Array ch ab der Position start mit einer Länge von length Zeichen.

Exception: SAXException

Wenn bei der Verarbeitung ein Fehler auftritt.

public void endCDATA()

Benachrichtigt die XML-Applikation vom Ende eines CDATA-Abschnitts.

Exception: SAXException

Wenn bei der Verarbeitung ein Fehler auftritt.

public void endDTD()

Benachrichtigt die XML-Applikation über das Ende der DTD.

Exception: SAXException

Wenn bei der Verarbeitung ein Fehler auftritt.

public void endEntity(String name)

Benachrichtigt die XML-Applikation über das Ende einer Parameter-Entity.

Exception: SAXException

Wenn bei der Verarbeitung ein Fehler auftritt.

public void startCDATA()

Benachrichtigt die XML-Applikation vom Beginn eines CDATA-Abschnitts.

Exception: SAXException

Wenn bei der Verarbeitung ein Fehler auftritt.

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

Benachrichtigt die XML-Applikation über die Referenzierung einer DTD im Dokument. Dieser Aufruf erfolgt, bevor ein gegebenenfalls registrierter DTDHandler oder DeclHandler Ereignisse erhält. In name wird der Name der DTD übergeben, publicId und systemId enthalten die Referenzen auf die DTD, sofern eine externe DTD vorliegt. Ist das nicht der Fall, wird null übergeben.

Exception: SAXException

Wenn bei der Verarbeitung ein Fehler auftritt.

public void startEntity(String name)

Benachrichtigt die XML-Applikation über den Anfang einer Parameter-Entity. Hierzu muß die Parser-Property http://xml.org/sax/properties/lexical-handler/parameter-entities gesetzt werden.

Exception: SAXException

Wenn bei der Verarbeitung ein Fehler auftritt.