Package org.xml.sax.helpers

Class 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

      All Methods Static Methods Concrete Methods Deprecated Methods 
      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​(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 Detail

      • 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(java.lang.String), Parser

      • 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:
        makeParser(), Parser