Top Description Constructors Methods
org.xml.sax.helpers

public Class ParserFactory

extends Object
Class Inheritance
Annotations
@SuppressWarnings:deprecation
@Deprecated
since:1.5
Imports
jdk.xml.internal.SecuritySupport

Deprecated

since 1.5.

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.

Author
David Megginson
Since
1.4, SAX 1.0
Version
2.0.1 (sax2r2)

Constructor Summary

AccessConstructor and Description
private
ParserFactory()

Private null constructor.

Method Summary

Modifier and TypeMethod and Description
public static Parser

Returns:

a new SAX parser
makeParser()

Deprecated as a consequence of Parser being deprecated.
Create a new SAX parser using the `org.xml.sax.parser' system property.
public static Parser

Returns:

a new SAX parser
makeParser(String
A string containing the name of the SAX parser class.
className)

Deprecated as a consequence of Parser being deprecated.
Create a new SAX parser object using the class name provided.
Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Constructor Detail

ParserFactoryback to summary
private ParserFactory()

Private null constructor.

Method Detail

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

Deprecated

as a consequence of Parser being deprecated. See corresponding docs for further information.

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:Parser

a new SAX parser

Exceptions
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.
NullPointerException:
There is no value for the `org.xml.sax.parser' system property.
ClassCastException:
The SAX parser class was found and instantiated, but does not implement org.xml.sax.Parser.
See Also
makeParser(java.lang.String), org.xml.sax.Parser
makeParserback to summary
public static Parser makeParser(String className) throws ClassNotFoundException, IllegalAccessException, InstantiationException, ClassCastException

Deprecated

as a consequence of Parser being deprecated. See corresponding docs for further information.

Create a new SAX parser object using the class name provided.

The named class must exist and must implement the Parser interface.

Parameters
className:String

A string containing the name of the SAX parser class.

Returns:Parser

a new SAX parser

Exceptions
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(), org.xml.sax.Parser