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

344 lines
14 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 AttributeList">Interface AttributeList</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/AttributeListImpl.html" title="org.xml.sax.helpers中的类">AttributeListImpl</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/Attributes.html" title="org.xml.sax中的接口"><code>Attributes</code></a>接口所取代,其中包括命名空间支持。</span></span>
</div>
</div> <br/> <pre>public interface <span class="typeNameLabel">AttributeList</span></pre>
<div class="block">
<span>元素属性规范的界面。</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>与新的<a href="../../../org/xml/sax/Attributes.html" title="org.xml.sax中的接口"><code>Attributes</code></a>接口不同,它不支持与命名空间相关的信息。</span> </p>
<p> <span>当属性列表作为<a href="../../../org/xml/sax/DocumentHandler.html#startElement-java.lang.String-org.xml.sax.AttributeList-"><code>startElement</code></a>事件的一部分提供时,列表将仅在事件范围内返回有效结果;</span> <span>一旦事件处理程序将控制权返回给解析器,则属性列表无效。</span> <span>要保存属性列表的永久性副本请使用SAX1 <a href="../../../org/xml/sax/helpers/AttributeListImpl.html" title="org.xml.sax.helpers中的类"><code>AttributeListImpl</code></a>帮助器类。</span> </p>
<p> <span>属性列表仅包括已指定或默认的属性:将不包括#IMPLIED属性。</span> </p>
<p> <span>SAX应用程序有两种方式从AttributeList获取信息。</span> <span>首先,它可以遍历整个列表:</span> </p>
<pre> <span>public void startElement (String name, AttributeList atts) {
for (int i = 0; i &lt; atts.getLength(); i++) {
String name = atts.getName(i);
String type = atts.getType(i);
String value = atts.getValue(i);
[...]
}
}</span> </pre>
<p> <span>注意如果没有属性getLength的结果将为零</span> </p>
<p> <span>作为替代方案,应用程序可以请求特定属性的值或类型:</span> </p>
<pre> <span>public void startElement (String name, AttributeList atts) {
String identifier = atts.getValue("id");
String label = atts.getValue("label");
[...]
}</span> </pre>
</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/DocumentHandler.html#startElement-java.lang.String-org.xml.sax.AttributeList-"><code>startElement</code></a> <a href="../../../org/xml/sax/helpers/AttributeListImpl.html" title="org.xml.sax.helpers中的类"><code>AttributeListImpl</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>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/AttributeList.html#getLength--">getLength</a></span>()</code>
<div class="block">
<span class="deprecatedLabel">已弃用</span>
</div>
<div class="block">
返回此列表中的属性数。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/AttributeList.html#getName-int-">getName</a></span>(int i)</code>
<div class="block">
<span class="deprecatedLabel">已弃用</span>
</div>
<div class="block">
返回此列表中的属性名称(按位置)。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/AttributeList.html#getType-int-">getType</a></span>(int i)</code>
<div class="block">
<span class="deprecatedLabel">已弃用</span>
</div>
<div class="block">
返回列表中的属性类型(按位置)。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/AttributeList.html#getType-java.lang.String-">getType</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</code>
<div class="block">
<span class="deprecatedLabel">已弃用</span>
</div>
<div class="block">
返回列表中的属性类型(按名称)。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/AttributeList.html#getValue-int-">getValue</a></span>(int i)</code>
<div class="block">
<span class="deprecatedLabel">已弃用</span>
</div>
<div class="block">
返回列表中的属性值(按位置)。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/AttributeList.html#getValue-java.lang.String-">getValue</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</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="getLength--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getLength</h4> <pre>int getLength()</pre>
<div class="block">
<span class="deprecatedLabel">已弃用</span>
</div>
<div class="block">
<span>返回此列表中的属性数。</span>
<p> <span>SAX解析器可以以任意的顺序提供属性而不管它们被声明或指定的顺序。</span> <span>属性的数量可以为零。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
列表中的属性数。
</dd>
</dl> </li>
</ul> <a name="getName-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getName</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getName(int i)</pre>
<div class="block">
<span class="deprecatedLabel">已弃用</span>
</div>
<div class="block">
<span>返回此列表中的属性名称(按位置)。</span>
<p> <span>名称必须是唯一的SAX解析器不得包含相同的属性两次。</span> <span>没有值的属性(在起始标记中没有指定值的那些声明为#IMPLIED的将从列表中省略。</span> </p>
<p> <span>如果属性名称具有命名空间前缀,则仍将附加前缀。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>i</code> - 列表中属性的索引从0开始
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
索引属性的名称如果索引超出范围则为null。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../org/xml/sax/AttributeList.html#getLength--"><code>getLength()</code></a>
</dd>
</dl> </li>
</ul> <a name="getType-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getType</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getType(int i)</pre>
<div class="block">
<span class="deprecatedLabel">已弃用</span>
</div>
<div class="block">
<span>返回列表中的属性类型(按位置)。</span>
<p> <span>属性类型是字符串“CDATA”“ID”“IDREF”“IDREFS”“NMTOKEN”“NMTOKENS”“ENTITY”“ENTITIES”或“符号”总是大写</span> </p>
<p> <span>如果解析器没有读取该属性的声明或者解析器不报告属性类型那么它必须返回值为“CDATA”如XML 1.0重新规定第3.3.3节“属性值归一化” )。</span> </p>
<p> <span>对于不是符号的枚举属性解析器将将类型报告为“NMTOKEN”。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>i</code> - 列表中属性的索引从0开始
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
属性类型为字符串如果索引超出范围则为null。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../org/xml/sax/AttributeList.html#getLength--"><code>getLength()</code></a>
<a href="../../../org/xml/sax/AttributeList.html#getType-java.lang.String-"><code>getType(java.lang.String)</code></a>
</dd>
</dl> </li>
</ul> <a name="getValue-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getValue</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getValue(int i)</pre>
<div class="block">
<span class="deprecatedLabel">已弃用</span>
</div>
<div class="block">
<span>返回列表中的属性值(按位置)。</span>
<p> <span>如果属性值是令牌列表IDREFSENTITIES或NMTOKENS令牌将被连接成一个由空格分隔的单个字符串。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>i</code> - 列表中属性的索引从0开始
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
属性值作为字符串如果索引超出范围则为null。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../org/xml/sax/AttributeList.html#getLength--"><code>getLength()</code></a>
<a href="../../../org/xml/sax/AttributeList.html#getValue-java.lang.String-"><code>getValue(java.lang.String)</code></a>
</dd>
</dl> </li>
</ul> <a name="getType-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getType</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getType(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</pre>
<div class="block">
<span class="deprecatedLabel">已弃用</span>
</div>
<div class="block">
<span>返回列表中的属性类型(按名称)。</span>
<p> <span>返回值与getTypeint的返回值相同。</span> </p>
<p> <span>如果属性名称在文档中具有命名空间前缀,则应用程序必须在此处包含前缀。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 属性的名称。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
属性类型为字符串如果不存在此属性则为null。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../org/xml/sax/AttributeList.html#getType-int-"><code>getType(int)</code></a>
</dd>
</dl> </li>
</ul> <a name="getValue-java.lang.String-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getValue</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getValue(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</pre>
<div class="block">
<span class="deprecatedLabel">已弃用</span>
</div>
<div class="block">
<span>返回列表中的属性值(按名称)。</span>
<p> <span>返回值与getValueint的返回值相同。</span> </p>
<p> <span>如果属性名称在文档中具有命名空间前缀,则应用程序必须在此处包含前缀。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要返回的属性的名称
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
属性值作为字符串如果不存在此属性则为null。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../org/xml/sax/AttributeList.html#getValue-int-"><code>getValue(int)</code></a>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>