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 Parser
and makes it act as a SAX2 XMLReader
,
with feature, property, and Namespace support. Note
that it is not possible to report skippedEntity
events, since SAX1 does not make that information available.
This adapter does not test for duplicate Namespace-qualified attribute names.
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.