java.lang.Object | +--org.xml.sax.helpers.XMLReaderAdapterAll Implemented Interfaces:
org.xml.sax.Parser
org.xml.sax.XMLReader
XMLReaderAdapter()Create a new adapter. |
XMLReaderAdapter(org.xml.sax.XMLReader xmlReader)Create a new adapter. |
void | characters(char[] ch, int start, int length)Adapt a SAX2 characters event. |
void | endDocument()End document event. |
void | endElement(java.lang.String uri, java.lang.String localName, java.lang.String qName)Adapt a SAX2 end element event. |
void | endPrefixMapping(java.lang.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(java.lang.String systemId)Parse the document. |
void | parse(org.xml.sax.InputSource input)Parse the document. |
void | processingInstruction(java.lang.String target, java.lang.String data)Adapt a SAX2 processing instruction event. |
void | setDTDHandler(org.xml.sax.DTDHandler handler)Register the DTD event handler. |
void | setDocumentHandler(org.xml.sax.DocumentHandler handler)Register the SAX1 document event handler. |
void | setDocumentLocator(org.xml.sax.Locator locator)Set a document locator. |
void | setEntityResolver(org.xml.sax.EntityResolver resolver)Register the entity resolver. |
void | setErrorHandler(org.xml.sax.ErrorHandler handler)Register the error event handler. |
void | setLocale(java.util.Locale locale)Set the locale for error reporting. |
void | skippedEntity(java.lang.String name)Adapt a SAX2 skipped entity event. |
void | startDocument()Start document event. |
void | startElement(java.lang.String uri, java.lang.String localName, java.lang.String qName, org.xml.sax.Attributes atts)Adapt a SAX2 start element event. |
void | startPrefixMapping(java.lang.String prefix, java.lang.String uri)Adapt a SAX2 start prefix mapping event. |
public XMLReaderAdapter()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(org.xml.sax.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.NullPointerException - If the argument is null.public void characters(char[] ch, int start, int length)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()SAXException - The client may raise a
processing exception.public void endElement(java.lang.String uri, java.lang.String localName, java.lang.String qName)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(java.lang.String prefix)prefix - The prefix being mapped.public void ignorableWhitespace(char[] ch, int start, int length)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(java.lang.String systemId)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 parse(org.xml.sax.InputSource input)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 processingInstruction(java.lang.String target, java.lang.String data)target - The processing instruction target.data - The remainder of the processing instructionSAXException - The client may raise a
processing exception.public void setDTDHandler(org.xml.sax.DTDHandler handler)handler - The new DTD event handler.public void setDocumentHandler(org.xml.sax.DocumentHandler handler)Note that the SAX1 document handler has no Namespace support.
handler - The new SAX1 document event handler.public void setDocumentLocator(org.xml.sax.Locator locator)locator - The document locator.public void setEntityResolver(org.xml.sax.EntityResolver resolver)resolver - The new resolver.public void setErrorHandler(org.xml.sax.ErrorHandler handler)handler - The new error event handler.public void setLocale(java.util.Locale locale)This is not supported in SAX2, and will always throw an exception.
locale - locale for error reporting.SAXException - Thrown unless overridden.public void skippedEntity(java.lang.String name)name - The name of the skipped entity.SAXException - Throwable by subclasses.public void startDocument()SAXException - The client may raise a
processing exception.public void startElement(java.lang.String uri, java.lang.String localName, java.lang.String qName, org.xml.sax.Attributes atts)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(java.lang.String prefix, java.lang.String uri)prefix - The prefix being mapped.uri - The Namespace URI being mapped to.
This class wraps a SAX2 org.xml.sax.XMLReader XMLReader and makes it act as a SAX1 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 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.