Added in API level 1
Deprecated in API level 9

ParserFactory

public class ParserFactory
extends Object

java.lang.Object
   ↳ org.xml.sax.helpers.ParserFactory


This class was deprecated in API level 9.
This class works with the deprecated Parser interface.

Java-specific class for dynamically loading SAX parsers.

This module, both source code and documentation, is in the Public Domain, and comes with NO WARRANTY. See http://www.saxproject.org for further information.

Note: This class is designed to work with the now-deprecated SAX1 Parser class. SAX2 applications should use XMLReaderFactory instead.

ParserFactory is not part of the platform-independent definition of SAX; it is an additional convenience class designed specifically for Java XML application writers. SAX applications can use the static methods in this class to allocate a SAX parser dynamically at run-time based either on the value of the `org.xml.sax.parser' system property or on a string containing the class name.

Note that the application still requires an XML parser that implements SAX1.

Summary

Public methods

static Parser makeParser()

Create a new SAX parser using the `org.xml.sax.parser' system property.

static Parser makeParser(String className)

Create a new SAX parser object using the class name provided.

Inherited methods

Object clone()

Creates and returns a copy of this object.

boolean equals(Object obj)

Indicates whether some other object is "equal to" this one.

void finalize()

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.

final Class<?> getClass()

Returns the runtime class of this Object.

int hashCode()

Returns a hash code value for the object.

final void notify()

Wakes up a single thread that is waiting on this object's monitor.

final void notifyAll()

Wakes up all threads that are waiting on this object's monitor.

String toString()

Returns a string representation of the object.

final void wait(long timeoutMillis, int nanos)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait(long timeoutMillis)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait()

Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Public methods

makeParser

Added in API level 1
public static Parser makeParser ()

Create a new SAX parser using the `org.xml.sax.parser' system property.

The named class must exist and must implement the Parser interface.

Returns
Parser the newly created parser.

Throws
NullPointerException There is no value for the `org.xml.sax.parser' system property.
ClassNotFoundException The SAX parser class was not found (check your CLASSPATH).
IllegalAccessException The SAX parser class was found, but you do not have permission to load it.
InstantiationException The SAX parser class was found but could not be instantiated.
ClassCastException The SAX parser class was found and instantiated, but does not implement org.xml.sax.Parser.

makeParser

Added in API level 1
public static Parser makeParser (String className)

Create a new SAX parser object using the class name provided.

The named class must exist and must implement the Parser interface.

Parameters
className String: A string containing the name of the SAX parser class.

Returns
Parser the newly created parser.

Throws
ClassNotFoundException The SAX parser class was not found (check your CLASSPATH).
IllegalAccessException The SAX parser class was found, but you do not have permission to load it.
InstantiationException The SAX parser class was found but could not be instantiated.
ClassCastException The SAX parser class was found and instantiated, but does not implement org.xml.sax.Parser.

See also: