javax.xml.parsers
public abstract class SAXParser extends Object
As the content is parsed by the underlying parser, methods of the given HandlerBase or the DefaultHandler are called.
Implementors of this class which wrap an underlying implementation can consider using the ParserAdapter class to initially adapt their SAX1 impelemntation to work under this revised class.
An implementation of SAXParser
is NOT
guaranteed to behave as per the specification if it is used concurrently by
two or more threads. It is recommended to have one instance of the
SAXParser
per thread or it is upto the application to
make sure about the use of SAXParser
from more than one
thread.
Since: JAXP 1.0
Version: 1.0
Constructor Summary | |
---|---|
protected | SAXParser() |
Method Summary | |
---|---|
abstract Parser | getParser()
Returns the SAX parser that is encapsultated by the
implementation of this class.
|
abstract Object | getProperty(String name)
Returns the particular property requested for in the underlying
implementation of XMLReader.
|
abstract XMLReader | getXMLReader()
Returns the XMLReader that is encapsulated by the
implementation of this class.
|
abstract boolean | isNamespaceAware()
Indicates whether or not this parser is configured to
understand namespaces.
|
abstract boolean | isValidating()
Indicates whether or not this parser is configured to
validate XML documents.
|
void | parse(InputStream is, HandlerBase hb)
Parse the content of the given java.io.InputStream
instance as XML using the specified HandlerBase.
|
void | parse(InputStream is, HandlerBase hb, String systemId)
Parse the content of the given java.io.InputStream
instance as XML using the specified HandlerBase.
|
void | parse(InputStream is, DefaultHandler dh)
Parse the content of the given java.io.InputStream
instance as XML using the specified
DefaultHandler.
|
void | parse(InputStream is, DefaultHandler dh, String systemId)
Parse the content of the given java.io.InputStream
instance as XML using the specified
DefaultHandler.
|
void | parse(String uri, HandlerBase hb)
Parse the content described by the giving Uniform Resource
Identifier (URI) as XML using the specified
HandlerBase.
|
void | parse(String uri, DefaultHandler dh)
Parse the content described by the giving Uniform Resource
Identifier (URI) as XML using the specified
DefaultHandler.
|
void | parse(File f, HandlerBase hb)
Parse the content of the file specified as XML using the
specified HandlerBase.
|
void | parse(File f, DefaultHandler dh)
Parse the content of the file specified as XML using the
specified DefaultHandler.
|
void | parse(InputSource is, HandlerBase hb)
Parse the content given InputSource
as XML using the specified
HandlerBase.
|
void | parse(InputSource is, DefaultHandler dh)
Parse the content given InputSource
as XML using the specified
DefaultHandler.
|
abstract void | setProperty(String name, Object value)
Sets the particular property in the underlying implementation of
XMLReader.
|
Returns: The SAX parser that is encapsultated by the implementation of this class.
Parameters: name The name of the property to be retrieved.
Returns: Value of the requested property.
Throws: SAXNotRecognizedException When the underlying XMLReader does not recognize the property name. SAXNotSupportedException When the underlying XMLReader recognizes the property name but doesn't support the property.
See Also: XMLReader
Returns: The XMLReader that is encapsulated by the implementation of this class.
Returns: true if this parser is configured to understand namespaces; false otherwise.
Returns: true if this parser is configured to validate XML documents; false otherwise.
Parameters: is InputStream containing the content to be parsed. hb The SAX HandlerBase to use.
Throws: IOException If any IO errors occur. IllegalArgumentException If the given InputStream is null. SAXException If the underlying parser throws a SAXException while parsing.
See Also: DocumentHandler
Parameters: is InputStream containing the content to be parsed. hb The SAX HandlerBase to use. systemId The systemId which is needed for resolving relative URIs.
Throws: IOException If any IO errors occur. IllegalArgumentException If the given InputStream is null. SAXException If the underlying parser throws a SAXException while parsing.
See Also:
version of this method instead.
Parameters: is InputStream containing the content to be parsed. dh The SAX DefaultHandler to use.
Throws: IOException If any IO errors occur. IllegalArgumentException If the given InputStream is null. SAXException If the underlying parser throws a SAXException while parsing.
See Also: DocumentHandler
Parameters: is InputStream containing the content to be parsed. dh The SAX DefaultHandler to use. systemId The systemId which is needed for resolving relative URIs.
Throws: IOException If any IO errors occur. IllegalArgumentException If the given InputStream is null. SAXException If the underlying parser throws a SAXException while parsing.
See Also:
version of this method instead.
HandlerBase
class has been deprecated in SAX 2.0
Parameters: uri The location of the content to be parsed. hb The SAX HandlerBase to use.
Throws: IOException If any IO errors occur. IllegalArgumentException If the uri is null. SAXException If the underlying parser throws a SAXException while parsing.
See Also: DocumentHandler
Parameters: uri The location of the content to be parsed. dh The SAX DefaultHandler to use.
Throws: IOException If any IO errors occur. IllegalArgumentException If the uri is null. SAXException If the underlying parser throws a SAXException while parsing.
See Also: DocumentHandler
Parameters: f The file containing the XML to parse hb The SAX HandlerBase to use.
Throws: IOException If any IO errors occur. IllegalArgumentException If the File object is null. SAXException If the underlying parser throws a SAXException while parsing.
See Also: DocumentHandler
Parameters: f The file containing the XML to parse dh The SAX DefaultHandler to use.
Throws: IOException If any IO errors occur. IllegalArgumentException If the File object is null. SAXException If the underlying parser throws a SAXException while parsing.
See Also: DocumentHandler
Parameters: is The InputSource containing the content to be parsed. hb The SAX HandlerBase to use.
Throws: IOException If any IO errors occur. IllegalArgumentException If the InputSource is null. SAXException If the underlying parser throws a SAXException while parsing.
See Also: DocumentHandler
Parameters: is The InputSource containing the content to be parsed. dh The SAX DefaultHandler to use.
Throws: IOException If any IO errors occur. IllegalArgumentException If the InputSource is null. SAXException If the underlying parser throws a SAXException while parsing.
See Also: DocumentHandler
Parameters: name The name of the property to be set. value The value of the property to be set.
Throws: SAXNotRecognizedException When the underlying XMLReader does not recognize the property name. SAXNotSupportedException When the underlying XMLReader recognizes the property name but doesn't support the property.
See Also: XMLReader