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

184 lines
10 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
compact2, compact3
</div>
<div class="subTitle">
org.xml.sax
</div>
<h2 class="title" title="Interface DTDHandler">Interface DTDHandler</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Known Subinterfaces:
</dt>
<dd>
<span><a href="../../../javax/xml/transform/sax/TransformerHandler.html" title="javax.xml.transform.sax中的接口">TransformerHandler</a></span>
</dd>
</dl>
<dl>
<dt>
所有已知实现类:
</dt>
<dd>
<span><a href="../../../org/xml/sax/helpers/DefaultHandler.html" title="org.xml.sax.helpers中的类">DefaultHandler</a> <a href="../../../org/xml/sax/ext/DefaultHandler2.html" title="org.xml.sax.ext中的类">DefaultHandler2</a> <a href="../../../org/xml/sax/HandlerBase.html" title="在org.xml.sax中的类">HandlerBase</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">DTDHandler</span></pre>
<div class="block">
<span>接收基本DTD相关事件的通知。</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>如果SAX应用程序需要关于符号和未分析实体的信息那么应用程序将实现此接口并使用解析器的setDTDHandler方法向SAX解析器注册一个实例。</span> <span>解析器使用实例向应用程序报告符号和未解析的实体声明。</span> </p>
<p> <span>请注意此接口仅包括XML建议<em>要求</em>处理器报告的那些DTD事件符号和未解析的实体声明。</span> </p>
<p> <span>SAX解析器可以以任何顺序报告这些事件而不管声明和未解析实体的顺序如何;</span> <span>但是所有DTD事件必须在文档处理程序的startDocument事件之后和第一个startElement事件之前报告。</span> <span>(如果使用<a href="../../../org/xml/sax/ext/LexicalHandler.html" title="org.xml.sax.ext中的接口"><code>LexicalHandler</code></a> 这些事件也必须在endDTD事件之前报告。</span> </p>
<p> <span>存储信息以供将来使用(可能在哈希表或对象树中)由应用程序决定。</span> <span>如果应用程序遇到类型为“NOTATION”“ENTITY”或“ENTITIES”的属性则可以使用通过该界面获取的信息来查找与属性值对应的实体和/或符号。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
SAX 1.0
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../org/xml/sax/XMLReader.html#setDTDHandler-org.xml.sax.DTDHandler-"><code>XMLReader.setDTDHandler(org.xml.sax.DTDHandler)</code></a>
</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>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/DTDHandler.html#notationDecl-java.lang.String-java.lang.String-java.lang.String-">notationDecl</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> publicId, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> systemId)</code>
<div class="block">
接收符号声明事件的通知。
</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/DTDHandler.html#unparsedEntityDecl-java.lang.String-java.lang.String-java.lang.String-java.lang.String-">unparsedEntityDecl</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> publicId, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> systemId, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> notationName)</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="notationDecl-java.lang.String-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>notationDecl</h4> <pre>void notationDecl(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> publicId,
<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></pre>
<div class="block">
<span>接收符号声明事件的通知。</span>
<p> <span>如有必要,由申请记录符号供以后参考;</span> <span>符号可能显示为属性值和未分类的实体声明,并且有时用于处理指令目标名称。</span> </p>
<p> <span>publicId和systemId中的至少一个必须是非空值。</span> <span>如果存在系统标识符并且它是一个URL则SAX解析器必须在将其通过此事件传递给应用程序之前将其完全解析。</span> </p>
<p> <span>不能保证在使用它的任何未解析的实体之前报告符号声明。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 符号名称。
</dd>
<dd>
<code>publicId</code> - 符号的公共标识符如果没有给定则为null。
</dd>
<dd>
<code>systemId</code> - 符号的系统标识符如果没有给定则为null。
</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>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../../org/xml/sax/DTDHandler.html#unparsedEntityDecl-java.lang.String-java.lang.String-java.lang.String-java.lang.String-"><code>unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String)</code></a> <a href="../../../org/xml/sax/Attributes.html" title="org.xml.sax中的接口"><code>Attributes</code></a></span>
</dd>
</dl> </li>
</ul> <a name="unparsedEntityDecl-java.lang.String-java.lang.String-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>unparsedEntityDecl</h4> <pre>void unparsedEntityDecl(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> publicId,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> systemId,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> notationName)
throws <a href="../../../org/xml/sax/SAXException.html" title="class in org.xml.sax">SAXException</a></pre>
<div class="block">
<span>接收未解析的实体声明事件的通知。</span>
<p> <span>请注意,符号名称对应于<a href="../../../org/xml/sax/DTDHandler.html#notationDecl-java.lang.String-java.lang.String-java.lang.String-"><code>notationDecl</code></a>事件报告的符号。</span> <span>如有需要,由申请记录实体供以后参考;</span> <span>未解析的实体可能显示为属性值。</span> </p>
<p> <span>如果系统标识符是URL解析器必须在将其传递给应用程序之前将其完全解析。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 未分类实体的名称。
</dd>
<dd>
<code>publicId</code> - 实体的公共标识符如果没有给定则为null。
</dd>
<dd>
<code>systemId</code> - 实体的系统标识符。
</dd>
<dd>
<code>notationName</code> - 关联符号的名称。
</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>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../../org/xml/sax/DTDHandler.html#notationDecl-java.lang.String-java.lang.String-java.lang.String-"><code>notationDecl(java.lang.String, java.lang.String, java.lang.String)</code></a> <a href="../../../org/xml/sax/Attributes.html" title="org.xml.sax中的接口"><code>Attributes</code></a></span>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>