| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
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 {@link org.xml.sax.XMLReader XMLReader} and makes it act as a SAX1 {@link org.xml.sax.Parser Parser}. The XMLReader must support a true value for the http://xml.org/sax/features/namespace-prefixes property or parsing will fail with a {@link org.xml.sax.SAXException 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.
Constructor Summary | |
---|---|
Create a new adapter. |
|
XMLReaderAdapter(XMLReader xmlReader) Create a new adapter. |
Method Summary | |
---|---|
void |
characters(char[] ch, int start, int length) Adapt a SAX2 characters event. |
void |
End document event. |
void |
endElement(String uri, String localName, String qName) Adapt a SAX2 end element event. |
void |
endPrefixMapping(String prefix) Adapt a SAX2 end prefix mapping event. |
void |
ignorableWhitespace(char[] ch, int start, int length) Adapt a SAX2 ignorable whitespace event. |
void |
parse(InputSource input) Parse the document. |
void |
Parse the document. |
void |
processingInstruction(String target, String data) Adapt a SAX2 processing instruction event. |
void |
setDocumentHandler(DocumentHandler handler) Register the SAX1 document event handler. |
void |
setDocumentLocator(Locator locator) Set a document locator. |
void |
setDTDHandler(DTDHandler handler) Register the DTD event handler. |
void |
setEntityResolver(EntityResolver resolver) Register the entity resolver. |
void |
setErrorHandler(ErrorHandler handler) Register the error event handler. |
void |
Set the locale for error reporting. |
void |
skippedEntity(String name) Adapt a SAX2 skipped entity event. |
void |
Start document event. |
void |
startElement(String uri, String localName, String qName, Attributes atts) Adapt a SAX2 start element event. |
void |
startPrefixMapping(String prefix, String uri) Adapt a SAX2 start prefix mapping event. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public XMLReaderAdapter() throws SAXException
Use the "org.xml.sax.driver" property to locate the SAX2 driver to embed.
SAXException
- If the embedded driver
cannot be instantiated or if the
org.xml.sax.driver property is not specified.public XMLReaderAdapter(XMLReader xmlReader)
Create a new adapter, wrapped around a SAX2 XMLReader. The adapter will make the XMLReader act like a SAX1 Parser.
xmlReader
- The SAX2 XMLReader to wrap.Method Detail |
---|
public void characters(char[] ch, int start, int length) throws SAXException
ch
- An array of characters.start
- The starting position in the array.length
- The number of characters to use.SAXException
- The client may raise a
processing exception.public void endDocument() throws SAXException
SAXException
- The client may raise a
processing exception.public void endElement(String uri, String localName, String qName) throws SAXException
uri
- The Namespace URI.localName
- The Namespace local name.qName
- The qualified (prefixed) name.SAXException
- The client may raise a
processing exception.public void endPrefixMapping(String prefix)
prefix
- The prefix being mapped.public void ignorableWhitespace(char[] ch, int start, int length) throws SAXException
ch
- An array of characters.start
- The starting position in the array.length
- The number of characters to use.SAXException
- The client may raise a
processing exception.public void parse(InputSource input) throws IOException, SAXException
This method will throw an exception if the embedded XMLReader does not support the http://xml.org/sax/features/namespace-prefixes property.
input
- An input source for the document.IOException
- If there is a problem reading
the raw content of the document.SAXException
- If there is a problem
processing the document.public void parse(String systemId) throws IOException, SAXException
This method will throw an exception if the embedded XMLReader does not support the http://xml.org/sax/features/namespace-prefixes property.
systemId
- The absolute URL of the document.IOException
- If there is a problem reading
the raw content of the document.SAXException
- If there is a problem
processing the document.public void processingInstruction(String target, String data) throws SAXException
target
- The processing instruction target.data
- The remainder of the processing instructionSAXException
- The client may raise a
processing exception.public void setDocumentHandler(DocumentHandler handler)
Note that the SAX1 document handler has no Namespace support.
handler
- The new SAX1 document event handler.public void setDocumentLocator(Locator locator)
locator
- The document locator.public void setDTDHandler(DTDHandler handler)
handler
- The new DTD event handler.public void setEntityResolver(EntityResolver resolver)
resolver
- The new resolver.public void setErrorHandler(ErrorHandler handler)
handler
- The new error event handler.public void setLocale(Locale locale) throws SAXException
This is not supported in SAX2, and will always throw an exception.
locale
- the locale for error reporting.SAXException
- Thrown unless overridden.public void skippedEntity(String name) throws SAXException
name
- The name of the skipped entity.SAXException
- Throwable by subclasses.public void startDocument() throws SAXException
SAXException
- The client may raise a
processing exception.public void startElement(String uri, String localName, String qName, Attributes atts) throws SAXException
uri
- The Namespace URI.localName
- The Namespace local name.qName
- The qualified (prefixed) name.atts
- The SAX2 attributes.SAXException
- The client may raise a
processing exception.public void startPrefixMapping(String prefix, String uri)
prefix
- The prefix being mapped.uri
- The Namespace URI being mapped to.
| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |