ParserFactory

AI-generated Key Takeaways

• ParserFactory is a deprecated Java-specific class used for dynamically loading SAX parsers, designed to work with the now-deprecated SAX1 Parser class.

• SAX2 applications should use XMLReaderFactory instead of ParserFactory.

• ParserFactory provides two static methods: makeParser() to create a parser using the org.xml.sax.parser system property and makeParser(String className) to create a parser using a specified class name.

• Applications using ParserFactory still require an XML parser that implements SAX1.

public class ParserFactory extends Object

This class is deprecated.
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.

Public Method Summary

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 Method Summary

From class java.lang.Object

Object	clone() Creates and returns a copy of this Object.
boolean	equals(Object obj) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of Class that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait(long timeout, int nanos) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires.
final void	wait(long timeout) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires.
final void	wait() Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object.

Public Methods

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

• 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.

See Also

• makeParser(java.lang.String)
• Parser

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	A string containing the name of the SAX parser class.

Returns

• 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

• makeParser()
• Parser