uTools-Manuals/docs/java/org/xml/sax/ext/DeclHandler.html

<div class="header">
<div class="subTitle">
     compact2, compact3 
   </div>
<div class="subTitle">
     org.xml.sax.ext 
   </div>
<h2 class="title" title="Interface DeclHandler">Interface DeclHandler</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
        所有已知实现类：
       </dt>
<dd>
<span><a href="../../../../org/xml/sax/ext/DefaultHandler2.html" title="org.xml.sax.ext中的类">DefaultHandler2</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">DeclHandler</span></pre>
<div class="block">
<span>用于DTD声明事件的SAX2扩展处理程序。</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>这是SAX2的可选扩展处理程序，可以在XML文档中提供有关DTD声明的更完整的信息。</span> <span>XML读取器不需要识别此处理程序，它不是仅核心的SAX2发行版的一部分。</span> </p>
<p> <span>请注意，数据相关的DTD声明（未解析的实体和符号）已通过<a href="../../../../org/xml/sax/DTDHandler.html" title="org.xml.sax中的接口"><code>DTDHandler</code></a>界面报告。</span> </p>
<p> <span>如果您使用声明处理程序和词法处理程序，则所有事件将发生在<a href="../../../../org/xml/sax/ext/LexicalHandler.html#startDTD-java.lang.String-java.lang.String-java.lang.String-"><code>startDTD</code></a>和<a href="../../../../org/xml/sax/ext/LexicalHandler.html#endDTD--"><code>endDTD</code></a>事件之间。</span> </p>
<p> <span>要为XML读取器设置DeclHandler，请使用属性名称为<code>http://xml.org/sax/properties/declaration-handler</code>的<a href="../../../../org/xml/sax/XMLReader.html#setProperty-java.lang.String-java.lang.Object-"><code>setProperty</code></a>方法和实现此接口（或null）的对象作为值。</span> <span>如果读者没有报告声明事件，当您尝试注册处理程序时，它将抛出一个<a href="../../../../org/xml/sax/SAXNotRecognizedException.html" title="在org.xml.sax中的类"><code>SAXNotRecognizedException</code></a> 。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
         SAX 2.0（扩展1.0） 
       </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/ext/DeclHandler.html#attributeDecl-java.lang.String-java.lang.String-java.lang.String-java.lang.String-java.lang.String-">attributeDecl</a></span>(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> eName, <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> aName, <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> type, <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> mode, <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> value)</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/ext/DeclHandler.html#elementDecl-java.lang.String-java.lang.String-">elementDecl</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> model)</code>
<div class="block">
              报告元素类型声明。 
            </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/ext/DeclHandler.html#externalEntityDecl-java.lang.String-java.lang.String-java.lang.String-">externalEntityDecl</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="i3">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/xml/sax/ext/DeclHandler.html#internalEntityDecl-java.lang.String-java.lang.String-">internalEntityDecl</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> 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="elementDecl-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>elementDecl</h4> <pre>void elementDecl(<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> model)
          throws <a href="../../../../org/xml/sax/SAXException.html" title="class in org.xml.sax">SAXException</a></pre>
<div class="block">
<span>报告元素类型声明。</span>
<p> <span>内容模型将由字符串“EMPTY”，字符串“ANY”或括号组组成，可选地后跟出现指示符。</span> <span>模型将被归一化，以便所有参数实体完全解析，并且所有空格都被删除，并且将包括括号。</span> <span>其他规范化（如删除冗余括号或简化事件指标）由解析器自行决定。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 元素类型名称。 
           </dd>
<dd>
<code>model</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> - 应用程序可能会引发异常。 
           </dd>
</dl> </li>
</ul> <a name="attributeDecl-java.lang.String-java.lang.String-java.lang.String-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>attributeDecl</h4> <pre>void attributeDecl(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> eName,
                   <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> aName,
                   <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> type,
                   <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> mode,
                   <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> value)
            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>该类型将是字符串“CDATA”，“ID”，“IDREF”，“IDREFS”，“NMTOKEN”，“NMTOKENS”，“ENTITY”，“ENTITIES”，带有分隔符“|”的括号符号组</span> <span>并删除所有空格，或者单词“NOTATION”后跟一个空格，后跟一个带有所有空格的括号符号组。</span> </p>
<p> <span>该值将是应用程序报告的值，适当地规范化，扩展了实体和字符引用。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>eName</code> - 关联元素的名称。 
           </dd>
<dd>
<code>aName</code> - 属性的名称。 
           </dd>
<dd>
<code>type</code> - 表示属性类型的字符串。 
           </dd>
<dd>
<code>mode</code> - 表示属性默认模式（“#IMPLIED”，“#REQUIRED”或“#FIXED”）的字符串，如果不适用，则为空。 
           </dd>
<dd>
<code>value</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> - 应用程序可能引发异常。 
           </dd>
</dl> </li>
</ul> <a name="internalEntityDecl-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>internalEntityDecl</h4> <pre>void internalEntityDecl(<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> value)
                 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>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>name</code> - 实体的名称。</span>
<span>如果是参数实体，则名称将以'％'开头。</span>
</dd>
<dd>
<code>value</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> - 应用程序可能引发异常。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../org/xml/sax/ext/DeclHandler.html#externalEntityDecl-java.lang.String-java.lang.String-java.lang.String-"><code>externalEntityDecl(java.lang.String, java.lang.String, java.lang.String)</code></a> ， 
            <a href="../../../../org/xml/sax/DTDHandler.html#unparsedEntityDecl-java.lang.String-java.lang.String-java.lang.String-java.lang.String-"><code>DTDHandler.unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String)</code></a>
</dd>
</dl> </li>
</ul> <a name="externalEntityDecl-java.lang.String-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>externalEntityDecl</h4> <pre>void externalEntityDecl(<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> </p>
<p> <span>如果系统标识符是URL，解析器必须在将其传递给应用程序之前将其完全解析。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>name</code> - 实体的名称。</span>
<span>如果是参数实体，则名称将以'％'开头。</span>
</dd>
<dd>
<code>publicId</code> - 实体的公共标识符，如果没有给定，则为null。 
           </dd>
<dd>
<code>systemId</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> - 应用程序可能会引发异常。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../org/xml/sax/ext/DeclHandler.html#internalEntityDecl-java.lang.String-java.lang.String-"><code>internalEntityDecl(java.lang.String, java.lang.String)</code></a> ， 
            <a href="../../../../org/xml/sax/DTDHandler.html#unparsedEntityDecl-java.lang.String-java.lang.String-java.lang.String-java.lang.String-"><code>DTDHandler.unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String)</code></a>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>