uTools-Manuals/docs/java/org/xml/sax/XMLReader.html

<div class="header">
<div class="subTitle">
     compact2, compact3 
   </div>
<div class="subTitle">
     org.xml.sax 
   </div>
<h2 class="title" title="Interface XMLReader">Interface XMLReader</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
         All Known Subinterfaces: 
       </dt>
<dd>
<span><a href="../../../org/xml/sax/XMLFilter.html" title="org.xml.sax中的接口">XMLFilter</a></span>
</dd>
</dl>
<dl>
<dt>
        所有已知实现类：
       </dt>
<dd>
<span><a href="../../../org/xml/sax/helpers/ParserAdapter.html" title="org.xml.sax.helpers中的类">ParserAdapter</a> ， <a href="../../../org/xml/sax/helpers/XMLFilterImpl.html" title="org.xml.sax.helpers中的类">XMLFilterImpl</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">XMLReader</span></pre>
<div class="block">
<span>使用回调读取XML文档的界面。</span>
<blockquote>
<span><em>This module, both source code and documentation, is in the Public Domain, and comes with <strong>NO WARRANTY</strong>.</em> See <a href="http://www.saxproject.org">http://www.saxproject.org</a> for further information.</span>
</blockquote>
<p> <span><strong>注意：</strong>尽管它的名字，此接口<em>不</em>扩展标准的Java <a href="../../../java/io/Reader.html" title="java.io中的类"><code>Reader</code></a>接口，因为读取XML是一个完全不同的活动与读取字符数据。</span> </p>
<p> <span>XMLReader是XML解析器的SAX2驱动程序必须实现的接口。</span> <span>该接口允许应用程序在解析器中设置和查询特征和属性，注册用于文档处理的事件处理程序，并启动文档解析。</span> </p>
<p> <span>假设所有SAX接口都是同步的： <a href="../../../org/xml/sax/XMLReader.html#parse-org.xml.sax.InputSource-"><code>parse</code></a>方法不能返回，直到解析完成，读者必须等待事件处理程序回调才能返回，然后再报告下一个事件。</span> </p>
<p> <span>该界面替代了（现已弃用）SAX 1.0 <a href="../../../org/xml/sax/Parser.html" title="org.xml.sax中的接口"><code>Parser</code></a>界面。</span> <span>XMLReader界面包含了旧的Parser界面（以及一些较小的）的两个重要增强功能：</span> </p>
<ol>
<li> <span>它增加了查询和设置特征和属性的标准方法;</span> <span>和</span> </li>
<li> <span>它增加了命名空间支持，这是许多更高级别的XML标准所必需的。</span> </li>
</ol>
<p> <span>有可用于将SAX1解析器转换为SAX2 XMLReader的适配器，反之亦然。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
         SAX 2.0 
       </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../org/xml/sax/XMLFilter.html" title="org.xml.sax中的接口"><code>XMLFilter</code></a> ， <a href="../../../org/xml/sax/helpers/ParserAdapter.html" title="org.xml.sax.helpers中的类"><code>ParserAdapter</code></a> ， <a href="../../../org/xml/sax/helpers/XMLReaderAdapter.html" title="org.xml.sax.helpers中的类"><code>XMLReaderAdapter</code></a></span>
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- --> </a> <h3>方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption>
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t3"><span><a href="javascript:show(4);">抽象方法</a></span><span class="tabEnd"> </span></span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor" id="i0">
<td class="colFirst"><code><a href="../../../org/xml/sax/ContentHandler.html" title="interface in org.xml.sax">ContentHandler</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/XMLReader.html#getContentHandler--">getContentHandler</a></span>()</code>
<div class="block">
              返回当前内容处理程序。 
            </div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../../org/xml/sax/DTDHandler.html" title="interface in org.xml.sax">DTDHandler</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/XMLReader.html#getDTDHandler--">getDTDHandler</a></span>()</code>
