org.xml.sax.helpers
Class XMLReaderFactory

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

public final class XMLReaderFactory
extends java.lang.Object

Factory for creating an XML reader.

This class contains static methods for creating an XML reader from an explicit class name, or for creating an XML reader based on the value of the org.xml.sax.driver system property:

 try {
   XMLReader myReader = XMLReaderFactory.createXMLReader();
 } catch (SAXException e) {
   System.err.println(e.getMessage());
 }
 

Note that these methods will not be usable in environments where system properties are not accessible or where the application or applet is not permitted to load classes dynamically.

SAX implementations may replace this class with a different one optimized for the environment, as long as its method signatures remain the same.

Since:
SAX 2.0
Version:
2.0
Author:
David Megginson, sax@megginson.com
See Also:
XMLReader

Method Summary
static XMLReader createXMLReader()
          Attempt to create an XML reader.
static XMLReader createXMLReader(java.lang.String className)
          Attempt to create an XML reader from a class name.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

createXMLReader

public static XMLReader createXMLReader()
                                 throws SAXException
Attempt to create an XML reader.

This implementation uses the value of the system property "org.xml.sax.driver" as the full name of a Java class and tries to instantiate that class as a SAX2 XMLReader.

If there is no such value, the GNU Ælred2 optionally validating parser is used if possible.

Note that many Java interpreters allow system properties to be specified on the command line.

Returns:
A new XMLReader.
Throws:
SAXException - If the value of the "org.xml.sax.driver" system property is null, or if the class cannot be loaded and instantiated.
See Also:
createXMLReader(java.lang.String)

createXMLReader

public static XMLReader createXMLReader(java.lang.String className)
                                 throws SAXException
Attempt to create an XML reader from a class name.

Given a class name, this method attempts to load and instantiate the class as an XML reader.

Returns:
A new XML reader.
Throws:
SAXException - If the class cannot be loaded, instantiated, and cast to XMLReader.
See Also:
createXMLReader()

Source code is GPL'd in the JAXP subproject at http://savannah.gnu.org/projects/classpathx
This documentation was derived from that source code on 2001-07-12.