org.xml.sax.helpers
Class ParserFactory

java.lang.Object
  |
  +--org.xml.sax.helpers.ParserFactory

public class ParserFactory

extends Object

Java-specific class for dynamically loading SAX parsers.

This class 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 SAX.

See Also:

Parser, Class

Constructor Summary

ParserFactory()

Method Summary

static Parser	makeParser() Private null constructor.
static Parser	makeParser(String className) 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

Constructor Detail

ParserFactory

public ParserFactory()

Method Detail

makeParser

public static Parser makeParser()
                         throws ClassNotFoundException,
                                IllegalAccessException,
                                InstantiationException,
                                NullPointerException,
                                ClassCastException

Private null constructor. private ParserFactor () { } /** Create a new SAX parser using the `org.xml.sax.parser' system property.

The named class must exist and must implement the org.xml.sax.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 org.xml.sax.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