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 | |
|---|---|
Public methods
makeParser
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. |
See also:
makeParser
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: