mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-08-23 19:49:34 +08:00
339 lines
20 KiB
HTML
339 lines
20 KiB
HTML
<div class="header">
|
||
<div class="subTitle">
|
||
compact3
|
||
</div>
|
||
<div class="subTitle">
|
||
javax.naming.ldap
|
||
</div>
|
||
<h2 class="title" title="Class LdapReferralException">Class LdapReferralException</h2>
|
||
</div><div class="contentContainer">
|
||
<ul class="inheritance">
|
||
<li><a href="../../../java/lang/Object.html" title="class in java.lang">java.lang.Object</a></li>
|
||
<li>
|
||
<ul class="inheritance">
|
||
<li><a href="../../../java/lang/Throwable.html" title="class in java.lang">java.lang.Throwable</a></li>
|
||
<li>
|
||
<ul class="inheritance">
|
||
<li><a href="../../../java/lang/Exception.html" title="class in java.lang">java.lang.Exception</a></li>
|
||
<li>
|
||
<ul class="inheritance">
|
||
<li><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">javax.naming.NamingException</a></li>
|
||
<li>
|
||
<ul class="inheritance">
|
||
<li><a href="../../../javax/naming/ReferralException.html" title="class in javax.naming">javax.naming.ReferralException</a></li>
|
||
<li>
|
||
<ul class="inheritance">
|
||
<li>javax.naming.ldap.LdapReferralException</li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
<div class="description">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<dl>
|
||
<dt>
|
||
All Implemented Interfaces:
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../java/io/Serializable.html" title="java.io中的接口">Serializable</a></span>
|
||
</dd>
|
||
</dl>
|
||
<hr/> <br/> <pre>public abstract class <span class="typeNameLabel">LdapReferralException</span>
|
||
extends <a href="../../../javax/naming/ReferralException.html" title="class in javax.naming">ReferralException</a></pre>
|
||
<div class="block">
|
||
<span>此抽象类用于表示LDAP引用异常。</span>
|
||
<span>它通过提供接受请求控制的<tt>getReferralContext()</tt>方法来扩展基础<tt>ReferralException</tt> 。</span>
|
||
<span>LdapReferralException是一个抽象类。</span>
|
||
<span>它的具体实现决定了其同步和序列化属性。</span>
|
||
<p> <span>作为<tt>参数</tt>传递给<tt>getReferralContext()</tt>方法的<tt>Control[]</tt>数组由调用者拥有。</span> <span>服务提供商不会修改数组或保留对它的引用，尽管它可能会保留对数组中的个人<tt>Control</tt>对象的引用。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="simpleTagLabel">从以下版本开始：</span>
|
||
</dt>
|
||
<dd>
|
||
1.3
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../serialized-form.html#javax.naming.ldap.LdapReferralException">Serialized Form</a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul>
|
||
</div>
|
||
<div class="summary">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<!-- =========== FIELD SUMMARY =========== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="field.summary">
|
||
<!-- --> </a> <h3>Field Summary</h3>
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="fields.inherited.from.class.javax.naming.NamingException">
|
||
<!-- --> </a> <h3>Fields inherited from class javax.naming.<a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></h3> <code><a href="../../../javax/naming/NamingException.html#remainingName">remainingName</a>, <a href="../../../javax/naming/NamingException.html#resolvedName">resolvedName</a>, <a href="../../../javax/naming/NamingException.html#resolvedObj">resolvedObj</a>, <a href="../../../javax/naming/NamingException.html#rootException">rootException</a></code></li>
|
||
</ul> </li>
|
||
</ul>
|
||
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="constructor.summary">
|
||
<!-- --> </a> <h3>构造方法摘要</h3>
|
||
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Constructor Summary table, listing constructors, and an explanation">
|
||
<caption>
|
||
<span>构造方法</span>
|
||
<span class="tabEnd"> </span>
|
||
</caption>
|
||
<tbody>
|
||
<tr>
|
||
<th class="colFirst" scope="col">Modifier</th>
|
||
<th class="colLast" scope="col">Constructor and Description</th>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><code>protected </code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/ldap/LdapReferralException.html#LdapReferralException--">LdapReferralException</a></span>()</code>
|
||
<div class="block">
|
||
构造一个新的LdapReferralException实例。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colFirst"><code>protected </code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/ldap/LdapReferralException.html#LdapReferralException-java.lang.String-">LdapReferralException</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> explanation)</code>
|
||
<div class="block">
|
||
使用提供的说明构造一个新的LdapReferralException实例。
|
||
</div> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table> </li>
|
||
</ul>
|
||
<!-- ========== 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>abstract <a href="../../../javax/naming/Context.html" title="interface in javax.naming">Context</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/ldap/LdapReferralException.html#getReferralContext--">getReferralContext</a></span>()</code>
|
||
<div class="block">
|
||
检索使用上下文环境继续该方法的上下文，而不使用控件。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i1">
|
||
<td class="colFirst"><code>abstract <a href="../../../javax/naming/Context.html" title="interface in javax.naming">Context</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/ldap/LdapReferralException.html#getReferralContext-java.util.Hashtable-">getReferralContext</a></span>(<a href="../../../java/util/Hashtable.html" title="class in java.util">Hashtable</a><?,?> env)</code>
|
||
<div class="block">
|
||
检索使用环境属性继续该方法的上下文，而不使用控件。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i2">
|
||
<td class="colFirst"><code>abstract <a href="../../../javax/naming/Context.html" title="interface in javax.naming">Context</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/ldap/LdapReferralException.html#getReferralContext-java.util.Hashtable-javax.naming.ldap.Control:A-">getReferralContext</a></span>(<a href="../../../java/util/Hashtable.html" title="class in java.util">Hashtable</a><?,?> env, <a href="../../../javax/naming/ldap/Control.html" title="interface in javax.naming.ldap">Control</a>[] reqCtls)</code>
|
||
<div class="block">
|
||
检索使用请求控件和环境属性继续该方法的上下文。
|
||
</div> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="methods.inherited.from.class.javax.naming.ReferralException">
|
||
<!-- --> </a> <h3>Methods inherited from class javax.naming.<a href="../../../javax/naming/ReferralException.html" title="class in javax.naming">ReferralException</a></h3> <code><a href="../../../javax/naming/ReferralException.html#getReferralInfo--">getReferralInfo</a>, <a href="../../../javax/naming/ReferralException.html#retryReferral--">retryReferral</a>, <a href="../../../javax/naming/ReferralException.html#skipReferral--">skipReferral</a></code></li>
|
||
</ul>
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="methods.inherited.from.class.javax.naming.NamingException">
|
||
<!-- --> </a> <h3>Methods inherited from class javax.naming.<a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></h3> <code><a href="../../../javax/naming/NamingException.html#appendRemainingComponent-java.lang.String-">appendRemainingComponent</a>, <a href="../../../javax/naming/NamingException.html#appendRemainingName-javax.naming.Name-">appendRemainingName</a>, <a href="../../../javax/naming/NamingException.html#getCause--">getCause</a>, <a href="../../../javax/naming/NamingException.html#getExplanation--">getExplanation</a>, <a href="../../../javax/naming/NamingException.html#getRemainingName--">getRemainingName</a>, <a href="../../../javax/naming/NamingException.html#getResolvedName--">getResolvedName</a>, <a href="../../../javax/naming/NamingException.html#getResolvedObj--">getResolvedObj</a>, <a href="../../../javax/naming/NamingException.html#getRootCause--">getRootCause</a>, <a href="../../../javax/naming/NamingException.html#initCause-java.lang.Throwable-">initCause</a>, <a href="../../../javax/naming/NamingException.html#setRemainingName-javax.naming.Name-">setRemainingName</a>, <a href="../../../javax/naming/NamingException.html#setResolvedName-javax.naming.Name-">setResolvedName</a>, <a href="../../../javax/naming/NamingException.html#setResolvedObj-java.lang.Object-">setResolvedObj</a>, <a href="../../../javax/naming/NamingException.html#setRootCause-java.lang.Throwable-">setRootCause</a>, <a href="../../../javax/naming/NamingException.html#toString--">toString</a>, <a href="../../../javax/naming/NamingException.html#toString-boolean-">toString</a></code></li>
|
||
</ul>
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Throwable">
|
||
<!-- --> </a> <h3>Methods inherited from class java.lang.<a href="../../../java/lang/Throwable.html" title="class in java.lang">Throwable</a></h3> <code><a href="../../../java/lang/Throwable.html#addSuppressed-java.lang.Throwable-">addSuppressed</a>, <a href="../../../java/lang/Throwable.html#fillInStackTrace--">fillInStackTrace</a>, <a href="../../../java/lang/Throwable.html#getLocalizedMessage--">getLocalizedMessage</a>, <a href="../../../java/lang/Throwable.html#getMessage--">getMessage</a>, <a href="../../../java/lang/Throwable.html#getStackTrace--">getStackTrace</a>, <a href="../../../java/lang/Throwable.html#getSuppressed--">getSuppressed</a>, <a href="../../../java/lang/Throwable.html#printStackTrace--">printStackTrace</a>, <a href="../../../java/lang/Throwable.html#printStackTrace-java.io.PrintStream-">printStackTrace</a>, <a href="../../../java/lang/Throwable.html#printStackTrace-java.io.PrintWriter-">printStackTrace</a>, <a href="../../../java/lang/Throwable.html#setStackTrace-java.lang.StackTraceElement:A-">setStackTrace</a></code></li>
|
||
</ul>
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
|
||
<!-- --> </a> <h3>Methods inherited from class java.lang.<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></h3> <code><a href="../../../java/lang/Object.html#clone--">clone</a>, <a href="../../../java/lang/Object.html#equals-java.lang.Object-">equals</a>, <a href="../../../java/lang/Object.html#finalize--">finalize</a>, <a href="../../../java/lang/Object.html#getClass--">getClass</a>, <a href="../../../java/lang/Object.html#hashCode--">hashCode</a>, <a href="../../../java/lang/Object.html#notify--">notify</a>, <a href="../../../java/lang/Object.html#notifyAll--">notifyAll</a>, <a href="../../../java/lang/Object.html#wait--">wait</a>, <a href="../../../java/lang/Object.html#wait-long-">wait</a>, <a href="../../../java/lang/Object.html#wait-long-int-">wait</a></code></li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
<div class="details">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<!-- ========= CONSTRUCTOR DETAIL ======== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="constructor.detail">
|
||
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="LdapReferralException-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>LdapReferralException</h4> <pre>protected LdapReferralException(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> explanation)</pre>
|
||
<div class="block">
|
||
<span>使用提供的说明构造一个新的LdapReferralException实例。</span>
|
||
<span>所有其他字段都设置为null。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>explanation</code> - 有关此异常的其他详细信息。</span>
|
||
<span>可以为null。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../java/lang/Throwable.html#getMessage--"><code>Throwable.getMessage()</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="LdapReferralException--">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>LdapReferralException</h4> <pre>protected LdapReferralException()</pre>
|
||
<div class="block">
|
||
<span>构造一个新的LdapReferralException实例。</span>
|
||
<span>所有字段都设置为null。</span>
|
||
</div> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
<!-- ============ METHOD DETAIL ========== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="method.detail">
|
||
<!-- --> </a> <h3>方法详细信息</h3> <a name="getReferralContext--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getReferralContext</h4> <pre>public abstract <a href="../../../javax/naming/Context.html" title="interface in javax.naming">Context</a> getReferralContext()
|
||
throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
|
||
<div class="block">
|
||
<span>检索使用上下文环境继续该方法的上下文，而不使用控件。</span>
|
||
<span>引用上下文是使用抛出ReferralException的上下文的环境<tt>属性创建的</tt> ，没有控件。</span>
|
||
<p> <span>这个方法相当于</span> </p>
|
||
<blockquote>
|
||
<span><pre>
|
||
getReferralContext(ctx.getEnvironment(), null);
|
||
</pre></span>
|
||
</blockquote>
|
||
<span>其中<tt>ctx</tt>是扔<tt>ReferralException.</tt>的上下文</span>
|
||
<p> <span>在本课程中，仅用于文档目的而被覆盖。</span> <span>有关如何使用此方法，请参阅<tt>ReferralException</tt> 。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="overrideSpecifyLabel">Specified by:</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../javax/naming/ReferralException.html#getReferralContext--">getReferralContext</a></code>在类别
|
||
<code><a href="../../../javax/naming/ReferralException.html" title="class in javax.naming">ReferralException</a></code>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
用于继续该方法的非空上下文。
|
||
</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>致电<tt>retryReferral()</tt>或<tt>skipReferral()</tt>以继续处理转介。</span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getReferralContext-java.util.Hashtable-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getReferralContext</h4> <pre>public abstract <a href="../../../javax/naming/Context.html" title="interface in javax.naming">Context</a> getReferralContext(<a href="../../../java/util/Hashtable.html" title="class in java.util">Hashtable</a><?,?> env)
|
||
throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
|
||
<div class="block">
|
||
<span>检索使用环境属性继续该方法的上下文，而不使用控件。</span>
|
||
<span>引用上下文是使用<tt>env</tt>作为其环境属性创建的，没有控件。</span>
|
||
<p> <span>这个方法相当于</span> </p>
|
||
<blockquote>
|
||
<span><pre>
|
||
getReferralContext(env, null);
|
||
</pre></span>
|
||
</blockquote>
|
||
<p> <span>在本课程中，仅用于文档目的而被覆盖。</span> <span>有关如何使用此方法，请参阅<tt>ReferralException</tt> 。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="overrideSpecifyLabel">Specified by:</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../javax/naming/ReferralException.html#getReferralContext-java.util.Hashtable-">getReferralContext</a></code>在
|
||
<code><a href="../../../javax/naming/ReferralException.html" title="class in javax.naming">ReferralException</a></code>
|
||
</dd>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>env</code> - 检索引用上下文时可能使用的空闲环境。</span>
|
||
<span>如果为空，则不会使用环境属性。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
用于继续该方法的非空上下文。
|
||
</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>请致电<tt>retryReferral()</tt>或<tt>skipReferral()</tt>以继续处理转介。</span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getReferralContext-java.util.Hashtable-javax.naming.ldap.Control:A-">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>getReferralContext</h4> <pre>public abstract <a href="../../../javax/naming/Context.html" title="interface in javax.naming">Context</a> getReferralContext(<a href="../../../java/util/Hashtable.html" title="class in java.util">Hashtable</a><?,?> env,
|
||
<a href="../../../javax/naming/ldap/Control.html" title="interface in javax.naming.ldap">Control</a>[] reqCtls)
|
||
throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
|
||
<div class="block">
|
||
<span>检索使用请求控件和环境属性继续该方法的上下文。</span>
|
||
<span>无论在上下文操作期间是直接遇到转介，还是间接地，例如在搜索枚举期间，引用异常应提供继续操作的上下文。</span>
|
||
<span>要继续操作，客户端程序应该使用与原始调用相同的参数重新调用该方法。</span>
|
||
<p> <span><tt>reqCtls</tt>用于创建与引用服务器的连接。</span> <span>这些控件将用作从上下文导出的上下文和上下文实例的连接请求控件。</span> <span><tt>reqCtls</tt>也将是上下文的后续上下文操作的请求控制。</span> <span>有关详细信息，请参阅<tt>LdapContext</tt>类描述。</span> </p>
|
||
<p> <span>当调用者需要提供创建引用上下文的请求控件时，应该使用此方法而不是其他两个重载表单。</span> <span>例如，当需要提供与认证有关的特殊控制时，可能需要这样做。</span> </p>
|
||
<p> <span>服务提供商实现者应阅读<tt>LdapContext</tt>类描述中的“服务提供商”部分，了解实现细节。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>reqCtls</code> - 用于新上下文的可能的空请求控件。</span>
|
||
<span>如果null或空数组意味着不使用请求控件。</span>
|
||
</dd>
|
||
<dd>
|
||
<span><code>env</code> - 为新的上下文使用的可能的空环境属性。</span>
|
||
<span>如果为空，则上下文将初始化为无环境属性。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
用于继续该方法的非空上下文。
|
||
</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>致电<tt>retryReferral()</tt>或<tt>skipReferral()</tt>以继续处理转介。</span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
</div> |