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: