Class ParserFactory

java.lang.Object
org.xml.sax.helpers.ParserFactory

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

Since:
SAX 1.0
Version:
2.0.1 (sax2r2)
Author:
David Megginson
  • Method Summary

    Modifier and Type
    Method
    Description
    static Parser
    Deprecated.
    Create a new SAX parser using the `org.xml.sax.parser' system property.
    static Parser
    makeParser(java.lang.String className)
    Deprecated.
    Create a new SAX parser object using the class name provided.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Method Details

    • makeParser

      public static Parser makeParser() throws java.lang.ClassNotFoundException, java.lang.IllegalAccessException, java.lang.InstantiationException, java.lang.NullPointerException, java.lang.ClassCastException
      Deprecated.
      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:
      java.lang.NullPointerException - There is no value for the `org.xml.sax.parser' system property.
      java.lang.ClassNotFoundException - The SAX parser class was not found (check your CLASSPATH).
      java.lang.IllegalAccessException - The SAX parser class was found, but you do not have permission to load it.
      java.lang.InstantiationException - The SAX parser class was found but could not be instantiated.
      java.lang.ClassCastException - The SAX parser class was found and instantiated, but does not implement org.xml.sax.Parser.
      See Also:
    • makeParser

      public static Parser makeParser(java.lang.String className) throws java.lang.ClassNotFoundException, java.lang.IllegalAccessException, java.lang.InstantiationException, java.lang.ClassCastException
      Deprecated.
      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:
      java.lang.ClassNotFoundException - The SAX parser class was not found (check your CLASSPATH).
      java.lang.IllegalAccessException - The SAX parser class was found, but you do not have permission to load it.
      java.lang.InstantiationException - The SAX parser class was found but could not be instantiated.
      java.lang.ClassCastException - The SAX parser class was found and instantiated, but does not implement org.xml.sax.Parser.
      See Also: