mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-07-06 09:02:49 +08:00
204 lines
10 KiB
HTML
204 lines
10 KiB
HTML
<div class="header">
|
||
<div class="subTitle">
|
||
compact3
|
||
</div>
|
||
<div class="subTitle">
|
||
javax.naming
|
||
</div>
|
||
<h2 class="title" title="Interface NamingEnumeration">Interface NamingEnumeration<T></h2>
|
||
</div><div class="contentContainer">
|
||
<div class="description">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<dl>
|
||
<dt>
|
||
All Superinterfaces:
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../java/util/Enumeration.html" title="java.util中的接口">Enumeration</a> <T></span>
|
||
</dd>
|
||
</dl>
|
||
<hr/> <br/> <pre>public interface <span class="typeNameLabel">NamingEnumeration<T></span>
|
||
extends <a href="../../java/util/Enumeration.html" title="interface in java.util">Enumeration</a><T></pre>
|
||
<div class="block">
|
||
<span>此接口用于枚举javax.naming和javax.naming.directory包中的方法返回的列表。</span>
|
||
<span>它扩展枚举以允许在枚举期间抛出异常。</span>
|
||
<p> <span>当一个方法如list（），listBindings（）或search（）返回一个NamingEnumeration时，任何遇到的异常被保留，直到返回所有结果为止。</span> <span>在枚举结束时，抛出异常（由hasMore（））;</span> </p>
|
||
<p> <span>例如，如果list（）只返回部分答案，则相应的异常将是PartialResultException。</span> <span>list（）将首先返回NamingEnumeration。</span> <span>当NamingEnumeration的next（）返回最后一个结果时，调用hasMore（）将导致抛出PartialResultException。</span> </p>
|
||
<p> <span>在另一个例子中，如果调用了一个指定的大小限制为'n'的search（）方法。</span> <span>如果答案由超过'n'个结果组成，则search（）将首先返回一个NamingEnumeration。</span> <span>当NamingEnumeration调用next（）返回第n个结果时，调用hasMore（）时会抛出SizeLimitExceedException异常。</span> </p>
|
||
<p> <span>请注意，如果程序使用hasMoreElements（）和nextElement（）来迭代NamingEnumeration，因为这些方法不能抛出异常，不会抛出异常。</span> <span>相反，在前面的例子中，在nextElement（）返回第n个结果之后，调用hasMoreElements（）将返回false。</span> </p>
|
||
<p> <span>另请注意，如果程序在枚举中没有剩余元素的情况下调用next（）或nextElement（），则抛出NoSuchElementException异常。</span> <span>该程序总是可以通过使用hasMore（）和hasMoreElements（）来检查是否已经到达枚举结束来避免此异常。</span> </p>
|
||
<p> <span>如果在枚举期间抛出异常，枚举将无效。</span> <span>随后调用该枚举的任何方法将产生未定义的结果。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="simpleTagLabel">从以下版本开始：</span>
|
||
</dt>
|
||
<dd>
|
||
1.3
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../javax/naming/Context.html#list-javax.naming.Name-"><code>Context.list(javax.naming.Name)</code></a> ，
|
||
<a href="../../javax/naming/Context.html#listBindings-javax.naming.Name-"><code>Context.listBindings(javax.naming.Name)</code></a> ，
|
||
<a href="../../javax/naming/directory/DirContext.html#search-javax.naming.Name-javax.naming.directory.Attributes-java.lang.String:A-"><code>DirContext.search(javax.naming.Name, javax.naming.directory.Attributes, java.lang.String[])</code></a> ，
|
||
<a href="../../javax/naming/directory/Attributes.html#getAll--"><code>Attributes.getAll()</code></a> ，
|
||
<a href="../../javax/naming/directory/Attributes.html#getIDs--"><code>Attributes.getIDs()</code></a> ，
|
||
<a href="../../javax/naming/directory/Attribute.html#getAll--"><code>Attribute.getAll()</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="../../javax/naming/NamingEnumeration.html#close--">close</a></span>()</code>
|
||
<div class="block">
|
||
关闭此枚举。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i1">
|
||
<td class="colFirst"><code>boolean</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/naming/NamingEnumeration.html#hasMore--">hasMore</a></span>()</code>
|
||
<div class="block">
|
||
确定枚举中是否有更多的元素。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i2">
|
||
<td class="colFirst"><code><a href="../../javax/naming/NamingEnumeration.html" title="type parameter in NamingEnumeration">T</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/naming/NamingEnumeration.html#next--">next</a></span>()</code>
|
||
<div class="block">
|
||
检索枚举中的下一个元素。
|
||
</div> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="methods.inherited.from.class.java.util.Enumeration">
|
||
<!-- --> </a> <h3>Methods inherited from interface java.util.<a href="../../java/util/Enumeration.html" title="interface in java.util">Enumeration</a></h3> <code><a href="../../java/util/Enumeration.html#hasMoreElements--">hasMoreElements</a>, <a href="../../java/util/Enumeration.html#nextElement--">nextElement</a></code></li>
|
||
</ul> </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="next--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>next</h4> <pre><a href="../../javax/naming/NamingEnumeration.html" title="type parameter in NamingEnumeration">T</a> next()
|
||
throws <a href="../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
|
||
<div class="block">
|
||
<span>检索枚举中的下一个元素。</span>
|
||
<span>此方法允许在检索要由应用程序捕获和处理的下一个元素时遇到异常。</span>
|
||
<p> <span>请注意， <tt>next()</tt>还可以抛出运行时异常NoSuchElementException来指示调用者尝试枚举超出枚举结束。</span> <span>这与NamingException不同，NamingException表示获取下一个元素有问题，例如，由于引用或服务器不可用等原因。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<span>枚举中可能为null的元素。</span>
|
||
<span>null仅对可以返回null的枚举有效（例如，Attribute.getAll（）返回属性值的枚举，属性值可以为null）。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code><a href="../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果在尝试检索下一个元素时遇到命名异常。</span>
|
||
<span>有关可能的命名异常，请参阅NamingException及其子类。</span>
|
||
</dd>
|
||
<dd>
|
||
<code><a href="../../java/util/NoSuchElementException.html" title="class in java.util">NoSuchElementException</a></code> - 如果在没有可用时尝试获取下一个元素。
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../java/util/Enumeration.html#nextElement--"><code>Enumeration.nextElement()</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="hasMore--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>hasMore</h4> <pre>boolean hasMore()
|
||
throws <a href="../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
|
||
<div class="block">
|
||
<span>确定枚举中是否有更多的元素。</span>
|
||
<span>该方法允许在确定应用程序是否有更多元素被捕获和处理时遇到的命名异常。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<span>如果在枚举中有更多，则为真;</span>
|
||
<span>否则为假。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code><a href="../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果在尝试确定枚举中是否有其他元素时遇到命名异常。</span>
|
||
<span>有关可能的命名异常，请参阅NamingException及其子类。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../java/util/Enumeration.html#hasMoreElements--"><code>Enumeration.hasMoreElements()</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="close--">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>close</h4> <pre>void close()
|
||
throws <a href="../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
|
||
<div class="block">
|
||
<span>关闭此枚举。</span>
|
||
<span>在此枚举后调用此方法后，枚举将变为无效，并且随后调用其任何方法将产生未定义的结果。</span>
|
||
<span>此方法用于中止枚举以释放资源。</span>
|
||
<span>如果枚举结束 - 即直到<tt>hasMoreElements()</tt>或<tt>hasMore()</tt>返回<tt>false</tt> - 资源将自动释放，并且不需要明确地调用<tt>close()</tt> 。</span>
|
||
<p> <span>该方法向服务提供商指示可以释放与枚举相关联的资源，并可以通知服务器取消任何未完成的请求。</span> <span><tt>close()</tt>方法是管理其资源的实现的提示。</span> <span>在客户端省略<tt>close()</tt>电话时，鼓励实施使用适当的算法来管理<tt>资源</tt> 。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果在关闭枚举时遇到命名异常。
|
||
</dd>
|
||
<dt>
|
||
<span class="simpleTagLabel">从以下版本开始：</span>
|
||
</dt>
|
||
<dd>
|
||
1.3
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
</div> |