Class ParserFactory
- java.lang.Object
-
- org.xml.sax.helpers.ParserFactory
@Deprecated(since="1.5") public class ParserFactory extends Object
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.
- Since:
- 1.4, SAX 1.0
Method Summary
Modifier and Type | Method | Description |
---|---|---|
static Parser | makeParser() | Deprecated. Create a new SAX parser using the `org.xml.sax.parser' system property. |
static Parser | makeParser(String className) | Deprecated. Create a new SAX parser object using the class name provided. |
Methods declared in class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Method Detail
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(java.lang.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