|
XML API 1.0 | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object javax.xml.parsers.SAXParser
public abstract class SAXParser
Defines the API that represents a simple SAX parser.
An instance of this class can be obtained from the
SAXParserFactory.newSAXParser()
method.
Once an instance of this class is obtained, XML can be parsed from
an InputStream
As the content is parsed by the underlying parser, methods of the
given DefaultHandler
are called.
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.
Constructor Summary | |
---|---|
protected |
SAXParser()
|
Method Summary | |
---|---|
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. |
abstract void |
parse(InputSource is,
DefaultHandler dh)
Parse the content given InputSource
as XML using the specified
DefaultHandler . |
abstract void |
parse(InputStream is,
DefaultHandler dh)
Parse the content of the given InputStream
instance as XML using the specified
DefaultHandler . |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
protected SAXParser()
Method Detail |
---|
public abstract void parse(InputStream is, DefaultHandler dh) throws SAXException, IOException
InputStream
instance as XML using the specified
DefaultHandler
.
is
- InputStream containing the content to be parsed.dh
- The SAX DefaultHandler to use.
IOException
- If any IO errors occur.
IllegalArgumentException
- If the given InputStream is null.
SAXException
- If the underlying parser throws a
SAXException while parsing.public abstract void parse(InputSource is, DefaultHandler dh) throws SAXException, IOException
InputSource
as XML using the specified
DefaultHandler
.
is
- The InputSource containing the content to be parsed.dh
- The SAX DefaultHandler to use.
IOException
- If any IO errors occur.
IllegalArgumentException
- If the InputSource is null.
SAXException
- If the underlying parser throws a
SAXException while parsing.DefaultHandler
public abstract XMLReader getXMLReader() throws SAXException
XMLReader
that is encapsulated by the
implementation of this class.
SAXException
- If any SAX errors occur during processing.public abstract boolean isNamespaceAware()
true
if this parser is configured to
understand namespaces; false
otherwise.public abstract boolean isValidating()
true
if this parser is configured to validate XML
documents; false
otherwise.
|
XML API 1.0 | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |