class:XMLReaderAdapter [NONE]

All Implemented Interfaces:

ContentHandler, Parser
```
public class XMLReaderAdapter
extends Object
implements Parser, ContentHandler
```
Adapt a SAX2 XMLReader as a SAX1 Parser.
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 SAX2 XMLReader and makes it act as a SAX1 Parser. The XMLReader must support a true value for the http://xml.org/sax/features/namespace-prefixes property or parsing will fail with a SAXException; if the XMLReader supports a false value for the http://xml.org/sax/features/namespaces property, that will also be used to improve efficiency.

Since:

1.4, SAX 2.0

See Also:

Parser, XMLReader

constructor:<init>() [NONE]

XMLReaderAdapter
```
public XMLReaderAdapter()
                 throws SAXException
```
Create a new adapter.
Use the "org.xml.sax.driver" property to locate the SAX2 driver to embed.

Throws:

SAXException - If the embedded driver cannot be instantiated or if the org.xml.sax.driver property is not specified.

constructor:<init>(org.xml.sax.XMLReader) [NONE]

XMLReaderAdapter
```
public XMLReaderAdapter(XMLReader xmlReader)
```
Create a new adapter.
Create a new adapter, wrapped around a SAX2 XMLReader. The adapter will make the XMLReader act like a SAX1 Parser.

Parameters:

xmlReader - The SAX2 XMLReader to wrap.

Throws:

NullPointerException - If the argument is null.

method:setLocale(java.util.Locale) [NONE]

setLocale
```
public void setLocale(Locale locale)
               throws SAXException
```
Set the locale for error reporting.
This is not supported in SAX2, and will always throw an exception.

Specified by:

setLocale in interface Parser

Parameters:

locale - the locale for error reporting.

Throws:

SAXException - Thrown unless overridden.

See Also:

Parser.setLocale(java.util.Locale)

method:setEntityResolver(org.xml.sax.EntityResolver) [NONE]

setEntityResolver
```
public void setEntityResolver(EntityResolver resolver)
```
Register the entity resolver.

Specified by:

setEntityResolver in interface Parser

Parameters:

resolver - The new resolver.

See Also:

Parser.setEntityResolver(org.xml.sax.EntityResolver)

method:setDTDHandler(org.xml.sax.DTDHandler) [NONE]

setDTDHandler
```
public void setDTDHandler(DTDHandler handler)
```
Register the DTD event handler.

Specified by:

setDTDHandler in interface Parser

Parameters:

handler - The new DTD event handler.

See Also:

Parser.setDTDHandler(org.xml.sax.DTDHandler)

method:setDocumentHandler(org.xml.sax.DocumentHandler) [NONE]

setDocumentHandler
```
public void setDocumentHandler(DocumentHandler handler)
```
Register the SAX1 document event handler.
Note that the SAX1 document handler has no Namespace support.

Specified by:

setDocumentHandler in interface Parser

Parameters:

handler - The new SAX1 document event handler.

See Also:

Parser.setDocumentHandler(org.xml.sax.DocumentHandler)

method:setErrorHandler(org.xml.sax.ErrorHandler) [NONE]

setErrorHandler
```
public void setErrorHandler(ErrorHandler handler)
```
Register the error event handler.

Specified by:

setErrorHandler in interface Parser

Parameters:

handler - The new error event handler.

See Also:

Parser.setErrorHandler(org.xml.sax.ErrorHandler)

method:parse(java.lang.String) [NONE]

parse
```
public void parse(String systemId)
           throws IOException,
                  SAXException
```
Parse the document.
This method will throw an exception if the embedded XMLReader does not support the http://xml.org/sax/features/namespace-prefixes property.

Specified by:

parse in interface Parser

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:

parse(org.xml.sax.InputSource), Parser.parse(java.lang.String)

method:parse(org.xml.sax.InputSource) [NONE]

parse
```
public void parse(InputSource input)
           throws IOException,
                  SAXException
```
Parse the document.
This method will throw an exception if the embedded XMLReader does not support the http://xml.org/sax/features/namespace-prefixes property.

Specified by:

parse in interface Parser

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:

parse(java.lang.String), Parser.parse(org.xml.sax.InputSource)

method:setDocumentLocator(org.xml.sax.Locator) [NONE]

setDocumentLocator
```
public void setDocumentLocator(Locator locator)
```
Set a document locator.

Specified by:

setDocumentLocator in interface ContentHandler

Parameters:

locator - The document locator.

See Also:

ContentHandler.setDocumentLocator(org.xml.sax.Locator)

method:startDocument() [NONE]

startDocument
```
public void startDocument()
                   throws SAXException
```
Start document event.

Specified by:

startDocument in interface ContentHandler

Throws:

SAXException - The client may raise a processing exception.

See Also:

ContentHandler.startDocument()

method:endDocument() [NONE]

endDocument
```
public void endDocument()
                 throws SAXException
```
End document event.

Specified by:

endDocument in interface ContentHandler

Throws:

SAXException - The client may raise a processing exception.

See Also:

ContentHandler.endDocument()

method:startPrefixMapping(java.lang.String,java.lang.String) [NONE]

startPrefixMapping
```
public void startPrefixMapping(String prefix,
                               String uri)
```
Adapt a SAX2 start prefix mapping event.

Specified by:

startPrefixMapping in interface ContentHandler

Parameters:

prefix - The prefix being mapped.

uri - The Namespace URI being mapped to.

See Also:

ContentHandler.startPrefixMapping(java.lang.String, java.lang.String)

method:endPrefixMapping(java.lang.String) [NONE]

endPrefixMapping
```
public void endPrefixMapping(String prefix)
```
Adapt a SAX2 end prefix mapping event.

Specified by:

endPrefixMapping in interface ContentHandler

Parameters:

prefix - The prefix being mapped.

See Also:

ContentHandler.endPrefixMapping(java.lang.String)

method:startElement(java.lang.String,java.lang.String,java.lang.String,org.xml.sax.Attributes) [NONE]

startElement
```
public void startElement(String uri,
                         String localName,
                         String qName,
                         Attributes atts)
                  throws SAXException
```
Adapt a SAX2 start element event.

Specified by:

startElement in interface ContentHandler

Parameters:

uri - The Namespace URI.

localName - The Namespace local name.

qName - The qualified (prefixed) name.

atts - The SAX2 attributes.

Throws:

SAXException - The client may raise a processing exception.

See Also:

ContentHandler.endDocument()

method:endElement(java.lang.String,java.lang.String,java.lang.String) [NONE]

endElement
```
public void endElement(String uri,
                       String localName,
                       String qName)
                throws SAXException
```
Adapt a SAX2 end element event.

Specified by:

endElement in interface ContentHandler

Parameters:

uri - The Namespace URI.

localName - The Namespace local name.

qName - The qualified (prefixed) name.

Throws:

SAXException - The client may raise a processing exception.

See Also:

ContentHandler.endElement(java.lang.String, java.lang.String, java.lang.String)

method:characters(char[],int,int) [NONE]

characters
```
public void characters(char[] ch,
                       int start,
                       int length)
                throws SAXException
```
Adapt a SAX2 characters event.

Specified by:

characters in interface ContentHandler

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:

ContentHandler.characters(char[], int, int)

method:ignorableWhitespace(char[],int,int) [NONE]

ignorableWhitespace
```
public void ignorableWhitespace(char[] ch,
                                int start,
                                int length)
                         throws SAXException
```
Adapt a SAX2 ignorable whitespace event.

Specified by:

ignorableWhitespace in interface ContentHandler

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:

ContentHandler.ignorableWhitespace(char[], int, int)

method:processingInstruction(java.lang.String,java.lang.String) [NONE]

processingInstruction
```
public void processingInstruction(String target,
                                  String data)
                           throws SAXException
```
Adapt a SAX2 processing instruction event.

Specified by:

processingInstruction in interface ContentHandler

Parameters:

target - The processing instruction target.

data - The remainder of the processing instruction

Throws:

SAXException - The client may raise a processing exception.

See Also:

ContentHandler.processingInstruction(java.lang.String, java.lang.String)

method:skippedEntity(java.lang.String) [NONE]

skippedEntity
```
public void skippedEntity(String name)
                   throws SAXException
```
Adapt a SAX2 skipped entity event.

Specified by:

skippedEntity in interface ContentHandler

Parameters:

name - The name of the skipped entity.

Throws:

SAXException - Throwable by subclasses.

See Also:

ContentHandler.skippedEntity(java.lang.String)