# SAXParser

public abstract class **SAXParser** extends [Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html)  
Defines the API that wraps an `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/XMLReader.html`
implementation class. In JAXP 1.0, this class wrapped the
`https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/Parser.html` interface, however this interface was
replaced by the `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/XMLReader.html`. For ease
of transition, this class continues to support the same name
and interface as well as supporting new methods.

An instance of this class can be obtained from the
`https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/SAXParserFactory.html#newSAXParser()` method.
Once an instance of this class is obtained, XML can be parsed from
a variety of input sources. These input sources are InputStreams,
Files, URLs, and SAX InputSources.


This static method creates a new factory instance based
on a system property setting or uses the platform default
if no property has been defined.


The system property that controls which Factory implementation
to create is named `"javax.xml.parsers.SAXParserFactory"`.
This property names a class that is a concrete subclass of this
abstract class. If no property is defined, a platform default
will be used.
As the content is parsed by the underlying parser, methods of the given `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/HandlerBase.html` or the `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/helpers/DefaultHandler.html` are called.


Implementations of this class which wrap an underlying implementation
can consider using the `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/helpers/ParserAdapter.html`
class to initially adapt their SAX1 implementation to work under
this revised class.

### Protected Constructor Summary

|---|---|
|   | [SAXParser](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/SAXParser.html#SAXParser())() Protected constructor to prevent instantiation. |

### Public Method Summary

|---|---|
| abstract [Parser](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/Parser.html) | [getParser](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/SAXParser.html#getParser())() Returns the SAX parser that is encapsulated by the implementation of this class. |
| abstract [Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html) | [getProperty](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/SAXParser.html#getProperty(java.lang.String))([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) name) Returns the particular property requested for in the underlying implementation of `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/XMLReader.html`. |
| [Schema](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/validation/Schema.html) | [getSchema](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/SAXParser.html#getSchema())() Get a reference to the the `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/validation/Schema.html` being used by the XML processor. |
| abstract [XMLReader](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/XMLReader.html) | [getXMLReader](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/SAXParser.html#getXMLReader())() Returns the `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/XMLReader.html` that is encapsulated by the implementation of this class. |
| abstract boolean | [isNamespaceAware](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/SAXParser.html#isNamespaceAware())() Indicates whether or not this parser is configured to understand namespaces. |
| abstract boolean | [isValidating](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/SAXParser.html#isValidating())() Indicates whether or not this parser is configured to validate XML documents. |
| boolean | [isXIncludeAware](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/SAXParser.html#isXIncludeAware())() Get the XInclude processing mode for this parser. |
| void | [parse](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/SAXParser.html#parse(org.xml.sax.InputSource,%20org.xml.sax.helpers.DefaultHandler))([InputSource](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/InputSource.html) is, [DefaultHandler](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/helpers/DefaultHandler.html) dh) Parse the content given `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/InputSource.html` as XML using the specified `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/helpers/DefaultHandler.html`. |
| void | [parse](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/SAXParser.html#parse(org.xml.sax.InputSource,%20org.xml.sax.HandlerBase))([InputSource](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/InputSource.html) is, [HandlerBase](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/HandlerBase.html) hb) Parse the content given `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/InputSource.html` as XML using the specified `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/HandlerBase.html`. |
| void | [parse](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/SAXParser.html#parse(java.io.InputStream,%20org.xml.sax.HandlerBase,%20java.lang.String))([InputStream](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/InputStream.html) is, [HandlerBase](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/HandlerBase.html) hb, [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) systemId) Parse the content of the given `https://developers.google.com/j2objc/javadoc/jre/reference/java/io/InputStream.html` instance as XML using the specified `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/HandlerBase.html`. |
| void | [parse](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/SAXParser.html#parse(java.lang.String,%20org.xml.sax.HandlerBase))([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) uri, [HandlerBase](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/HandlerBase.html) hb) Parse the content described by the giving Uniform Resource Identifier (URI) as XML using the specified `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/HandlerBase.html`. |
| void | [parse](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/SAXParser.html#parse(java.io.File,%20org.xml.sax.HandlerBase))([File](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/File.html) f, [HandlerBase](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/HandlerBase.html) hb) Parse the content of the file specified as XML using the specified `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/HandlerBase.html`. |
| void | [parse](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/SAXParser.html#parse(java.lang.String,%20org.xml.sax.helpers.DefaultHandler))([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) uri, [DefaultHandler](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/helpers/DefaultHandler.html) dh) Parse the content described by the giving Uniform Resource Identifier (URI) as XML using the specified `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/helpers/DefaultHandler.html`. |
| void | [parse](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/SAXParser.html#parse(java.io.InputStream,%20org.xml.sax.HandlerBase))([InputStream](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/InputStream.html) is, [HandlerBase](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/HandlerBase.html) hb) Parse the content of the given `https://developers.google.com/j2objc/javadoc/jre/reference/java/io/InputStream.html` instance as XML using the specified `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/HandlerBase.html`. |
| void | [parse](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/SAXParser.html#parse(java.io.File,%20org.xml.sax.helpers.DefaultHandler))([File](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/File.html) f, [DefaultHandler](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/helpers/DefaultHandler.html) dh) Parse the content of the file specified as XML using the specified `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/helpers/DefaultHandler.html`. |
| void | [parse](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/SAXParser.html#parse(java.io.InputStream,%20org.xml.sax.helpers.DefaultHandler))([InputStream](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/InputStream.html) is, [DefaultHandler](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/helpers/DefaultHandler.html) dh) Parse the content of the given `https://developers.google.com/j2objc/javadoc/jre/reference/java/io/InputStream.html` instance as XML using the specified `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/helpers/DefaultHandler.html`. |
| void | [parse](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/SAXParser.html#parse(java.io.InputStream,%20org.xml.sax.helpers.DefaultHandler,%20java.lang.String))([InputStream](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/InputStream.html) is, [DefaultHandler](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/helpers/DefaultHandler.html) dh, [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) systemId) Parse the content of the given `https://developers.google.com/j2objc/javadoc/jre/reference/java/io/InputStream.html` instance as XML using the specified `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/helpers/DefaultHandler.html`. |
| void | [reset](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/SAXParser.html#reset())() Reset this `SAXParser` to its original configuration. |
| abstract void | [setProperty](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/SAXParser.html#setProperty(java.lang.String,%20java.lang.Object))([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) name, [Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html) value) Sets the particular property in the underlying implementation of `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/XMLReader.html`. |

### Inherited Method Summary

From class [java.lang.Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html)

|---|---|
| [Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html) | [clone](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#clone())() Creates and returns a copy of this `Object`. |
| boolean | [equals](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#equals(java.lang.Object))([Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html) obj) Compares this instance with the specified object and indicates if they are equal. |
| void | [finalize](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#finalize())() Invoked when the garbage collector has detected that this instance is no longer reachable. |
| final [Class](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Class.html)\<?\> | [getClass](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#getClass())() Returns the unique instance of `https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Class.html` that represents this object's class. |
| int | [hashCode](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#hashCode())() Returns an integer hash code for this object. |
| final void | [notify](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#notify())() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up. |
| final void | [notifyAll](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#notifyAll())() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up. |
| [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) | [toString](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#toString())() Returns a string containing a concise, human-readable description of this object. |
| final void | [wait](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#wait(long,%20int))(long timeout, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires. |
| final void | [wait](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#wait(long))(long timeout) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires. |
| final void | [wait](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#wait())() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object. |

## Protected Constructors

#### protected
**SAXParser**
()

<br />

Protected constructor to prevent instantiation.
Use `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/SAXParserFactory.html#newSAXParser()`.

<br />

## Public Methods

#### public abstract [Parser](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/Parser.html)
**getParser**
()

Returns the SAX parser that is encapsulated by the
implementation of this class.

##### Returns

- The SAX parser that is encapsulated by the implementation of this class.

##### Throws

| [SAXException](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/SAXException.html) | If any SAX errors occur during processing. |
|---|---|

#### public abstract [Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html)
**getProperty**
([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) name)

<br />

Returns the particular property requested for in the underlying
implementation of `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/XMLReader.html`.

<br />

##### Parameters

| name | The name of the property to be retrieved. |
|---|---|

##### Returns

- Value of the requested property.

##### Throws

| [SAXNotRecognizedException](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/SAXNotRecognizedException.html) | When the underlying XMLReader does not recognize the property name. |
| [SAXNotSupportedException](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/SAXNotSupportedException.html) | When the underlying XMLReader recognizes the property name but doesn't support the property. |
|---|---|

##### See Also

- `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/XMLReader.html#getProperty(java.lang.String)`

#### public [Schema](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/validation/Schema.html)
**getSchema**
()

<br />

Get a reference to the the `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/validation/Schema.html` being used by
the XML processor.

If no schema is being used, `null` is returned.

<br />

##### Returns

- `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/validation/Schema.html` being used or `null` if none in use

##### Throws

| [UnsupportedOperationException](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/UnsupportedOperationException.html) | For backward compatibility, when implementations for earlier versions of JAXP is used, this exception will be thrown. |
|---|---|

#### public abstract [XMLReader](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/XMLReader.html)
**getXMLReader**
()

Returns the `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/XMLReader.html` that is encapsulated by the
implementation of this class.

##### Returns

- The XMLReader that is encapsulated by the implementation of this class.

##### Throws

| [SAXException](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/SAXException.html) | If any SAX errors occur during processing. |
|---|---|

#### public abstract boolean
**isNamespaceAware**
()

Indicates whether or not this parser is configured to
understand namespaces.

##### Returns

- true if this parser is configured to understand namespaces; false otherwise.

#### public abstract boolean
**isValidating**
()

Indicates whether or not this parser is configured to
validate XML documents.

##### Returns

- true if this parser is configured to validate XML documents; false otherwise.

#### public boolean
**isXIncludeAware**
()

<br />

Get the XInclude processing mode for this parser.

<br />

##### Returns

- the return value of the `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/SAXParserFactory.html#isXIncludeAware()` when this parser was created from factory.

##### Throws

| [UnsupportedOperationException](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/UnsupportedOperationException.html) | For backward compatibility, when implementations for earlier versions of JAXP is used, this exception will be thrown. |
|---|---|

##### See Also

- `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/SAXParserFactory.html#setXIncludeAware(boolean)`

#### public void
**parse**
([InputSource](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/InputSource.html) is, [DefaultHandler](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/helpers/DefaultHandler.html) dh)

Parse the content given `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/InputSource.html`
as XML using the specified
`https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/helpers/DefaultHandler.html`.

##### Parameters

| is | The InputSource containing the content to be parsed. |
| dh | The SAX DefaultHandler to use. |
|---|---|

##### Throws

| [IllegalArgumentException](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/IllegalArgumentException.html) | If the `InputSource` object is `null`. |
| [IOException](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/IOException.html) | If any IO errors occur. |
| [SAXException](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/SAXException.html) | If any SAX errors occur during processing. |
|---|---|

##### See Also

- `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/DocumentHandler.html`

#### public void
**parse**
([InputSource](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/InputSource.html) is, [HandlerBase](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/HandlerBase.html) hb)

Parse the content given `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/InputSource.html`
as XML using the specified
`https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/HandlerBase.html`.
* Use of the DefaultHandler version of this method is recommended as the HandlerBase class has been deprecated in SAX 2.0*

##### Parameters

| is | The InputSource containing the content to be parsed. |
| hb | The SAX HandlerBase to use. |
|---|---|

##### Throws

| [IllegalArgumentException](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/IllegalArgumentException.html) | If the `InputSource` object is `null`. |
| [IOException](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/IOException.html) | If any IO errors occur. |
| [SAXException](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/SAXException.html) | If any SAX errors occur during processing. |
|---|---|

##### See Also

- `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/DocumentHandler.html`

#### public void
**parse**
([InputStream](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/InputStream.html) is, [HandlerBase](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/HandlerBase.html) hb, [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) systemId)

<br />

Parse the content of the given `https://developers.google.com/j2objc/javadoc/jre/reference/java/io/InputStream.html`
instance as XML using the specified `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/HandlerBase.html`.
* Use of the DefaultHandler version of this method is recommended as the HandlerBase class has been deprecated in SAX 2.0*.

<br />

##### 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

| [IllegalArgumentException](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/IllegalArgumentException.html) | If the given `InputStream` is `null`. |
| [IOException](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/IOException.html) | If any IO error occurs interacting with the `InputStream`. |
| [SAXException](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/SAXException.html) | If any SAX errors occur during processing. |
|---|---|

##### See Also

- `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/DocumentHandler.html`

#### public void
**parse**
([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) uri, [HandlerBase](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/HandlerBase.html) hb)

Parse the content described by the giving Uniform Resource
Identifier (URI) as XML using the specified
`https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/HandlerBase.html`.
* Use of the DefaultHandler version of this method is recommended as the `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

| [IllegalArgumentException](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/IllegalArgumentException.html) | If the uri is null. |
| [IOException](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/IOException.html) | If any IO errors occur. |
| [SAXException](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/SAXException.html) | If any SAX errors occur during processing. |
|---|---|

##### See Also

- `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/DocumentHandler.html`

#### public void
**parse**
([File](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/File.html) f, [HandlerBase](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/HandlerBase.html) hb)

Parse the content of the file specified as XML using the
specified `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/HandlerBase.html`.
* Use of the DefaultHandler version of this method is recommended as the HandlerBase class has been deprecated in SAX 2.0*

##### Parameters

| f | The file containing the XML to parse |
| hb | The SAX HandlerBase to use. |
|---|---|

##### Throws

| [IllegalArgumentException](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/IllegalArgumentException.html) | If the File object is null. |
| [IOException](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/IOException.html) | If any IO errors occur. |
| [SAXException](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/SAXException.html) | If any SAX errors occur during processing. |
|---|---|

##### See Also

- `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/DocumentHandler.html`

#### public void
**parse**
([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) uri, [DefaultHandler](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/helpers/DefaultHandler.html) dh)

Parse the content described by the giving Uniform Resource
Identifier (URI) as XML using the specified
`https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/helpers/DefaultHandler.html`.

##### Parameters

| uri | The location of the content to be parsed. |
| dh | The SAX DefaultHandler to use. |
|---|---|

##### Throws

| [IllegalArgumentException](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/IllegalArgumentException.html) | If the uri is null. |
| [IOException](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/IOException.html) | If any IO errors occur. |
| [SAXException](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/SAXException.html) | If any SAX errors occur during processing. |
|---|---|

##### See Also

- `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/DocumentHandler.html`

#### public void
**parse**
([InputStream](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/InputStream.html) is, [HandlerBase](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/HandlerBase.html) hb)

<br />

Parse the content of the given `https://developers.google.com/j2objc/javadoc/jre/reference/java/io/InputStream.html`
instance as XML using the specified `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/HandlerBase.html`.
* Use of the DefaultHandler version of this method is recommended as the HandlerBase class has been deprecated in SAX 2.0*.

<br />

##### Parameters

| is | InputStream containing the content to be parsed. |
| hb | The SAX HandlerBase to use. |
|---|---|

##### Throws

| [IllegalArgumentException](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/IllegalArgumentException.html) | If the given InputStream is null. |
| [SAXException](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/SAXException.html) | If parse produces a SAX error. |
| [IOException](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/IOException.html) | If an IO error occurs interacting with the `InputStream`. |
|---|---|

##### See Also

- `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/DocumentHandler.html`

#### public void
**parse**
([File](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/File.html) f, [DefaultHandler](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/helpers/DefaultHandler.html) dh)

Parse the content of the file specified as XML using the
specified `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/helpers/DefaultHandler.html`.

##### Parameters

| f | The file containing the XML to parse |
| dh | The SAX DefaultHandler to use. |
|---|---|

##### Throws

| [IllegalArgumentException](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/IllegalArgumentException.html) | If the File object is null. |
| [IOException](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/IOException.html) | If any IO errors occur. |
| [SAXException](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/SAXException.html) | If any SAX errors occur during processing. |
|---|---|

##### See Also

- `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/DocumentHandler.html`

#### public void
**parse**
([InputStream](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/InputStream.html) is, [DefaultHandler](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/helpers/DefaultHandler.html) dh)

Parse the content of the given `https://developers.google.com/j2objc/javadoc/jre/reference/java/io/InputStream.html`
instance as XML using the specified
`https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/helpers/DefaultHandler.html`.

##### Parameters

| is | InputStream containing the content to be parsed. |
| dh | The SAX DefaultHandler to use. |
|---|---|

##### Throws

| [IllegalArgumentException](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/IllegalArgumentException.html) | If the given InputStream is null. |
| [IOException](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/IOException.html) | If any IO errors occur. |
| [SAXException](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/SAXException.html) | If any SAX errors occur during processing. |
|---|---|

##### See Also

- `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/DocumentHandler.html`

#### public void
**parse**
([InputStream](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/InputStream.html) is, [DefaultHandler](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/helpers/DefaultHandler.html) dh, [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) systemId)

Parse the content of the given `https://developers.google.com/j2objc/javadoc/jre/reference/java/io/InputStream.html`
instance as XML using the specified
`https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/helpers/DefaultHandler.html`.

##### 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

| [IllegalArgumentException](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/IllegalArgumentException.html) | If the given InputStream is null. |
| [IOException](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/IOException.html) | If any IO errors occur. |
| [SAXException](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/SAXException.html) | If any SAX errors occur during processing. |
|---|---|

##### See Also

- `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/DocumentHandler.html`

#### public void
**reset**
()

<br />

Reset this `SAXParser` to its original configuration.

`SAXParser` is reset to the same state as when it was created with
`https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/SAXParserFactory.html#newSAXParser()`.
`reset()` is designed to allow the reuse of existing `SAXParser`s
thus saving resources associated with the creation of new `SAXParser`s.

The reset `SAXParser` is not guaranteed to have the same `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/validation/Schema.html`
`Object`, e.g. `https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#equals(java.lang.Object)`. It is guaranteed to have a functionally equal
`Schema`.

<br />

#### public abstract void
**setProperty**
([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) name, [Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html) value)

<br />

Sets the particular property in the underlying implementation of
`https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/XMLReader.html`.
A list of the core features and properties can be found at
<http://sax.sourceforge.net/?selected=get-set>.

<br />

##### Parameters

| name | The name of the property to be set. |
| value | The value of the property to be set. |
|---|---|

##### Throws

| [SAXNotRecognizedException](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/SAXNotRecognizedException.html) | When the underlying XMLReader does not recognize the property name. |
| [SAXNotSupportedException](https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/SAXNotSupportedException.html) | When the underlying XMLReader recognizes the property name but doesn't support the property. |
|---|---|

##### See Also

- `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/XMLReader.html#setProperty(java.lang.String,%20java.lang.Object)`