Overview Package Class Use Source Tree Index Deprecated About
Prev Class | Next ClassFrames | No Frames
Summary: Nested | Field | Method | ConstrDetail: Nested | Field | Method | Constr

org.xml.sax.helpers

Class ParserFactory

public class ParserFactory
extends Object
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.

Since:
SAX 1.0

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.

Methods inherited from class java.lang.Object

clone, equals, extends Object> getClass, finalize, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

makeParser

public static Parser makeParser()
            throws ClassNotFoundException,
                   IllegalAccessException,
                   InstantiationException,
                   NullPointerException,
                   ClassCastException
Create a new SAX parser using the `org.xml.sax.parser' system property.

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

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(String), Parser

makeParser

public static Parser makeParser(String className)
            throws ClassNotFoundException,
                   IllegalAccessException,
                   InstantiationException,
                   ClassCastException
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.
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

Overview Package Class Use Source Tree Index Deprecated About