public final class XMLReaderFactory extends Object
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.
This class contains static methods for creating an XML reader from an explicit class name, or based on runtime defaults:
try {
XMLReader myReader = XMLReaderFactory.createXMLReader();
} catch (SAXException e) {
System.err.println(e.getMessage());
}
Note to Distributions bundled with parsers:
You should modify the implementation of the no-arguments
createXMLReader to handle cases where the external
configuration mechanisms aren't set up. That method should do its
best to return a parser when one is in the class path, even when
nothing bound its class name to org.xml.sax.driver so
those configuration mechanisms would see it.
| Modifier and Type | Method and Description |
|---|---|
static XMLReader |
createXMLReader()
Attempt to create an XMLReader from system defaults.
|
static XMLReader |
createXMLReader(String className)
Attempt to create an XML reader from a class name.
|
public static XMLReader createXMLReader() throws SAXException
org.xml.sax.driver
has a value, that is used as an XMLReader class name. ParserFactory.makeParser() can
return a system default SAX1 parser, that parser is wrapped in
a ParserAdapter. (This is a migration aid for SAX1
environments, where the org.xml.sax.parser system
property will often be usable.) In environments such as small embedded systems, which can not support that flexibility, other mechanisms to determine the default may be used.
Note that many Java environments allow system properties to be initialized on a command line. This means that in most cases setting a good value for that property ensures that calls to this method will succeed, except when security policies intervene. This will also maximize application portability to older SAX environments, with less robust implementations of this method.
SAXException - If no default XMLReader class
can be identified and instantiated.createXMLReader(java.lang.String)public static XMLReader createXMLReader(String className) throws SAXException
Given a class name, this method attempts to load and instantiate the class as an XML reader.
Note that this method will not be usable in environments where the caller (perhaps an applet) is not permitted to load classes dynamically.
SAXException - If the class cannot be
loaded, instantiated, and cast to XMLReader.createXMLReader() Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2011, Oracle and/or its affiliates. All rights reserved.
DRAFT ea-b138