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

<div class="header">
<div class="subTitle">
     compact2, compact3 
   </div>
<div class="subTitle">
     org.xml.sax 
   </div>
<h2 class="title" title="Interface Parser">Interface Parser</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
        所有已知实现类：
       </dt>
<dd>
<span><a href="../../../org/xml/sax/helpers/XMLReaderAdapter.html" title="org.xml.sax.helpers中的类">XMLReaderAdapter</a></span>
</dd>
</dl>
<hr/>
<div class="block">
<span><span class="deprecatedLabel">已弃用</span></span>
<div class="block">
<span><span class="deprecationComment">该接口已被SAX2 <a href="../../../org/xml/sax/XMLReader.html" title="org.xml.sax中的接口"><code>XMLReader</code></a>接口所取代，其中包括命名空间支持。</span></span>
</div>
</div> <br/> <pre>public interface <span class="typeNameLabel">Parser</span></pre>
<div class="block">
<span>SAX（Simple API for 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>这是SAX1的主要事件供应商界面;</span> <span>它已被SAX2替换为<a href="../../../org/xml/sax/XMLReader.html" title="org.xml.sax中的接口"><code>XMLReader</code></a> ，其中包括命名空间支持和复杂的可配置性和可扩展性。</span> </p>
<p> <span>所有SAX1解析器都必须实现此基本界面：它允许应用程序注册不同类型事件的处理程序，并从URI或字符流启动解析。</span> </p>
<p> <span>所有SAX1解析器还必须实现零参数构造函数（尽管也允许其他构造函数）。</span> </p>
<p> <span>SAX1解析器是可重复使用但不重入的：一旦第一个解析成功完成，应用程序可能重用一个解析器对象（可能有一个不同的输入源），但它可能不会在解析中递归地调用parse（）方法。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
         SAX 1.0 
       </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../org/xml/sax/EntityResolver.html" title="org.xml.sax中的接口"><code>EntityResolver</code></a> ， <a href="../../../org/xml/sax/DTDHandler.html" title="org.xml.sax中的接口"><code>DTDHandler</code></a> ， <a href="../../../org/xml/sax/DocumentHandler.html" title="org.xml.sax中的接口"><code>DocumentHandler</code></a> ， <a href="../../../org/xml/sax/ErrorHandler.html" title="org.xml.sax中的接口"><code>ErrorHandler</code></a> ， <a href="../../../org/xml/sax/HandlerBase.html" title="在org.xml.sax中的类"><code>HandlerBase</code></a> ， <a href="../../../org/xml/sax/InputSource.html" title="在org.xml.sax中的类"><code>InputSource</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>
<span class="tableTab" id="t6"><span><a href="javascript:show(32);">弃用的方法</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>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/Parser.html#parse-org.xml.sax.InputSource-">parse</a></span>(<a href="../../../org/xml/sax/InputSource.html" title="class in org.xml.sax">InputSource</a> source)</code>
<div class="block">
<span class="deprecatedLabel">已弃用</span>
</div>
<div class="block">
              解析一个XML文档。 
            </div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/Parser.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">
<span class="deprecatedLabel">已弃用</span>
</div>
<div class="block">
              从系统标识符（URI）解析XML文档。 
            </div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/Parser.html#setDocumentHandler-org.xml.sax.DocumentHandler-">setDocumentHandler</a></span>(<a href="../../../org/xml/sax/DocumentHandler.html" title="interface in org.xml.sax">DocumentHandler</a> handler)</code>
<div class="block">
<span class="deprecatedLabel">已弃用</span>
</div>
<div class="block">
              允许应用程序注册文档事件处理程序。 
            </div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/Parser.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">
<span class="deprecatedLabel">已弃用</span>
</div>
<div class="block">
              允许应用程序注册DTD事件处理程序。 
            </div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/Parser.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">
<span class="deprecatedLabel">已弃用</span>
</div>
<div class="block">
              允许应用程序注册自定义实体解析器。 
            </div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/Parser.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">
<span class="deprecatedLabel">已弃用</span>
</div>
<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/Parser.html#setLocale-java.util.Locale-">setLocale</a></span>(<a href="../../../java/util/Locale.html" title="class in java.util">Locale</a> locale)</code>
<div class="block">
<span class="deprecatedLabel">已弃用</span>
</div>
<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="setLocale-java.util.Locale-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setLocale</h4> <pre>void setLocale(<a href="../../../java/util/Locale.html" title="class in java.util">Locale</a> locale)
        throws <a href="../../../org/xml/sax/SAXException.html" title="class in org.xml.sax">SAXException</a></pre>
<div class="block">
<span class="deprecatedLabel">已弃用</span>
</div>
<div class="block">
<span>允许应用程序请求区域设置错误和警告。</span>
<p> <span>SAX解析器不需要为错误和警告提供本地化;</span> <span>但是，如果他们无法支持所请求的区域设置，则必须抛出SAX异常。</span> <span>应用程序可能不会在解析过程中请求区域设置更改。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>locale</code> - Java Locale对象。 
           </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> - 如果不支持请求的区域设置，则抛出异常（使用上一个或默认的区域设置）。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../org/xml/sax/SAXException.html" title="在org.xml.sax中的类"><code>SAXException</code></a> ， <a href="../../../org/xml/sax/SAXParseException.html" title="在org.xml.sax中的类"><code>SAXParseException</code></a></span>