<div class="block">
              返回当前的DTD处理程序。 
            </div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../../org/xml/sax/EntityResolver.html" title="interface in org.xml.sax">EntityResolver</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/XMLReader.html#getEntityResolver--">getEntityResolver</a></span>()</code>
<div class="block">
              返回当前的实体解析器。 
            </div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../../org/xml/sax/ErrorHandler.html" title="interface in org.xml.sax">ErrorHandler</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/XMLReader.html#getErrorHandler--">getErrorHandler</a></span>()</code>
<div class="block">
              返回当前的错误处理程序。 
            </div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/XMLReader.html#getFeature-java.lang.String-">getFeature</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</code>
<div class="block">
              查找特征标记的值。 
            </div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/XMLReader.html#getProperty-java.lang.String-">getProperty</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</code>
<div class="block">
              查找属性的值。 
            </div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/XMLReader.html#parse-org.xml.sax.InputSource-">parse</a></span>(<a href="../../../org/xml/sax/InputSource.html" title="class in org.xml.sax">InputSource</a> input)</code>
<div class="block">
              解析一个XML文档。 
            </div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/XMLReader.html#parse-java.lang.String-">parse</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> systemId)</code>
<div class="block">
              从系统标识符（URI）解析XML文档。 
            </div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/XMLReader.html#setContentHandler-org.xml.sax.ContentHandler-">setContentHandler</a></span>(<a href="../../../org/xml/sax/ContentHandler.html" title="interface in org.xml.sax">ContentHandler</a> handler)</code>
<div class="block">
              允许应用程序注册内容事件处理程序。 
            </div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/XMLReader.html#setDTDHandler-org.xml.sax.DTDHandler-">setDTDHandler</a></span>(<a href="../../../org/xml/sax/DTDHandler.html" title="interface in org.xml.sax">DTDHandler</a> handler)</code>
<div class="block">
              允许应用程序注册DTD事件处理程序。 
            </div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/XMLReader.html#setEntityResolver-org.xml.sax.EntityResolver-">setEntityResolver</a></span>(<a href="../../../org/xml/sax/EntityResolver.html" title="interface in org.xml.sax">EntityResolver</a> resolver)</code>
<div class="block">
              允许应用程序注册一个实体解析器。 
            </div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/XMLReader.html#setErrorHandler-org.xml.sax.ErrorHandler-">setErrorHandler</a></span>(<a href="../../../org/xml/sax/ErrorHandler.html" title="interface in org.xml.sax">ErrorHandler</a> handler)</code>
<div class="block">
              允许应用程序注册错误事件处理程序。 
            </div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/XMLReader.html#setFeature-java.lang.String-boolean-">setFeature</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name, boolean value)</code>
<div class="block">
              设置特征标志的值。 
            </div> </td>
</tr>
<tr class="rowColor" id="i13">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/XMLReader.html#setProperty-java.lang.String-java.lang.Object-">setProperty</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name, <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> value)</code>
<div class="block">
              设置属性的值。 
            </div> </td>
</tr>
</tbody>
</table> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getFeature-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getFeature</h4> <pre>boolean getFeature(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)
            throws <a href="../../../org/xml/sax/SAXNotRecognizedException.html" title="class in org.xml.sax">SAXNotRecognizedException</a>,
                   <a href="../../../org/xml/sax/SAXNotSupportedException.html" title="class in org.xml.sax">SAXNotSupportedException</a></pre>
