ParserFactory (Java SE 17 & JDK 17)
Description: declaration: module: java.xml, package: org.xml.sax.helpers, class: ParserFactory
Keywords: org.xml.sax.helpers.ParserFactory class

Module java.xml
Package org.xml.sax.helpers

# Class ParserFactory

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

@Deprecated(since="1.5") public class ParserFactory extends Object
Deprecated.
This class works with the deprecated `Parser` interface.
Java-specific class for dynamically loading SAX parsers.

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 Details

  - ### makeParser

    public static Parser makeParser() throws ClassNotFoundException, IllegalAccessException, InstantiationException, NullPointerException, 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.

    Returns:
      a new SAX 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(java.lang.String)`
      - `Parser`

  - ### makeParser

    public static Parser makeParser(String className) throws ClassNotFoundException, IllegalAccessException, InstantiationException, 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.
    Returns:
      a new SAX 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:
      - `makeParser()`
      - `Parser`