Referenz: javax.xml.parsers.SAXParserFactory

Weitere aktuelle Java-Titel finden Sie bei dpunkt.

Klasse javax.xml.parsers.SAXParserFactory

JAXP 1.0

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

Deklaration

public abstract class SAXParserFactory extends java.lang.Object

Beschreibung

Diese Klasse dient zur Erzeugung von SAXParser-Exemplaren, mit denen XML-Dokumente geparst und mit der SAX-API verarbeitet werden können. Exemplare von SAXParserFactory werden nicht direkt, sondern mit der Methode newInstance() erzeugt.

Konstruktoren
protected	SAXParserFactory()

Methoden
public boolean	getFeature(String feature)
public boolean	isNameSpaceAware()
public abstract boolean	isValidating()
public static SAXParserFactory	newInstance()
public abstract SAXParser	newSAXParser()
public void	setFeature(String feature, boolean value)
public void	setNameSpaceAware(boolean awareness)
public void	setValidating(boolean validating)

Konstruktoren im Detail

protected SAXParserFactory()
Ein geschützter Konstruktor.

Methoden im Detail

public boolean getFeature(String feature)

Liefert true, falls die verwendete Implementierung die durch feature Funktion unterstützt, sonst false.

Exception: ParserConfigurationException

Exception: SAXNotRecognizedException

Falls d angegebenen Funktionsnamen nicht erkannt wird.

Exception: SAXNotSupportedException

Falls der Funktionsname erkannt wird, aber die Funktion nicht unterstützt wird.

Exception: ParserConfigurationException

public boolean isNameSpaceAware()
Liefert true, falls die Implementierung Parser erzeugt, die Namensräume unterstützen, sonst false.

public abstract boolean isValidating()
Liefert true, falls die Implementierung validierende Parser erzeugt, sonst false.

public static SAXParserFactory newInstance()

Erzeugt ein neues Fabrik-Objekt und liefert es zurück. Mit diesem Fabrik-Objekt können dann SAXParser-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.SAXParserFactory 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.SAXParserFactory 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 SAXParser newSAXParser()

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

Exception: FactoryConfigurationException

Falls die Erzeugung fehlschlägt.

Exception: SAXException

Wenn bei der Verarbeitung ein Fehler auftritt.

public void setFeature(String feature, boolean value)

Aktiviert oder deaktiviert die durch feature bezeichnete Funktion des Parsers in Abhängigkeit von value.

Exception: FactoryConfigurationException

Exception: SAXNotRecognizedException

Falls der angegebene Funktionsname nicht erkannt wird.

Exception: SAXNotSupportedException

Falls der Funktionsname erkannt wird, aber die Funktion nicht unterstützt wird.

public void setNameSpaceAware(boolean awareness)
Stellt ein, ob die Implementierung Parser erzeugen soll, die Namensräume unterstützen (true) oder nicht (false). Der Standardwert ist false.

public void setValidating(boolean validating)
Stellt ein, ob die Implementierung validierende Parser erzeugen soll (true) oder nicht (false). Der Standardwert ist false.