Referenz: javax.xml.parsers.DocumentBuilder

Weitere aktuelle Java-Titel finden Sie bei dpunkt.

Klasse javax.xml.parsers.DocumentBuilder

JAXP 1.0

java.lang.Object
   |
   +--javax.xml.parsers.DocumentBuilder

Deklaration

public abstract class DocumentBuilder extends java.lang.Object

Beschreibung

Mit dieser Klasse kann ein XML-Dokument geparst und anschließend eine DOM-Darstellung des Dokuments abgerufen werden. Exemplare von DocumentBuilder werden nicht direkt, sondern mit der Methode newDocumentBuilder() der Factory DocumentBuilderFactory erzeugt.

Konstruktoren
protected	DocumentBuilder()

Methoden
public abstract DOMImplementation	getDOMImplementation()
public abstract boolean	isNameSpaceAware()
public abstract boolean	isValidating()
public abstract Document	newDocument()
public abstract Document	parse(InputSource is)
public domDocument	parse(File f)
public domDocument	parse(InputStream is)
public domDocument	parse(String uri)
public domDocument	parse(InputStream is, String systemId)
public void	setEntityResolver(EntityResolver resolver)
public void	setErrorHandler(ErrorHandler handler)

Konstruktoren im Detail

protected DocumentBuilder()
Ein geschützter Konstruktor.

Methoden im Detail

public abstract DOMImplementation getDOMImplementation()
Liefert ein Deskriptor-Objekt für die zugrundeliegende DOM-Implementierung zurück.

public abstract boolean isNameSpaceAware()
Liefert true, falls der zugrundeliegende Parser Namensräume unterstützt, sonst false.

public abstract boolean isValidating()
Liefert true, falls der zugrundeliegende Parser validierend ist, sonst false.

public abstract Document newDocument()
Erzeugt ein neues Document-Exemplar und liefert es zurück.

public abstract Document parse(InputSource is)

Parst das durch source gegebene Dokument und liefert ein entsprechendes Document-Exemplar zurück.

Exception: SAXException

Falls beim Parsen des Dokuments ein Fehler aufgetreten ist.

Exception: IOException

Falls beim Lesen aus is ein Fehler aufgetreten ist.

public domDocument parse(File f)

Parst das durch f gegebene Dokument und liefert ein entsprechendes Document-Exemplar zurück.

Exception: SAXException

Falls beim Parsen des Dokuments ein Fehler aufgetreten ist.

Exception: IOException

Falls beim Lesen aus f ein Fehler aufgetreten ist.

public domDocument parse(InputStream is)

Parst das durch is gegebene Dokument und liefert ein entsprechendes Document-Exemplar zurück.

Exception: SAXException

Falls beim Parsen des Dokuments ein Fehler aufgetreten ist.

Exception: IOException

Falls beim Lesen aus is ein Fehler aufgetreten ist.

public domDocument parse(String uri)

Parst das durch uri bezeichnete Dokument und liefert ein entsprechendes Document-Exemplar zurück.

Exception: SAXException

Falls beim Parsen des Dokuments ein Fehler aufgetreten ist.

Exception: IOException

Falls beim Lesen des Dokuments ein Fehler aufgetreten ist.

public domDocument parse(InputStream is, String systemId)

Parst das durch is gegebene Dokument und liefert ein entsprechendes Document-Exemplar zurück. Mit systemId kann eine Basis zur Auflösung relativer URIs angegeben werden.

Exception: SAXException

Falls beim Parsen des Dokuments ein Fehler aufgetreten ist.

Exception: IOException

Falls beim Lesen aus is ein Fehler aufgetreten ist.

public void setEntityResolver(EntityResolver resolver)
Setzt den verwendeten Entity-Resolver auf resolver. Durch Übergabe von null wird der Standardmechanismus der Implementierung verwendet.

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.