<div class="block">
<span>查找特征标记的值。</span>
<p> <span>功能名称是任何完全限定的URI。</span> <span>XMLReader可以识别一个功能名称，但暂时无法返回其值。</span> <span>一些特征值可能仅在特定上下文中可用，例如解析之前，期间或之后。</span> <span>此外，某些功能值可能无法以编程方式访问。</span> <span>（在适用于SAX1 <a href="../../../org/xml/sax/Parser.html" title="org.xml.sax中的接口"><code>Parser</code></a>的适配器的情况下，没有实现独立的方式来公开底层解析器是否正在执行验证，扩展外部实体等）。</span> </p>
<p> <span>所有XMLReaders都需要识别http://xml.org/sax/features/names空间和http://xml.org/sax/features/namespace-prefixes功能名称。</span> </p>
<p> <span>典型用法是这样的：</span> </p>
<pre>  <span>XMLReader r = new MySAXDriver();

                         // try to activate validation
 try {
   r.setFeature("http://xml.org/sax/features/validation", true);
 } catch (SAXException e) {
   System.err.println("Cannot activate validation.");
 }

                         // register event handlers
 r.setContentHandler(new MyContentHandler());
 r.setErrorHandler(new MyErrorHandler());

                         // parse the first document
 try {
   r.parse("http://www.foo.com/mydoc.xml");
 } catch (IOException e) {
   System.err.println("I/O exception reading XML document");
 } catch (SAXException e) {
   System.err.println("XML exception reading document.");
 }</span> </pre>
<p> <span>实施者是免费（并被鼓励）发明自己的功能，使用自己的URI建立的名称。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 功能名称，它是一个完全限定的URI。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             特征的当前值（true或false）。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../org/xml/sax/SAXNotRecognizedException.html" title="class in org.xml.sax">SAXNotRecognizedException</a></code> - 如果功能值无法分配或检索。 
           </dd>
<dd>
<code><a href="../../../org/xml/sax/SAXNotSupportedException.html" title="class in org.xml.sax">SAXNotSupportedException</a></code> - 当XMLReader识别功能名称，但此时无法确定其值。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../org/xml/sax/XMLReader.html#setFeature-java.lang.String-boolean-"><code>setFeature(java.lang.String, boolean)</code></a>
</dd>
</dl> </li>
</ul> <a name="setFeature-java.lang.String-boolean-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setFeature</h4> <pre>void setFeature(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name,
                boolean value)
         throws <a href="../../../org/xml/sax/SAXNotRecognizedException.html" title="class in org.xml.sax">SAXNotRecognizedException</a>,
                <a href="../../../org/xml/sax/SAXNotSupportedException.html" title="class in org.xml.sax">SAXNotSupportedException</a></pre>
<div class="block">
<span>设置特征标志的值。</span>
<p> <span>功能名称是任何完全限定的URI。</span> <span>XMLReader可能会显示一个特征值，但是无法更改当前值。</span> <span>一些特征值可能只在特定的上下文中是不可变的或可变的，例如解析之前，期间或之后。</span> </p>
<p> <span>所有XMLReaders都需要支持将http://xml.org/sax/features/namespaces设置为true，将http://xml.org/sax/features/namespace-prefixes设置为false。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 功能名称，它是一个完全限定的URI。 
           </dd>
<dd>
<code>value</code> - 要素的值（true或false）。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../org/xml/sax/SAXNotRecognizedException.html" title="class in org.xml.sax">SAXNotRecognizedException</a></code> - 如果无法分配或检索到特征值。 
           </dd>
<dd>
<code><a href="../../../org/xml/sax/SAXNotSupportedException.html" title="class in org.xml.sax">SAXNotSupportedException</a></code> - 当XMLReader识别功能名称但无法设置请求的值时。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../org/xml/sax/XMLReader.html#getFeature-java.lang.String-"><code>getFeature(java.lang.String)</code></a>
</dd>
</dl> </li>
</ul> <a name="getProperty-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getProperty</h4> <pre><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> getProperty(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)
            throws <a href="../../../org/xml/sax/SAXNotRecognizedException.html" title="class in org.xml.sax">SAXNotRecognizedException</a>,
                   <a href="../../../org/xml/sax/SAXNotSupportedException.html" title="class in org.xml.sax">SAXNotSupportedException</a></pre>
