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

Deklaration

Beschreibung

Konstruktoren im Detail

protected DocumentBuilderFactory()

Ein geschützter Konstruktor.

Methoden im Detail

public abstract Object getAttribute(String name)

Liefert das durch name bezeichnete Attribut der Implementierung zurück.

Exception: IllegalArgumentException

• Falls der übergebene Attributname nicht erkannt wird.

public boolean isCoalescing()

Liefert true, falls die Implementierung Parser erzeugt, die benachbarte Zeichendaten zu einem Textknoten zusammenführen, sonst false.

public boolean isExcpandEntityReferences()

Liefert true, falls die Implementierung Parser erzeugt, die Entity-Referenzen auflösen, sonst false.

public boolean isIgnoringComments()

Liefert true, falls die Implementierung Parser erzeugt, die XML-Kommentare ignorieren, sonst false.

public boolean isIgnoringElementContentWhitespace()

Liefert true, falls die Implementierung Parser erzeugt, die Leerzeichen ignorieren, die innerhalb von Elementen, aber außerhalb von Zeichendaten stehen. Ansonsten ist der Rückgabewert false.

public boolean isNameSpaceAware()

Liefert true, falls die Implementierung Parser erzeugt, die Namensräume unterstützen, sonst false.

public boolean isValidating()

Liefert true, falls die Implementierung validierende Parser erzeugt, sonst false.

public abstract DocumentBuilder newDocumentBuilder()

Erzeugt ein neues DocumentBuilder-Exemplar und liefert es zurück.

Exception: FactoryConfigurationException

• Falls die Erzeugung fehlschlägt.

public static DocumentBuilderFactory newInstance()

Erzeugt ein neues Fabrik-Objekt und liefert es zurück. Mit diesem Fabrik-Objekt können dann DocumentBuilder-Exemplare zum Parsen von Dokumenten erzeugt werden. Zur Ermittlung des Namens der zu verwendenen Fabrik-Klasse wird in folgender Reihenfolge vorgegangen:

• Auswertung der System-Property javax.xml.parsers.DocumentBuilderFactory
• Einlesen der Property-Datei jaxp.properties im Verzeichnis lib des JRE-Installationsverzeichnisses. In dieser Datei wird nach dem Wert der zuvor genannten Property gesucht.
• In den zur Laufzeit verfügbaren JAR-Archiven wird nach einem Klassennamen in der Datei META-INF/services/javax.xml.parsers.DocumentBuilderFactory gesucht.
• Es wird die Standard-Implementierung der Plattform verwendet.

Exception: FactoryConfigurationError

• Falls die spezifizierte Implementierung nicht gefunden wurde oder ein Fehler bei der Erzeugung des Parser auftritt.

public abstract void setAttribute(String name, Object value)

Setzt das durch name bezeichnete Attribut in der Implementierung auf den Wert value.

Exception: IllegalArgumentException

• Falls der übergebene Attributname nicht erkannt wird.

public void setCoalescing(boolean coalescing)

Stellt ein, ob die Implementierung Parser erzeugen soll, die benachbarte Zeichendaten zu einem Textknoten zusammenführen (true) oder nicht (false).

public void setExpandEntityReferences(boolean expandEntityRef)

Stellt ein, ob die Implementierung Parser erzeugen soll, die Entity-Referenzen auflösen (true) oder nicht (false).

public void setIgnoringComments(boolean ignoreComments)

Stellt ein, ob die Implementierung Parser erzeugen soll, die XML-Kommentare ignorieren (true) oder nicht (false).

public void setIgnoringElementContentWhitespace(boolean whitespace)

Stellt ein, ob die Implementierung Parser erzeugen soll, die Leerzeichen außerhalb von Zeichendaten ignorieren (true) oder nicht (false).

public void setNameSpaceAware(boolean awareness)

Stellt ein, ob die Implementierung Parser erzeugen soll, die Namensräume unterstützen (true) oder nicht (false).

public void setValidating(boolean validating)

Stellt ein, ob die Implementierung validierende Parser erzeugen soll (true) oder nicht (false).