</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 class="deprecatedLabel">已弃用</span>
</div>
<div class="block">
<span>允许应用程序注册自定义实体解析器。</span>
<p> <span>如果应用程序没有注册实体解析器，则SAX解析器将解析系统标识符并打开与实体本身的连接（这是HandlerBase中实现的默认行为）。</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>
<span><a href="../../../org/xml/sax/EntityResolver.html" title="org.xml.sax中的接口"><code>EntityResolver</code></a> ， <a href="../../../org/xml/sax/HandlerBase.html" title="在org.xml.sax中的类"><code>HandlerBase</code></a></span>
</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 class="deprecatedLabel">已弃用</span>
</div>
<div class="block">
<span>允许应用程序注册DTD事件处理程序。</span>
<p> <span>如果应用程序没有注册DTD处理程序，SAX解析器报告的所有DTD事件将被默认忽略（这是由HandlerBase实现的默认行为）。</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>
<span><a href="../../../org/xml/sax/DTDHandler.html" title="org.xml.sax中的接口"><code>DTDHandler</code></a> ， <a href="../../../org/xml/sax/HandlerBase.html" title="在org.xml.sax中的类"><code>HandlerBase</code></a></span>
</dd>
</dl> </li>
</ul> <a name="setDocumentHandler-org.xml.sax.DocumentHandler-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setDocumentHandler</h4> <pre>void setDocumentHandler(<a href="../../../org/xml/sax/DocumentHandler.html" title="interface in org.xml.sax">DocumentHandler</a> handler)</pre>
<div class="block">
<span class="deprecatedLabel">已弃用</span>
</div>
<div class="block">
<span>允许应用程序注册文档事件处理程序。</span>
<p> <span>如果应用程序没有注册文档处理程序，SAX解析器报告的所有文档事件将被默认忽略（这是由HandlerBase实现的默认行为）。</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>
<span><a href="../../../org/xml/sax/DocumentHandler.html" title="org.xml.sax中的接口"><code>DocumentHandler</code></a> ， <a href="../../../org/xml/sax/HandlerBase.html" title="在org.xml.sax中的类"><code>HandlerBase</code></a></span>
</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 class="deprecatedLabel">已弃用</span>
</div>
<div class="block">
<span>允许应用程序注册错误事件处理程序。</span>
<p> <span>如果应用程序没有注册错误事件处理程序，SAX解析器报告的所有错误事件将被默认忽略，除了fatalError，这将抛出一个SAXException（这是由HandlerBase实现的默认行为）。</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>
<span><a href="../../../org/xml/sax/ErrorHandler.html" title="org.xml.sax中的接口"><code>ErrorHandler</code></a> ， <a href="../../../org/xml/sax/SAXException.html" title="在org.xml.sax中的类"><code>SAXException</code></a> ， <a href="../../../org/xml/sax/HandlerBase.html" title="在org.xml.sax中的类"><code>HandlerBase</code></a></span>
</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> source)
    throws <a href="../../../org/xml/sax/SAXException.html" title="class in org.xml.sax">SAXException</a>,
           <a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span class="deprecatedLabel">已弃用</span>
</div>
<div class="block">
<span>解析一个XML文档。</span>
<p> <span>应用程序可以使用此方法指示SAX解析器从任何有效的输入源（字符流，字节流或URI）开始解析XML文档。</span> </p>
<p> <span>解析过程中应用程序可能无法调用此方法（它们应该为每个附加的XML文档创建一个新的Parser）。</span> <span>一旦解析完成，应用程序可能重用相同的Parser对象，可能使用不同的输入源。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>source</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/Parser.html#parse-java.lang.String-"><code>parse(java.lang.String)</code></a> ， <a href="../../../org/xml/sax/Parser.html#setEntityResolver-org.xml.sax.EntityResolver-"><code>setEntityResolver(org.xml.sax.EntityResolver)</code></a> ， <a href="../../../org/xml/sax/Parser.html#setDTDHandler-org.xml.sax.DTDHandler-"><code>setDTDHandler(org.xml.sax.DTDHandler)</code></a> ， <a href="../../../org/xml/sax/Parser.html#setDocumentHandler-org.xml.sax.DocumentHandler-"><code>setDocumentHandler(org.xml.sax.DocumentHandler)</code></a> ， <a href="../../../org/xml/sax/Parser.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="../../../org/xml/sax/SAXException.html" title="class in org.xml.sax">SAXException</a>,
           <a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span class="deprecatedLabel">已弃用</span>
</div>
<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/Parser.html#parse-org.xml.sax.InputSource-"><code>parse(org.xml.sax.InputSource)</code></a>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>