public class

ParserAdapter

extends Object
implements DocumentHandler XMLReader
java.lang.Object
   ↳ org.xml.sax.helpers.ParserAdapter

Class Overview

Adapt a SAX1 Parser as a SAX2 XMLReader.

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.

See Also

Summary

Public Constructors
ParserAdapter()
Construct a new parser adapter.
ParserAdapter(Parser parser)
Construct a new parser adapter.
Public Methods
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 setDTDHandler(DTDHandler handler)
Set the DTD handler.
void setDocumentLocator(Locator locator)
Adapter implementation method; do not call.
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.
[Expand]
Inherited Methods
From class java.lang.Object
From interface org.xml.sax.DocumentHandler
From interface org.xml.sax.XMLReader

Public Constructors

public ParserAdapter ()

Since: API Level 1

Construct a new parser adapter.

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.

public ParserAdapter (Parser parser)

Since: API Level 1

Construct a new parser adapter.

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
NullPointerException If the parser parameter is null.

Public Methods

public void characters (char[] ch, int start, int length)

Since: API Level 1

Adapter implementation method; do not call. Adapt a SAX1 characters event.

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

public void endDocument ()

Since: API Level 1

Adapter implementation method; do not call. Adapt a SAX1 end document event.

Throws
SAXException The client may raise a processing exception.
See Also

public void endElement (String qName)

Since: API Level 1

Adapter implementation method; do not call. Adapt a SAX1 end element event.

Parameters
qName The qualified (prefixed) name.
Throws
SAXException The client may raise a processing exception.
See Also

public ContentHandler getContentHandler ()

Since: API Level 1

Return the current content handler.

Returns
  • The current content handler, or null if none was supplied.
See Also

public DTDHandler getDTDHandler ()

Since: API Level 1

Return the current DTD handler.

Returns
  • the current DTD handler, or null if none was supplied
See Also

public EntityResolver getEntityResolver ()

Since: API Level 1

Return the current entity resolver.

Returns
  • The current entity resolver, or null if none was supplied.
See Also

public ErrorHandler getErrorHandler ()

Since: API Level 1

Return the current error handler.

Returns
  • The current error handler, or null if none was supplied.
See Also

public boolean getFeature (String name)

Since: API Level 1

Check a parser feature flag.

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

public Object getProperty (String name)

Since: API Level 1

Get a parser property.

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

public void ignorableWhitespace (char[] ch, int start, int length)

Since: API Level 1

Adapter implementation method; do not call. Adapt a SAX1 ignorable whitespace event.

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

public void parse (String systemId)

Since: API Level 1

Parse an XML document.

Parameters
systemId The absolute URL of the document.
Throws
IOException If there is a problem reading the raw content of the document.
SAXException If there is a problem processing the document.
See Also

public void parse (InputSource input)

Since: API Level 1

Parse an XML document.

Parameters
input An input source for the document.
Throws
IOException If there is a problem reading the raw content of the document.
SAXException If there is a problem processing the document.
See Also

public void processingInstruction (String target, String data)

Since: API Level 1

Adapter implementation method; do not call. Adapt a SAX1 processing instruction event.

Parameters
target The processing instruction target.
data The remainder of the processing instruction
Throws
SAXException The client may raise a processing exception.
See Also

public void setContentHandler (ContentHandler handler)

Since: API Level 1

Set the content handler.

Parameters
handler the new content handler
See Also

public void setDTDHandler (DTDHandler handler)

Since: API Level 1

Set the DTD handler.

Parameters
handler the new DTD handler
See Also

public void setDocumentLocator (Locator locator)

Since: API Level 1

Adapter implementation method; do not call. Adapt a SAX1 document locator event.

Parameters
locator A document locator.
See Also

public void setEntityResolver (EntityResolver resolver)

Since: API Level 1

Set the entity resolver.

Parameters
resolver The new entity resolver.
See Also

public void setErrorHandler (ErrorHandler handler)

Since: API Level 1

Set the error handler.

Parameters
handler The new error handler.
See Also

public void setFeature (String name, boolean value)

Since: API Level 1

Set a feature flag for the parser.

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

public void setProperty (String name, Object value)

Since: API Level 1

Set a parser property.

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

public void startDocument ()

Since: API Level 1

Adapter implementation method; do not call. Adapt a SAX1 start document event.

Throws
SAXException The client may raise a processing exception.
See Also

public void startElement (String qName, AttributeList qAtts)

Since: API Level 1

Adapter implementation method; do not call. Adapt a SAX1 startElement event.

If necessary, perform Namespace processing.

Parameters
qName The qualified (prefixed) name.
qAtts The XML attribute list (with qnames).
Throws
SAXException The client may raise a processing exception.