Added in API level 1

ParserAdapter

public class ParserAdapter
extends Object implements DocumentHandler, XMLReader

java.lang.Object
   ↳ org.xml.sax.helpers.ParserAdapter


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.

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(InputSource input)

Parse an XML document.

void parse(String systemId)

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.

Inherited methods

Object clone()

Creates and returns a copy of this object.

boolean equals(Object obj)

Indicates whether some other object is "equal to" this one.

void finalize()

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.

final Class<?> getClass()

Returns the runtime class of this Object.

int hashCode()

Returns a hash code value for the object.

final void notify()

Wakes up a single thread that is waiting on this object's monitor.

final void notifyAll()

Wakes up all threads that are waiting on this object's monitor.

String toString()

Returns a string representation of the object.

final void wait(long timeoutMillis, int nanos)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait(long timeoutMillis)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait()

Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

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

Receive notification of character data.

abstract void endDocument()

Receive notification of the end of a document.

abstract void endElement(String name)

Receive notification of the end of an element.

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

Receive notification of ignorable whitespace in element content.

abstract void processingInstruction(String target, String data)

Receive notification of a processing instruction.

abstract void setDocumentLocator(Locator locator)

Receive an object for locating the origin of SAX document events.

abstract void startDocument()

Receive notification of the beginning of a document.

abstract void startElement(String name, AttributeList atts)

Receive notification of the beginning of an element.

abstract ContentHandler getContentHandler()

Return the current content handler.

abstract DTDHandler getDTDHandler()

Return the current DTD handler.

abstract EntityResolver getEntityResolver()

Return the current entity resolver.

abstract ErrorHandler getErrorHandler()

Return the current error handler.

abstract boolean getFeature(String name)

Look up the value of a feature flag.

abstract Object getProperty(String name)

Look up the value of a property.

abstract void parse(InputSource input)

Parse an XML document.

abstract void parse(String systemId)

Parse an XML document from a system identifier (URI).

abstract void setContentHandler(ContentHandler handler)

Allow an application to register a content event handler.

abstract void setDTDHandler(DTDHandler handler)

Allow an application to register a DTD event handler.

abstract void setEntityResolver(EntityResolver resolver)

Allow an application to register an entity resolver.

abstract void setErrorHandler(ErrorHandler handler)

Allow an application to register an error event handler.

abstract void setFeature(String name, boolean value)

Set the value of a feature flag.

abstract void setProperty(String name, Object value)

Set the value of a property.

Public constructors

ParserAdapter

Added in API level 1
public ParserAdapter ()

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.

ParserAdapter

Added in API level 1
public ParserAdapter (Parser parser)

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 Parser: The SAX1 parser to embed.

Throws
NullPointerException If the parser parameter is null.

Public methods

characters

Added in API level 1
public void characters (char[] ch, 
                int start, 
                int length)

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

Parameters
ch char: An array of characters.

start int: The starting position in the array.

length int: The number of characters to use.

Throws
SAXException The client may raise a processing exception.

endDocument

Added in API level 1
public void endDocument ()

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

Throws
SAXException The client may raise a processing exception.

endElement

Added in API level 1
public void endElement (String qName)

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

Parameters
qName String: The qualified (prefixed) name.

Throws
SAXException The client may raise a processing exception.

getContentHandler

Added in API level 1
public ContentHandler getContentHandler ()

Return the current content handler.

Returns
ContentHandler The current content handler, or null if none was supplied.

getDTDHandler

Added in API level 1
public DTDHandler getDTDHandler ()

Return the current DTD handler.

Returns
DTDHandler the current DTD handler, or null if none was supplied

getEntityResolver

Added in API level 1
public EntityResolver getEntityResolver ()

Return the current entity resolver.

Returns
EntityResolver The current entity resolver, or null if none was supplied.

getErrorHandler

Added in API level 1
public ErrorHandler getErrorHandler ()

Return the current error handler.

Returns
ErrorHandler The current error handler, or null if none was supplied.

getFeature

Added in API level 1
public boolean getFeature (String name)

Check a parser feature flag.

The only features recognized are namespaces and namespace-prefixes.

Parameters
name String: The feature name, as a complete URI.

Returns
boolean The current feature value.

Throws
SAXNotRecognizedException If the feature value can't be assigned or retrieved.
SAXNotSupportedException If the feature is not currently readable.

getProperty

Added in API level 1
public Object getProperty (String name)

Get a parser property.

No properties are currently recognized.

Parameters
name String: The property name.

Returns
Object The property value.

Throws
SAXNotRecognizedException If the property value can't be assigned or retrieved.
SAXNotSupportedException If the property value is not currently readable.

ignorableWhitespace

Added in API level 1
public void ignorableWhitespace (char[] ch, 
                int start, 
                int length)

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

Parameters
ch char: An array of characters.

start int: The starting position in the array.

length int: The number of characters to use.

Throws
SAXException The client may raise a processing exception.

parse

Added in API level 1
public void parse (InputSource input)

Parse an XML document.

Parameters
input InputSource: 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.

parse

Added in API level 1
public void parse (String systemId)

Parse an XML document.

Parameters
systemId String: 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.

processingInstruction

Added in API level 1
public void processingInstruction (String target, 
                String data)

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

Parameters
target String: The processing instruction target.

data String: The remainder of the processing instruction

Throws
SAXException The client may raise a processing exception.

setContentHandler

Added in API level 1
public void setContentHandler (ContentHandler handler)

Set the content handler.

Parameters
handler ContentHandler: the new content handler

setDTDHandler

Added in API level 1
public void setDTDHandler (DTDHandler handler)

Set the DTD handler.

Parameters
handler DTDHandler: the new DTD handler

setDocumentLocator

Added in API level 1
public void setDocumentLocator (Locator locator)

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

Parameters
locator Locator: A document locator.

setEntityResolver

Added in API level 1
public void setEntityResolver (EntityResolver resolver)

Set the entity resolver.

Parameters
resolver EntityResolver: The new entity resolver.

setErrorHandler

Added in API level 1
public void setErrorHandler (ErrorHandler handler)

Set the error handler.

Parameters
handler ErrorHandler: The new error handler.

setFeature

Added in API level 1
public void setFeature (String name, 
                boolean value)

Set a feature flag for the parser.

The only features recognized are namespaces and namespace-prefixes.

Parameters
name String: The feature name, as a complete URI.

value boolean: 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.

setProperty

Added in API level 1
public void setProperty (String name, 
                Object value)

Set a parser property.

No properties are currently recognized.

Parameters
name String: The property name.

value Object: 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.

startDocument

Added in API level 1
public void startDocument ()

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

Throws
SAXException The client may raise a processing exception.

startElement

Added in API level 1
public void startElement (String qName, 
                AttributeList qAtts)

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

If necessary, perform Namespace processing.

Parameters
qName String: The qualified (prefixed) name.

qAtts AttributeList: The XML attribute list (with qnames).

Throws
SAXException The client may raise a processing exception.