<div class="block">
<span>查找属性的值。</span>
<p> <span>属性名称是任何完全限定的URI。</span> <span>XMLReader可以识别属性名称，但暂时无法返回其值。</span> <span>某些属性值可能仅在特定上下文中可用，例如解析之前，之中或之后。</span> </p>
<p> <span>不需要XMLReaders来识别任何特定的属性名称，尽管SAX2记录了一个初始的核心集。</span> </p>
<p> <span>实施者是免费的（并被鼓励）发明自己的属性，使用自己的URI建立的名称。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 属性名称，它是一个完全限定的URI。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             当前的属性值。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../org/xml/sax/SAXNotRecognizedException.html" title="class in org.xml.sax">SAXNotRecognizedException</a></code> - 如果属性值无法分配或检索。 
           </dd>
<dd>
<code><a href="../../../org/xml/sax/SAXNotSupportedException.html" title="class in org.xml.sax">SAXNotSupportedException</a></code> - 当XMLReader识别属性名称，但此时不能确定其值。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../org/xml/sax/XMLReader.html#setProperty-java.lang.String-java.lang.Object-"><code>setProperty(java.lang.String, java.lang.Object)</code></a>
</dd>
</dl> </li>
</ul> <a name="setProperty-java.lang.String-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setProperty</h4> <pre>void setProperty(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name,
                 <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> value)
          throws <a href="../../../org/xml/sax/SAXNotRecognizedException.html" title="class in org.xml.sax">SAXNotRecognizedException</a>,
                 <a href="../../../org/xml/sax/SAXNotSupportedException.html" title="class in org.xml.sax">SAXNotSupportedException</a></pre>
<div class="block">
<span>设置属性的值。</span>
<p> <span>属性名称是任何完全限定的URI。</span> <span>XMLReader可以识别属性名称，但无法更改当前值。</span> <span>一些属性值可能只在特定的上下文中是不可变的或可变的，例如在解析之前，期间或之后。</span> </p>
<p> <span>不需要XMLReaders来识别设置任何特定的属性名称，尽管核心集由SAX2定义。</span> </p>
<p> <span>此方法也是设置扩展处理程序的标准机制。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 属性名称，它是一个完全限定的URI。 
           </dd>
<dd>
<code>value</code> - 该属性的请求值。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../org/xml/sax/SAXNotRecognizedException.html" title="class in org.xml.sax">SAXNotRecognizedException</a></code> - 如果不能分配或检索属性值。 
           </dd>
<dd>
<code><a href="../../../org/xml/sax/SAXNotSupportedException.html" title="class in org.xml.sax">SAXNotSupportedException</a></code> - 当XMLReader识别属性名称但无法设置请求的值时。 
           </dd>
</dl> </li>
</ul> <a name="setEntityResolver-org.xml.sax.EntityResolver-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setEntityResolver</h4> <pre>void setEntityResolver(<a href="../../../org/xml/sax/EntityResolver.html" title="interface in org.xml.sax">EntityResolver</a> resolver)</pre>
<div class="block">
<span>允许应用程序注册一个实体解析器。</span>
<p> <span>如果应用程序没有注册实体解析器，则XMLReader将执行自己的默认分辨率。</span> </p>
<p> <span>应用程序可以在解析过程中注册一个新的或不同的解析器，SAX解析器必须立即开始使用新的解析器。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>resolver</code> - 实体解析器。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../org/xml/sax/XMLReader.html#getEntityResolver--"><code>getEntityResolver()</code></a>
</dd>
</dl> </li>
</ul> <a name="getEntityResolver--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getEntityResolver</h4> <pre><a href="../../../org/xml/sax/EntityResolver.html" title="interface in org.xml.sax">EntityResolver</a> getEntityResolver()</pre>
<div class="block">
            返回当前的实体解析器。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             当前实体解析器，如果没有注册，则为null。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../org/xml/sax/XMLReader.html#setEntityResolver-org.xml.sax.EntityResolver-"><code>setEntityResolver(org.xml.sax.EntityResolver)</code></a>
