org.xml.sax.helpers
public class ParserAdapter extends Object implements XMLReader, DocumentHandler
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 wraps a SAX1 {@link org.xml.sax.Parser Parser} and makes it act as a SAX2 {@link org.xml.sax.XMLReader XMLReader}, with feature, property, and Namespace support. Note that it is not possible to report {@link org.xml.sax.ContentHandler#skippedEntity skippedEntity} events, since SAX1 does not make that information available.
This adapter does not test for duplicate Namespace-qualified attribute names.
Note that this is not the class shipped with SAX 2.0.1; this class takes into account the presence of AccessControllers in J2EE 1.4.
Since: SAX 2.0
Version: 2.0.1 (sax2r2)
See Also: XMLReaderAdapter XMLReader Parser
Constructor Summary | |
---|---|
ParserAdapter()
Construct a new parser adapter.
| |
ParserAdapter(Parser parser)
Construct a new parser adapter.
|
Method Summary | |
---|---|
void | characters(char[] ch, int start, int length)
Adapter implementation method; do not call.
|
void | endDocument()
Adapter implementation method; do not call.
|
void | endElement(String qName)
Adapter implementation method; do not call.
|
ContentHandler | getContentHandler()
Return the current content handler.
|
DTDHandler | getDTDHandler()
Return the current DTD handler.
|
EntityResolver | getEntityResolver()
Return the current entity resolver.
|
ErrorHandler | getErrorHandler()
Return the current error handler.
|
boolean | getFeature(String name)
Check a parser feature flag.
|
Object | getProperty(String name)
Get a parser property.
|
void | ignorableWhitespace(char[] ch, int start, int length)
Adapter implementation method; do not call.
|
void | parse(String systemId)
Parse an XML document.
|
void | parse(InputSource input)
Parse an XML document.
|
void | processingInstruction(String target, String data)
Adapter implementation method; do not call.
|
void | setContentHandler(ContentHandler handler)
Set the content handler.
|
void | setDocumentLocator(Locator locator)
Adapter implementation method; do not call.
|
void | setDTDHandler(DTDHandler handler)
Set the DTD handler.
|
void | setEntityResolver(EntityResolver resolver)
Set the entity resolver.
|
void | setErrorHandler(ErrorHandler handler)
Set the error handler.
|
void | setFeature(String name, boolean value)
Set a feature flag for the parser.
|
void | setProperty(String name, Object value)
Set a parser property.
|
void | startDocument()
Adapter implementation method; do not call.
|
void | startElement(String qName, AttributeList qAtts)
Adapter implementation method; do not call.
|
Use the "org.xml.sax.parser" property to locate the embedded SAX1 driver.
Throws: SAXException If the embedded driver cannot be instantiated or if the org.xml.sax.parser property is not specified.
Note that the embedded parser cannot be changed once the adapter is created; to embed a different parser, allocate a new ParserAdapter.
Parameters: parser The SAX1 parser to embed.
Throws: java.lang.NullPointerException If the parser parameter is null.
Parameters: ch An array of characters. start The starting position in the array. length The number of characters to use.
Throws: SAXException The client may raise a processing exception.
See Also: DocumentHandler
Throws: SAXException The client may raise a processing exception.
See Also: DocumentHandler
Parameters: qName The qualified (prefixed) name.
Throws: SAXException The client may raise a processing exception.
See Also: DocumentHandler
Returns: The current content handler, or null if none was supplied.
See Also: XMLReader
Returns: The current DTD handler, or null if none was supplied.
See Also: XMLReader
Returns: The current entity resolver, or null if none was supplied.
See Also: XMLReader
Returns: The current error handler, or null if none was supplied.
See Also: XMLReader
The only features recognized are namespaces and namespace-prefixes.
Parameters: name The feature name, as a complete URI.
Returns: The current feature value.
Throws: SAXNotRecognizedException If the feature value can't be assigned or retrieved. SAXNotSupportedException If the feature is not currently readable.
See Also: XMLReader
No properties are currently recognized.
Parameters: name The property name.
Returns: The property value.
Throws: SAXNotRecognizedException If the property value can't be assigned or retrieved. SAXNotSupportedException If the property value is not currently readable.
See Also: XMLReader
Parameters: ch An array of characters. start The starting position in the array. length The number of characters to use.
Throws: SAXException The client may raise a processing exception.
See Also: DocumentHandler
Parameters: systemId The absolute URL of the document.
Throws: java.io.IOException If there is a problem reading the raw content of the document. SAXException If there is a problem processing the document.
Parameters: input An input source for the document.
Throws: java.io.IOException If there is a problem reading the raw content of the document. SAXException If there is a problem processing the document.
See Also: ParserAdapter parse
Parameters: target The processing instruction target. data The remainder of the processing instruction
Throws: SAXException The client may raise a processing exception.
See Also: DocumentHandler
Parameters: resolver The new content handler.
See Also: XMLReader
Parameters: locator A document locator.
See Also: ContentHandler
Parameters: resolver The new DTD handler.
See Also: XMLReader
Parameters: resolver The new entity resolver.
See Also: XMLReader
Parameters: resolver The new error handler.
See Also: XMLReader
The only features recognized are namespaces and namespace-prefixes.
Parameters: name The feature name, as a complete URI. value The requested feature value.
Throws: SAXNotRecognizedException If the feature can't be assigned or retrieved. SAXNotSupportedException If the feature can't be assigned that value.
See Also: XMLReader
No properties are currently recognized.
Parameters: name The property name. value The property value.
Throws: SAXNotRecognizedException If the property value can't be assigned or retrieved. SAXNotSupportedException If the property can't be assigned that value.
See Also: XMLReader
Throws: SAXException The client may raise a processing exception.
See Also: DocumentHandler
If necessary, perform Namespace processing.
Parameters: qName The qualified (prefixed) name. qAtts The XML 1.0 attribute list (with qnames).
Throws: SAXException The client may raise a processing exception.