DocumentHandler
, XMLReader
public class ParserAdapter extends Object implements XMLReader, DocumentHandler
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.
Constructor | Description |
---|---|
ParserAdapter() |
Construct a new parser adapter. |
ParserAdapter |
Construct a new parser adapter. |
Modifier and Type | Method | Description |
---|---|---|
void |
characters |
Adapter implementation method; do not call. |
void |
endDocument() |
Adapter implementation method; do not call. |
void |
endElement |
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 |
Check a parser feature flag. |
Object |
getProperty |
Get a parser property. |
void |
ignorableWhitespace |
Adapter implementation method; do not call. |
void |
parse |
Parse an XML document. |
void |
parse |
Parse an XML document. |
void |
processingInstruction |
Adapter implementation method; do not call. |
void |
setContentHandler |
Set the content handler. |
void |
setDocumentLocator |
Adapter implementation method; do not call. |
void |
setDTDHandler |
Set the DTD handler. |
void |
setEntityResolver |
Set the entity resolver. |
void |
setErrorHandler |
Set the error handler. |
void |
setFeature |
Set a feature flag for the parser. |
void |
setProperty |
Set a parser property. |
void |
startDocument() |
Adapter implementation method; do not call. |
void |
startElement |
Adapter implementation method; do not call. |
public ParserAdapter() throws SAXException
Use the "org.xml.sax.parser" property to locate the embedded SAX1 driver.
SAXException
- If the embedded driver cannot be instantiated or if the org.xml.sax.parser property is not specified.public ParserAdapter(Parser parser)
Note that the embedded parser cannot be changed once the adapter is created; to embed a different parser, allocate a new ParserAdapter.
parser
- The SAX1 parser to embed.NullPointerException
- If the parser parameter is null.public void setFeature(String name, boolean value) throws SAXNotRecognizedException, SAXNotSupportedException
The only features recognized are namespaces and namespace-prefixes.
setFeature
in interface XMLReader
name
- The feature name, as a complete URI.value
- The requested feature value.SAXNotRecognizedException
- If the feature can't be assigned or retrieved.SAXNotSupportedException
- If the feature can't be assigned that value.public boolean getFeature(String name) throws SAXNotRecognizedException, SAXNotSupportedException
The only features recognized are namespaces and namespace-prefixes.
getFeature
in interface XMLReader
name
- The feature name, as a complete URI.SAXNotRecognizedException
- If the feature value can't be assigned or retrieved.SAXNotSupportedException
- If the feature is not currently readable.public void setProperty(String name, Object value) throws SAXNotRecognizedException, SAXNotSupportedException
No properties are currently recognized.
setProperty
in interface XMLReader
name
- The property name.value
- The property value.SAXNotRecognizedException
- If the property value can't be assigned or retrieved.SAXNotSupportedException
- If the property can't be assigned that value.public Object getProperty(String name) throws SAXNotRecognizedException, SAXNotSupportedException
No properties are currently recognized.
getProperty
in interface XMLReader
name
- The property name.SAXNotRecognizedException
- If the property value can't be assigned or retrieved.SAXNotSupportedException
- If the property value is not currently readable.public void setEntityResolver(EntityResolver resolver)
setEntityResolver
in interface XMLReader
resolver
- The new entity resolver.public EntityResolver getEntityResolver()
getEntityResolver
in interface XMLReader
public void setDTDHandler(DTDHandler handler)
setDTDHandler
in interface XMLReader
handler
- the new DTD handlerpublic DTDHandler getDTDHandler()
getDTDHandler
in interface XMLReader
public void setContentHandler(ContentHandler handler)
setContentHandler
in interface XMLReader
handler
- the new content handlerpublic ContentHandler getContentHandler()
getContentHandler
in interface XMLReader
public void setErrorHandler(ErrorHandler handler)
setErrorHandler
in interface XMLReader
handler
- The new error handler.public ErrorHandler getErrorHandler()
getErrorHandler
in interface XMLReader
public void parse(String systemId) throws IOException, SAXException
parse
in interface XMLReader
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(InputSource input) throws IOException, SAXException
parse
in interface XMLReader
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 setDocumentLocator(Locator locator)
setDocumentLocator
in interface DocumentHandler
locator
- A document locator.public void startDocument() throws SAXException
startDocument
in interface DocumentHandler
SAXException
- The client may raise a processing exception.public void endDocument() throws SAXException
endDocument
in interface DocumentHandler
SAXException
- The client may raise a processing exception.public void startElement(String qName, AttributeList qAtts) throws SAXException
If necessary, perform Namespace processing.
startElement
in interface DocumentHandler
qName
- The qualified (prefixed) name.qAtts
- The XML attribute list (with qnames).SAXException
- The client may raise a processing exception.public void endElement(String qName) throws SAXException
endElement
in interface DocumentHandler
qName
- The qualified (prefixed) name.SAXException
- The client may raise a processing exception.public void characters(char[] ch, int start, int length) throws SAXException
characters
in interface DocumentHandler
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 ignorableWhitespace(char[] ch, int start, int length) throws SAXException
ignorableWhitespace
in interface DocumentHandler
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 processingInstruction(String target, String data) throws SAXException
processingInstruction
in interface DocumentHandler
target
- The processing instruction target.data
- The remainder of the processing instructionSAXException
- The client may raise a processing exception.
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.xml/org/xml/sax/helpers/ParserAdapter.html