</dd>
</dl> </li>
</ul> <a name="setDTDHandler-org.xml.sax.DTDHandler-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setDTDHandler</h4> <pre>void setDTDHandler(<a href="../../../org/xml/sax/DTDHandler.html" title="interface in org.xml.sax">DTDHandler</a> handler)</pre>
<div class="block">
<span>允许应用程序注册DTD事件处理程序。</span>
<p> <span>如果应用程序没有注册DTD处理程序，则SAX解析器报告的所有DTD事件将被默认忽略。</span> </p>
<p> <span>应用程序可以在解析过程中注册一个新的或不同的处理程序，SAX解析器必须立即开始使用新的处理程序。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>handler</code> - DTD处理程序。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../org/xml/sax/XMLReader.html#getDTDHandler--"><code>getDTDHandler()</code></a>
</dd>
</dl> </li>
</ul> <a name="getDTDHandler--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getDTDHandler</h4> <pre><a href="../../../org/xml/sax/DTDHandler.html" title="interface in org.xml.sax">DTDHandler</a> getDTDHandler()</pre>
<div class="block">
            返回当前的DTD处理程序。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             当前的DTD处理程序，如果没有注册，则为null。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../org/xml/sax/XMLReader.html#setDTDHandler-org.xml.sax.DTDHandler-"><code>setDTDHandler(org.xml.sax.DTDHandler)</code></a>
</dd>
</dl> </li>
</ul> <a name="setContentHandler-org.xml.sax.ContentHandler-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setContentHandler</h4> <pre>void setContentHandler(<a href="../../../org/xml/sax/ContentHandler.html" title="interface in org.xml.sax">ContentHandler</a> handler)</pre>
<div class="block">
<span>允许应用程序注册内容事件处理程序。</span>
<p> <span>如果应用程序没有注册内容处理程序，SAX解析器报告的所有内容事件将被默认忽略。</span> </p>
<p> <span>应用程序可以在解析过程中注册一个新的或不同的处理程序，SAX解析器必须立即开始使用新的处理程序。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>handler</code> - 内容处理程序。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../org/xml/sax/XMLReader.html#getContentHandler--"><code>getContentHandler()</code></a>
</dd>
</dl> </li>
</ul> <a name="getContentHandler--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getContentHandler</h4> <pre><a href="../../../org/xml/sax/ContentHandler.html" title="interface in org.xml.sax">ContentHandler</a> getContentHandler()</pre>
<div class="block">
            返回当前内容处理程序。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             当前内容处理程序，如果没有注册，则为null。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../org/xml/sax/XMLReader.html#setContentHandler-org.xml.sax.ContentHandler-"><code>setContentHandler(org.xml.sax.ContentHandler)</code></a>
</dd>
</dl> </li>
</ul> <a name="setErrorHandler-org.xml.sax.ErrorHandler-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setErrorHandler</h4> <pre>void setErrorHandler(<a href="../../../org/xml/sax/ErrorHandler.html" title="interface in org.xml.sax">ErrorHandler</a> handler)</pre>
<div class="block">
<span>允许应用程序注册错误事件处理程序。</span>
<p> <span>如果应用程序没有注册错误处理程序，SAX解析器报告的所有错误事件将被默认忽略;</span> <span>然而，正常处理可能不会继续。</span> <span>强烈建议所有SAX应用程序实施一个错误处理程序，以避免意外的错误。</span> </p>
<p> <span>应用程序可以在解析过程中注册一个新的或不同的处理程序，SAX解析器必须立即开始使用新的处理程序。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>handler</code> - 错误处理程序。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../org/xml/sax/XMLReader.html#getErrorHandler--"><code>getErrorHandler()</code></a>
</dd>
</dl> </li>
</ul> <a name="getErrorHandler--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getErrorHandler</h4> <pre><a href="../../../org/xml/sax/ErrorHandler.html" title="interface in org.xml.sax">ErrorHandler</a> getErrorHandler()</pre>
<div class="block">
            返回当前的错误处理程序。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             当前错误处理程序，如果没有注册，则为null。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../org/xml/sax/XMLReader.html#setErrorHandler-org.xml.sax.ErrorHandler-"><code>setErrorHandler(org.xml.sax.ErrorHandler)</code></a>
