FileDocCategorySizeDatePackage
ParserFactory.javaAPI DocAndroid 1.5 API4635Wed May 06 22:41:06 BST 2009org.xml.sax.helpers

ParserFactory

public class ParserFactory extends Object
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 {@link org.xml.sax.Parser Parser} class. SAX2 applications should use {@link org.xml.sax.helpers.XMLReaderFactory 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.

deprecated
This class works with the deprecated {@link org.xml.sax.Parser Parser} interface.
since
SAX 1.0
author
David Megginson
version
2.0.1 (sax2r2)

Fields Summary
Constructors Summary
private ParserFactory()
Private null constructor.
Methods Summary
public static org.xml.sax.ParsermakeParser()
Create a new SAX parser using the `org.xml.sax.parser' system property.

The named class must exist and must implement the {@link org.xml.sax.Parser Parser} interface.

return
the newly created parser.
exception
java.lang.NullPointerException There is no value for the `org.xml.sax.parser' system property.
exception
java.lang.ClassNotFoundException The SAX parser class was not found (check your CLASSPATH).
exception
IllegalAccessException The SAX parser class was found, but you do not have permission to load it.
exception
InstantiationException The SAX parser class was found but could not be instantiated.
exception
java.lang.ClassCastException The SAX parser class was found and instantiated, but does not implement org.xml.sax.Parser.
see
#makeParser(java.lang.String)
see
org.xml.sax.Parser

    String className = System.getProperty("org.xml.sax.parser");
    if (className == null) {
        throw new NullPointerException("No value for sax.parser property");
    } else {
        return makeParser(className);
    }
public static org.xml.sax.ParsermakeParser(java.lang.String className)
Create a new SAX parser object using the class name provided.

The named class must exist and must implement the {@link org.xml.sax.Parser Parser} interface.

return
the newly created parser.
param
className A string containing the name of the SAX parser class.
exception
java.lang.ClassNotFoundException The SAX parser class was not found (check your CLASSPATH).
exception
IllegalAccessException The SAX parser class was found, but you do not have permission to load it.
exception
InstantiationException The SAX parser class was found but could not be instantiated.
exception
java.lang.ClassCastException The SAX parser class was found and instantiated, but does not implement org.xml.sax.Parser.
see
#makeParser()
see
org.xml.sax.Parser

    return (Parser) NewInstance.newInstance (
        NewInstance.getClassLoader (), className);