</dd>
</dl> </li>
</ul> <a name="parse-org.xml.sax.InputSource-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>parse</h4> <pre>void parse(<a href="../../../org/xml/sax/InputSource.html" title="class in org.xml.sax">InputSource</a> input)
    throws <a href="../../../java/io/IOException.html" title="class in java.io">IOException</a>,
           <a href="../../../org/xml/sax/SAXException.html" title="class in org.xml.sax">SAXException</a></pre>
<div class="block">
<span>解析一个XML文档。</span>
<p> <span>应用程序可以使用此方法指示XML阅读器从任何有效的输入源（字符流，字节流或URI）开始解析XML文档。</span> </p>
<p> <span>解析过程中应用程序可能无法调用此方法（应为每个嵌套XML文档创建新的XMLReader）。</span> <span>一旦解析完成，应用程序可以重用相同的XMLReader对象，可能使用不同的输入源。</span> <span>完成解析后，XMLReader对象（例如为特征标志和属性建立的处理程序绑定和值）的配置不会改变，除非该配置的该方面的定义明确指定其他行为。</span> <span>（例如，显示要解析的文档的特征的要素标志或属性。）</span> </p>
<p> <span>在解析过程中，XMLReader将通过注册的事件处理程序提供有关XML文档的信息。</span> </p>
<p> <span>此方法是同步的：它将不会返回，直到解析结束。</span> <span>如果客户端应用程序想要尽早终止解析，则应该抛出异常。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>input</code> - XML文档顶层的输入源。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../org/xml/sax/SAXException.html" title="class in org.xml.sax">SAXException</a></code> - 任何SAX异常，可能包装另一个异常。 
           </dd>
<dd>
<code><a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 解析器的IO异常，可能来自应用程序提供的字节流或字符流。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../org/xml/sax/InputSource.html" title="在org.xml.sax中的类"><code>InputSource</code></a> ， <a href="../../../org/xml/sax/XMLReader.html#parse-java.lang.String-"><code>parse(java.lang.String)</code></a> ， <a href="../../../org/xml/sax/XMLReader.html#setEntityResolver-org.xml.sax.EntityResolver-"><code>setEntityResolver(org.xml.sax.EntityResolver)</code></a> ， <a href="../../../org/xml/sax/XMLReader.html#setDTDHandler-org.xml.sax.DTDHandler-"><code>setDTDHandler(org.xml.sax.DTDHandler)</code></a> ， <a href="../../../org/xml/sax/XMLReader.html#setContentHandler-org.xml.sax.ContentHandler-"><code>setContentHandler(org.xml.sax.ContentHandler)</code></a> ， <a href="../../../org/xml/sax/XMLReader.html#setErrorHandler-org.xml.sax.ErrorHandler-"><code>setErrorHandler(org.xml.sax.ErrorHandler)</code></a></span>
</dd>
</dl> </li>
</ul> <a name="parse-java.lang.String-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>parse</h4> <pre>void parse(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> systemId)
    throws <a href="../../../java/io/IOException.html" title="class in java.io">IOException</a>,
           <a href="../../../org/xml/sax/SAXException.html" title="class in org.xml.sax">SAXException</a></pre>
<div class="block">
<span>从系统标识符（URI）解析XML文档。</span>
<p> <span>此方法是从系统标识符读取文档的常见情况的快捷方式。</span> <span>它完全相当于以下内容：</span> </p>
<pre>  <span>parse(new InputSource(systemId));</span> </pre>
<p> <span>如果系统标识符是URL，则应用程序在将其传递给解析器之前必须完全解析。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>systemId</code> - 系统标识符（URI）。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../org/xml/sax/SAXException.html" title="class in org.xml.sax">SAXException</a></code> - 任何SAX异常，可能包含另一个异常。 
           </dd>
<dd>
<code><a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 解析器的IO异常，可能来自应用程序提供的字节流或字符流。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../org/xml/sax/XMLReader.html#parse-org.xml.sax.InputSource-"><code>parse(org.xml.sax.InputSource)</code></a>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>