uTools-Manuals/docs/java/javax/naming/ldap/InitialLdapContext.html

<div class="header">
<div class="subTitle">
     compact3 
   </div>
<div class="subTitle">
     javax.naming.ldap 
   </div>
<h2 class="title" title="Class InitialLdapContext">Class InitialLdapContext</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="../../../javax/naming/InitialContext.html" title="class in javax.naming">javax.naming.InitialContext</a></li>
<li>
<ul class="inheritance">
<li><a href="../../../javax/naming/directory/InitialDirContext.html" title="class in javax.naming.directory">javax.naming.directory.InitialDirContext</a></li>
<li>
<ul class="inheritance">
<li>javax.naming.ldap.InitialLdapContext</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="../../../javax/naming/Context.html" title="javax.naming中的接口">Context</a> ， <a href="../../../javax/naming/directory/DirContext.html" title="javax.naming.directory中的接口">DirContext</a> ， <a href="../../../javax/naming/ldap/LdapContext.html" title="javax.naming.ldap中的接口">LdapContext</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public class <span class="typeNameLabel">InitialLdapContext</span>
extends <a href="../../../javax/naming/directory/InitialDirContext.html" title="class in javax.naming.directory">InitialDirContext</a>
implements <a href="../../../javax/naming/ldap/LdapContext.html" title="interface in javax.naming.ldap">LdapContext</a></pre>
<div class="block">
<span>此类是执行LDAPv3风格的扩展操作和控件的起始上下文。</span>
<p> <span>有关<tt>同步</tt>的详细信息，请参阅<tt>javax.naming.InitialContext</tt>和<tt>javax.naming.InitialDirContext</tt>以及如何创建初始上下文的策略。</span> </p>
<h1> <span>请求控制</span> </h1>
<span>创建初始上下文（ <tt>InitialLdapContext</tt> ）时，可以指定请求控件列表。</span>
<span>这些控件将被用作由上下文导出的上下文或上下文执行的任何隐式LDAP“绑定”操作的请求控件。</span>
<span>这些称为<em>连接请求控件</em> 。</span>
<span>使用<tt>getConnectControls()</tt>获取上下文的连接请求控件。</span>
<p> <span>提供给初始上下文构造函数的请求控件<em>不会</em>用作后续上下文操作（如搜索和查找）的上下文请求控件。</span> <span>上下文请求控制通过使用<tt>setRequestControls()</tt>进行设置和更新。</span> </p>
<p> <span>如图所示，可以有两组与上下文相关联的请求控制：连接请求控件和上下文请求控件。</span> <span>这是需要发送可能不适用于上下文操作和任何隐式LDAP“绑定”操作的关键控件的那些应用程序所必需的。</span> <span>典型的用户程序将执行以下操作：</span> </p>
<blockquote>
<span><pre>
 InitialLdapContext lctx = new InitialLdapContext(env, critConnCtls);
 lctx.setRequestControls(critModCtls);
 lctx.modifyAttributes(name, mods);
 Controls[] respCtls =  lctx.getResponseControls();
</pre></span>
</blockquote>
<span>它首先指定创建初始上下文（ <tt>critConnCtls</tt> ）的关键控件，然后设置上下文操作的上下文请求控件（ <tt>critModCtls</tt> ）。</span>
<span>如果由于某些原因<tt>lctx</tt>需要重新连接到服务器，它将使用<tt>critConnCtls</tt> 。</span>
<span>有关请求控制的更多讨论，请参阅<tt>LdapContext</tt>界面。</span>
<p> <span>服务提供商实施者应阅读<tt>LdapContext</tt>类描述中的“服务提供商”部分，了解实施细节。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
         1.3 
       </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../javax/naming/ldap/LdapContext.html" title="javax.naming.ldap中的接口"><code>LdapContext</code></a> ， <a href="../../../javax/naming/InitialContext.html" title="javax.naming中的类"><code>InitialContext</code></a> ， <a href="../../../javax/naming/directory/InitialDirContext.html" title="javax.naming.directory中的类"><code>InitialDirContext</code></a> ， <a href="../../../javax/naming/spi/NamingManager.html#setInitialContextFactoryBuilder-javax.naming.spi.InitialContextFactoryBuilder-"><code>NamingManager.setInitialContextFactoryBuilder(javax.naming.spi.InitialContextFactoryBuilder)</code></a></span>
</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.InitialContext">
<!-- --> </a> <h3>Fields inherited from class javax.naming.<a href="../../../javax/naming/InitialContext.html" title="class in javax.naming">InitialContext</a></h3> <code><a href="../../../javax/naming/InitialContext.html#defaultInitCtx">defaultInitCtx</a>, <a href="../../../javax/naming/InitialContext.html#gotDefault">gotDefault</a>, <a href="../../../javax/naming/InitialContext.html#myProps">myProps</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.javax.naming.ldap.LdapContext">
<!-- --> </a> <h3>Fields inherited from interface javax.naming.ldap.<a href="../../../javax/naming/ldap/LdapContext.html" title="interface in javax.naming.ldap">LdapContext</a></h3> <code><a href="../../../javax/naming/ldap/LdapContext.html#CONTROL_FACTORIES">CONTROL_FACTORIES</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.javax.naming.directory.DirContext">
<!-- --> </a> <h3>Fields inherited from interface javax.naming.directory.<a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></h3> <code><a href="../../../javax/naming/directory/DirContext.html#ADD_ATTRIBUTE">ADD_ATTRIBUTE</a>, <a href="../../../javax/naming/directory/DirContext.html#REMOVE_ATTRIBUTE">REMOVE_ATTRIBUTE</a>, <a href="../../../javax/naming/directory/DirContext.html#REPLACE_ATTRIBUTE">REPLACE_ATTRIBUTE</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.javax.naming.Context">
<!-- --> </a> <h3>Fields inherited from interface javax.naming.<a href="../../../javax/naming/Context.html" title="interface in javax.naming">Context</a></h3> <code><a href="../../../javax/naming/Context.html#APPLET">APPLET</a>, <a href="../../../javax/naming/Context.html#AUTHORITATIVE">AUTHORITATIVE</a>, <a href="../../../javax/naming/Context.html#BATCHSIZE">BATCHSIZE</a>, <a href="../../../javax/naming/Context.html#DNS_URL">DNS_URL</a>, <a href="../../../javax/naming/Context.html#INITIAL_CONTEXT_FACTORY">INITIAL_CONTEXT_FACTORY</a>, <a href="../../../javax/naming/Context.html#LANGUAGE">LANGUAGE</a>, <a href="../../../javax/naming/Context.html#OBJECT_FACTORIES">OBJECT_FACTORIES</a>, <a href="../../../javax/naming/Context.html#PROVIDER_URL">PROVIDER_URL</a>, <a href="../../../javax/naming/Context.html#REFERRAL">REFERRAL</a>, <a href="../../../javax/naming/Context.html#SECURITY_AUTHENTICATION">SECURITY_AUTHENTICATION</a>, <a href="../../../javax/naming/Context.html#SECURITY_CREDENTIALS">SECURITY_CREDENTIALS</a>, <a href="../../../javax/naming/Context.html#SECURITY_PRINCIPAL">SECURITY_PRINCIPAL</a>, <a href="../../../javax/naming/Context.html#SECURITY_PROTOCOL">SECURITY_PROTOCOL</a>, <a href="../../../javax/naming/Context.html#STATE_FACTORIES">STATE_FACTORIES</a>, <a href="../../../javax/naming/Context.html#URL_PKG_PREFIXES">URL_PKG_PREFIXES</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="colOne" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/naming/ldap/InitialLdapContext.html#InitialLdapContext--">InitialLdapContext</a></span>()</code>
<div class="block">
              构造一个不使用环境属性或连接请求控件的初始上下文。 
            </div> </td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/naming/ldap/InitialLdapContext.html#InitialLdapContext-java.util.Hashtable-javax.naming.ldap.Control:A-">InitialLdapContext</a></span>(<a href="../../../java/util/Hashtable.html" title="class in java.util">Hashtable</a>&lt;?,?&gt; environment, <a href="../../../javax/naming/ldap/Control.html" title="interface in javax.naming.ldap">Control</a>[] connCtls)</code>
<div class="block">
              使用环境属性和连接请求控件构造初始上下文。 
            </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="t4"><span><a href="javascript:show(8);">具体的方法</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><a href="../../../javax/naming/ldap/ExtendedResponse.html" title="interface in javax.naming.ldap">ExtendedResponse</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/ldap/InitialLdapContext.html#extendedOperation-javax.naming.ldap.ExtendedRequest-">extendedOperation</a></span>(<a href="../../../javax/naming/ldap/ExtendedRequest.html" title="interface in javax.naming.ldap">ExtendedRequest</a> request)</code>
<div class="block">
              执行扩展操作。 
            </div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../../javax/naming/ldap/Control.html" title="interface in javax.naming.ldap">Control</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/ldap/InitialLdapContext.html#getConnectControls--">getConnectControls</a></span>()</code>
<div class="block">
              检索此上下文的连接请求控件。 
            </div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../../javax/naming/ldap/Control.html" title="interface in javax.naming.ldap">Control</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/ldap/InitialLdapContext.html#getRequestControls--">getRequestControls</a></span>()</code>
<div class="block">
              检索对该上下文有效的请求控件。 
            </div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../../javax/naming/ldap/Control.html" title="interface in javax.naming.ldap">Control</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/ldap/InitialLdapContext.html#getResponseControls--">getResponseControls</a></span>()</code>
<div class="block">
              检索由此上下文调用的最后一个方法生成的响应控件。 
            </div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code><a href="../../../javax/naming/ldap/LdapContext.html" title="interface in javax.naming.ldap">LdapContext</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/ldap/InitialLdapContext.html#newInstance-javax.naming.ldap.Control:A-">newInstance</a></span>(<a href="../../../javax/naming/ldap/Control.html" title="interface in javax.naming.ldap">Control</a>[] reqCtls)</code>
<div class="block">
              创建使用请求控件初始化的此上下文的新实例。 
            </div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/ldap/InitialLdapContext.html#reconnect-javax.naming.ldap.Control:A-">reconnect</a></span>(<a href="../../../javax/naming/ldap/Control.html" title="interface in javax.naming.ldap">Control</a>[] connCtls)</code>
<div class="block">
              使用提供的控件和此上下文的环境重新连接到LDAP服务器。 
            </div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/ldap/InitialLdapContext.html#setRequestControls-javax.naming.ldap.Control:A-">setRequestControls</a></span>(<a href="../../../javax/naming/ldap/Control.html" title="interface in javax.naming.ldap">Control</a>[] requestControls)</code>
<div class="block">
              设置随后在此上下文中调用的方法的请求控件。 
            </div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.naming.directory.InitialDirContext">
<!-- --> </a> <h3>Methods inherited from class javax.naming.directory.<a href="../../../javax/naming/directory/InitialDirContext.html" title="class in javax.naming.directory">InitialDirContext</a></h3> <code><a href="../../../javax/naming/directory/InitialDirContext.html#bind-javax.naming.Name-java.lang.Object-javax.naming.directory.Attributes-">bind</a>, <a href="../../../javax/naming/directory/InitialDirContext.html#bind-java.lang.String-java.lang.Object-javax.naming.directory.Attributes-">bind</a>, <a href="../../../javax/naming/directory/InitialDirContext.html#createSubcontext-javax.naming.Name-javax.naming.directory.Attributes-">createSubcontext</a>, <a href="../../../javax/naming/directory/InitialDirContext.html#createSubcontext-java.lang.String-javax.naming.directory.Attributes-">createSubcontext</a>, <a href="../../../javax/naming/directory/InitialDirContext.html#getAttributes-javax.naming.Name-">getAttributes</a>, <a href="../../../javax/naming/directory/InitialDirContext.html#getAttributes-javax.naming.Name-java.lang.String:A-">getAttributes</a>, <a href="../../../javax/naming/directory/InitialDirContext.html#getAttributes-java.lang.String-">getAttributes</a>, <a href="../../../javax/naming/directory/InitialDirContext.html#getAttributes-java.lang.String-java.lang.String:A-">getAttributes</a>, <a href="../../../javax/naming/directory/InitialDirContext.html#getSchema-javax.naming.Name-">getSchema</a>, <a href="../../../javax/naming/directory/InitialDirContext.html#getSchema-java.lang.String-">getSchema</a>, <a href="../../../javax/naming/directory/InitialDirContext.html#getSchemaClassDefinition-javax.naming.Name-">getSchemaClassDefinition</a>, <a href="../../../javax/naming/directory/InitialDirContext.html#getSchemaClassDefinition-java.lang.String-">getSchemaClassDefinition</a>, <a href="../../../javax/naming/directory/InitialDirContext.html#modifyAttributes-javax.naming.Name-int-javax.naming.directory.Attributes-">modifyAttributes</a>, <a href="../../../javax/naming/directory/InitialDirContext.html#modifyAttributes-javax.naming.Name-javax.naming.directory.ModificationItem:A-">modifyAttributes</a>, <a href="../../../javax/naming/directory/InitialDirContext.html#modifyAttributes-java.lang.String-int-javax.naming.directory.Attributes-">modifyAttributes</a>, <a href="../../../javax/naming/directory/InitialDirContext.html#modifyAttributes-java.lang.String-javax.naming.directory.ModificationItem:A-">modifyAttributes</a>, <a href="../../../javax/naming/directory/InitialDirContext.html#rebind-javax.naming.Name-java.lang.Object-javax.naming.directory.Attributes-">rebind</a>, <a href="../../../javax/naming/directory/InitialDirContext.html#rebind-java.lang.String-java.lang.Object-javax.naming.directory.Attributes-">rebind</a>, <a href="../../../javax/naming/directory/InitialDirContext.html#search-javax.naming.Name-javax.naming.directory.Attributes-">search</a>, <a href="../../../javax/naming/directory/InitialDirContext.html#search-javax.naming.Name-javax.naming.directory.Attributes-java.lang.String:A-">search</a>, <a href="../../../javax/naming/directory/InitialDirContext.html#search-javax.naming.Name-java.lang.String-java.lang.Object:A-javax.naming.directory.SearchControls-">search</a>, <a href="../../../javax/naming/directory/InitialDirContext.html#search-javax.naming.Name-java.lang.String-javax.naming.directory.SearchControls-">search</a>, <a href="../../../javax/naming/directory/InitialDirContext.html#search-java.lang.String-javax.naming.directory.Attributes-">search</a>, <a href="../../../javax/naming/directory/InitialDirContext.html#search-java.lang.String-javax.naming.directory.Attributes-java.lang.String:A-">search</a>, <a href="../../../javax/naming/directory/InitialDirContext.html#search-java.lang.String-java.lang.String-java.lang.Object:A-javax.naming.directory.SearchControls-">search</a>, <a href="../../../javax/naming/directory/InitialDirContext.html#search-java.lang.String-java.lang.String-javax.naming.directory.SearchControls-">search</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.naming.InitialContext">
<!-- --> </a> <h3>Methods inherited from class javax.naming.<a href="../../../javax/naming/InitialContext.html" title="class in javax.naming">InitialContext</a></h3> <code><a href="../../../javax/naming/InitialContext.html#addToEnvironment-java.lang.String-java.lang.Object-">addToEnvironment</a>, <a href="../../../javax/naming/InitialContext.html#bind-javax.naming.Name-java.lang.Object-">bind</a>, <a href="../../../javax/naming/InitialContext.html#bind-java.lang.String-java.lang.Object-">bind</a>, <a href="../../../javax/naming/InitialContext.html#close--">close</a>, <a href="../../../javax/naming/InitialContext.html#composeName-javax.naming.Name-javax.naming.Name-">composeName</a>, <a href="../../../javax/naming/InitialContext.html#composeName-java.lang.String-java.lang.String-">composeName</a>, <a href="../../../javax/naming/InitialContext.html#createSubcontext-javax.naming.Name-">createSubcontext</a>, <a href="../../../javax/naming/InitialContext.html#createSubcontext-java.lang.String-">createSubcontext</a>, <a href="../../../javax/naming/InitialContext.html#destroySubcontext-javax.naming.Name-">destroySubcontext</a>, <a href="../../../javax/naming/InitialContext.html#destroySubcontext-java.lang.String-">destroySubcontext</a>, <a href="../../../javax/naming/InitialContext.html#doLookup-javax.naming.Name-">doLookup</a>, <a href="../../../javax/naming/InitialContext.html#doLookup-java.lang.String-">doLookup</a>, <a href="../../../javax/naming/InitialContext.html#getDefaultInitCtx--">getDefaultInitCtx</a>, <a href="../../../javax/naming/InitialContext.html#getEnvironment--">getEnvironment</a>, <a href="../../../javax/naming/InitialContext.html#getNameInNamespace--">getNameInNamespace</a>, <a href="../../../javax/naming/InitialContext.html#getNameParser-javax.naming.Name-">getNameParser</a>, <a href="../../../javax/naming/InitialContext.html#getNameParser-java.lang.String-">getNameParser</a>, <a href="../../../javax/naming/InitialContext.html#getURLOrDefaultInitCtx-javax.naming.Name-">getURLOrDefaultInitCtx</a>, <a href="../../../javax/naming/InitialContext.html#getURLOrDefaultInitCtx-java.lang.String-">getURLOrDefaultInitCtx</a>, <a href="../../../javax/naming/InitialContext.html#init-java.util.Hashtable-">init</a>, <a href="../../../javax/naming/InitialContext.html#list-javax.naming.Name-">list</a>, <a href="../../../javax/naming/InitialContext.html#list-java.lang.String-">list</a>, <a href="../../../javax/naming/InitialContext.html#listBindings-javax.naming.Name-">listBindings</a>, <a href="../../../javax/naming/InitialContext.html#listBindings-java.lang.String-">listBindings</a>, <a href="../../../javax/naming/InitialContext.html#lookup-javax.naming.Name-">lookup</a>, <a href="../../../javax/naming/InitialContext.html#lookup-java.lang.String-">lookup</a>, <a href="../../../javax/naming/InitialContext.html#lookupLink-javax.naming.Name-">lookupLink</a>, <a href="../../../javax/naming/InitialContext.html#lookupLink-java.lang.String-">lookupLink</a>, <a href="../../../javax/naming/InitialContext.html#rebind-javax.naming.Name-java.lang.Object-">rebind</a>, <a href="../../../javax/naming/InitialContext.html#rebind-java.lang.String-java.lang.Object-">rebind</a>, <a href="../../../javax/naming/InitialContext.html#removeFromEnvironment-java.lang.String-">removeFromEnvironment</a>, <a href="../../../javax/naming/InitialContext.html#rename-javax.naming.Name-javax.naming.Name-">rename</a>, <a href="../../../javax/naming/InitialContext.html#rename-java.lang.String-java.lang.String-">rename</a>, <a href="../../../javax/naming/InitialContext.html#unbind-javax.naming.Name-">unbind</a>, <a href="../../../javax/naming/InitialContext.html#unbind-java.lang.String-">unbind</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#toString--">toString</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>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.naming.directory.DirContext">
<!-- --> </a> <h3>Methods inherited from interface javax.naming.directory.<a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></h3> <code><a href="../../../javax/naming/directory/DirContext.html#bind-javax.naming.Name-java.lang.Object-javax.naming.directory.Attributes-">bind</a>, <a href="../../../javax/naming/directory/DirContext.html#bind-java.lang.String-java.lang.Object-javax.naming.directory.Attributes-">bind</a>, <a href="../../../javax/naming/directory/DirContext.html#createSubcontext-javax.naming.Name-javax.naming.directory.Attributes-">createSubcontext</a>, <a href="../../../javax/naming/directory/DirContext.html#createSubcontext-java.lang.String-javax.naming.directory.Attributes-">createSubcontext</a>, <a href="../../../javax/naming/directory/DirContext.html#getAttributes-javax.naming.Name-">getAttributes</a>, <a href="../../../javax/naming/directory/DirContext.html#getAttributes-javax.naming.Name-java.lang.String:A-">getAttributes</a>, <a href="../../../javax/naming/directory/DirContext.html#getAttributes-java.lang.String-">getAttributes</a>, <a href="../../../javax/naming/directory/DirContext.html#getAttributes-java.lang.String-java.lang.String:A-">getAttributes</a>, <a href="../../../javax/naming/directory/DirContext.html#getSchema-javax.naming.Name-">getSchema</a>, <a href="../../../javax/naming/directory/DirContext.html#getSchema-java.lang.String-">getSchema</a>, <a href="../../../javax/naming/directory/DirContext.html#getSchemaClassDefinition-javax.naming.Name-">getSchemaClassDefinition</a>, <a href="../../../javax/naming/directory/DirContext.html#getSchemaClassDefinition-java.lang.String-">getSchemaClassDefinition</a>, <a href="../../../javax/naming/directory/DirContext.html#modifyAttributes-javax.naming.Name-int-javax.naming.directory.Attributes-">modifyAttributes</a>, <a href="../../../javax/naming/directory/DirContext.html#modifyAttributes-javax.naming.Name-javax.naming.directory.ModificationItem:A-">modifyAttributes</a>, <a href="../../../javax/naming/directory/DirContext.html#modifyAttributes-java.lang.String-int-javax.naming.directory.Attributes-">modifyAttributes</a>, <a href="../../../javax/naming/directory/DirContext.html#modifyAttributes-java.lang.String-javax.naming.directory.ModificationItem:A-">modifyAttributes</a>, <a href="../../../javax/naming/directory/DirContext.html#rebind-javax.naming.Name-java.lang.Object-javax.naming.directory.Attributes-">rebind</a>, <a href="../../../javax/naming/directory/DirContext.html#rebind-java.lang.String-java.lang.Object-javax.naming.directory.Attributes-">rebind</a>, <a href="../../../javax/naming/directory/DirContext.html#search-javax.naming.Name-javax.naming.directory.Attributes-">search</a>, <a href="../../../javax/naming/directory/DirContext.html#search-javax.naming.Name-javax.naming.directory.Attributes-java.lang.String:A-">search</a>, <a href="../../../javax/naming/directory/DirContext.html#search-javax.naming.Name-java.lang.String-java.lang.Object:A-javax.naming.directory.SearchControls-">search</a>, <a href="../../../javax/naming/directory/DirContext.html#search-javax.naming.Name-java.lang.String-javax.naming.directory.SearchControls-">search</a>, <a href="../../../javax/naming/directory/DirContext.html#search-java.lang.String-javax.naming.directory.Attributes-">search</a>, <a href="../../../javax/naming/directory/DirContext.html#search-java.lang.String-javax.naming.directory.Attributes-java.lang.String:A-">search</a>, <a href="../../../javax/naming/directory/DirContext.html#search-java.lang.String-java.lang.String-java.lang.Object:A-javax.naming.directory.SearchControls-">search</a>, <a href="../../../javax/naming/directory/DirContext.html#search-java.lang.String-java.lang.String-javax.naming.directory.SearchControls-">search</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.naming.Context">
<!-- --> </a> <h3>Methods inherited from interface javax.naming.<a href="../../../javax/naming/Context.html" title="interface in javax.naming">Context</a></h3> <code><a href="../../../javax/naming/Context.html#addToEnvironment-java.lang.String-java.lang.Object-">addToEnvironment</a>, <a href="../../../javax/naming/Context.html#bind-javax.naming.Name-java.lang.Object-">bind</a>, <a href="../../../javax/naming/Context.html#bind-java.lang.String-java.lang.Object-">bind</a>, <a href="../../../javax/naming/Context.html#close--">close</a>, <a href="../../../javax/naming/Context.html#composeName-javax.naming.Name-javax.naming.Name-">composeName</a>, <a href="../../../javax/naming/Context.html#composeName-java.lang.String-java.lang.String-">composeName</a>, <a href="../../../javax/naming/Context.html#createSubcontext-javax.naming.Name-">createSubcontext</a>, <a href="../../../javax/naming/Context.html#createSubcontext-java.lang.String-">createSubcontext</a>, <a href="../../../javax/naming/Context.html#destroySubcontext-javax.naming.Name-">destroySubcontext</a>, <a href="../../../javax/naming/Context.html#destroySubcontext-java.lang.String-">destroySubcontext</a>, <a href="../../../javax/naming/Context.html#getEnvironment--">getEnvironment</a>, <a href="../../../javax/naming/Context.html#getNameInNamespace--">getNameInNamespace</a>, <a href="../../../javax/naming/Context.html#getNameParser-javax.naming.Name-">getNameParser</a>, <a href="../../../javax/naming/Context.html#getNameParser-java.lang.String-">getNameParser</a>, <a href="../../../javax/naming/Context.html#list-javax.naming.Name-">list</a>, <a href="../../../javax/naming/Context.html#list-java.lang.String-">list</a>, <a href="../../../javax/naming/Context.html#listBindings-javax.naming.Name-">listBindings</a>, <a href="../../../javax/naming/Context.html#listBindings-java.lang.String-">listBindings</a>, <a href="../../../javax/naming/Context.html#lookup-javax.naming.Name-">lookup</a>, <a href="../../../javax/naming/Context.html#lookup-java.lang.String-">lookup</a>, <a href="../../../javax/naming/Context.html#lookupLink-javax.naming.Name-">lookupLink</a>, <a href="../../../javax/naming/Context.html#lookupLink-java.lang.String-">lookupLink</a>, <a href="../../../javax/naming/Context.html#rebind-javax.naming.Name-java.lang.Object-">rebind</a>, <a href="../../../javax/naming/Context.html#rebind-java.lang.String-java.lang.Object-">rebind</a>, <a href="../../../javax/naming/Context.html#removeFromEnvironment-java.lang.String-">removeFromEnvironment</a>, <a href="../../../javax/naming/Context.html#rename-javax.naming.Name-javax.naming.Name-">rename</a>, <a href="../../../javax/naming/Context.html#rename-java.lang.String-java.lang.String-">rename</a>, <a href="../../../javax/naming/Context.html#unbind-javax.naming.Name-">unbind</a>, <a href="../../../javax/naming/Context.html#unbind-java.lang.String-">unbind</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="InitialLdapContext--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>InitialLdapContext</h4> <pre>public InitialLdapContext()
                   throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span>构造一个不使用环境属性或连接请求控件的初始上下文。</span>
<span>相当于<tt>new InitialLdapContext(null, null)</tt> 。</span>
</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>
</dl> </li>
</ul> <a name="InitialLdapContext-java.util.Hashtable-javax.naming.ldap.Control:A-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>InitialLdapContext</h4> <pre>public InitialLdapContext(<a href="../../../java/util/Hashtable.html" title="class in java.util">Hashtable</a>&lt;?,?&gt; environment,
                          <a href="../../../javax/naming/ldap/Control.html" title="interface in javax.naming.ldap">Control</a>[] connCtls)
                   throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span>使用环境属性和连接请求控件构造初始上下文。</span>
<span>有关<tt>环境属性</tt>的讨论，请参阅javax.naming.InitialContext。</span>
<p> <span>此构造函数不会修改其参数或保存对它们的引用，但可以保存克隆或副本。</span> <span><tt>environment</tt>传递给<tt>构造函数</tt>后，调用者不应修改可变键和值。</span> </p>
<p> <span><tt>connCtls</tt>用作底层上下文实例的连接请求控件。</span> <span>有关详细信息，请参阅课程说明。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>environment</code> - 用于创建初始DirContext的环境。</span>
<span>空指示空的环境。</span>
</dd>
<dd>
<span><code>connCtls</code> - 初始上下文的连接请求控制。</span>
<span>如果为空，则不使用连接请求控件。</span>
</dd>
<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="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/naming/ldap/InitialLdapContext.html#reconnect-javax.naming.ldap.Control:A-"><code>reconnect(javax.naming.ldap.Control[])</code></a> ， 
            <a href="../../../javax/naming/ldap/LdapContext.html#reconnect-javax.naming.ldap.Control:A-"><code>LdapContext.reconnect(javax.naming.ldap.Control[])</code></a>
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="extendedOperation-javax.naming.ldap.ExtendedRequest-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>extendedOperation</h4> <pre>public <a href="../../../javax/naming/ldap/ExtendedResponse.html" title="interface in javax.naming.ldap">ExtendedResponse</a> extendedOperation(<a href="../../../javax/naming/ldap/ExtendedRequest.html" title="interface in javax.naming.ldap">ExtendedRequest</a> request)
                                   throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/ldap/LdapContext.html#extendedOperation-javax.naming.ldap.ExtendedRequest-">LdapContext</a></code>复制</span>
</div>
<div class="block">
<span>执行扩展操作。</span>
<span>此方法用于支持LDAPv3扩展操作。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/ldap/LdapContext.html#extendedOperation-javax.naming.ldap.ExtendedRequest-">extendedOperation</a></code>在界面 
            <code><a href="../../../javax/naming/ldap/LdapContext.html" title="interface in javax.naming.ldap">LdapContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>request</code> - 要执行的非空请求。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>操作可能为空的响应。</span>
<span>null表示操作没有产生任何响应。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 执行扩展操作时是否发生错误。 
           </dd>
</dl> </li>
</ul> <a name="newInstance-javax.naming.ldap.Control:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>newInstance</h4> <pre>public <a href="../../../javax/naming/ldap/LdapContext.html" title="interface in javax.naming.ldap">LdapContext</a> newInstance(<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 class="descfrmTypeLabel">说明从界面复制： <code><a href="../../../javax/naming/ldap/LdapContext.html#newInstance-javax.naming.ldap.Control:A-">LdapContext</a></code></span>
</div>
<div class="block">
<span>创建使用请求控件初始化的此上下文的新实例。</span>
<span>此方法是为了多线程访问的目的创建此上下文的新实例的便利方法。</span>
<span>例如，如果多个线程想要使用不同的上下文请求控件，则每个线程都可以使用此方法来获取其上下文的自己的副本，并设置/获取上下文请求控件，而不必与其他线程同步。</span>
<p> <span>新上下文具有与上下文相同的环境属性和连接请求控件。</span> <span>有关详细信息，请参阅课程说明。</span> <span>如果这样做，实现也可能允许这个上下文和新的上下文共享相同的网络连接或其他资源，而不会妨碍任一上下文的独立性。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/ldap/LdapContext.html#newInstance-javax.naming.ldap.Control:A-">newInstance</a></code>在界面 
            <code><a href="../../../javax/naming/ldap/LdapContext.html" title="interface in javax.naming.ldap">LdapContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>reqCtls</code> - 用于新上下文的可能的空请求控件。</span>
<span>如果为空，则无需请求控制即可初始化上下文。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个非空的 
            <tt>LdapContext</tt>实例。 
           </dd>
<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="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../javax/naming/ldap/InitialLdapContext.html" title="javax.naming.ldap中的类"><code>InitialLdapContext</code></a></span>
</dd>
</dl> </li>
</ul> <a name="reconnect-javax.naming.ldap.Control:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>reconnect</h4> <pre>public void reconnect(<a href="../../../javax/naming/ldap/Control.html" title="interface in javax.naming.ldap">Control</a>[] connCtls)
               throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/ldap/LdapContext.html#reconnect-javax.naming.ldap.Control:A-">LdapContext</a></code>复制</span>
</div>
<div class="block">
<span>使用提供的控件和此上下文的环境重新连接到LDAP服务器。</span>
<p> <span>此方法是显式启动LDAP“绑定”操作的一种方法。</span> <span>例如，您可以使用此方法设置LDAP“绑定”操作的请求控制，或者显式连接到服务器以获取LDAP“绑定”操作返回的响应控件。</span> </p>
<p> <span>此方法将此上下文的<tt>connCtls</tt>设置为其新的连接请求控件。</span> <span>此上下文的上下文请求控件不受影响。</span> <span>在调用此方法之后，任何后续的隐式重新连接将使用<tt>connCtls</tt>完成。</span> <span><tt>connCtls</tt>也被用作从这个上下文导出的新上下文实例的连接请求控制。</span> <span>这些连接请求控制不受<tt>setRequestControls()的</tt>影响。</span> </p>
<p> <span>服务提供商的实现者应该在类描述中阅读“服务提供者”部分，了解实现细节。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/ldap/LdapContext.html#reconnect-javax.naming.ldap.Control:A-">reconnect</a></code>在界面 
            <code><a href="../../../javax/naming/ldap/LdapContext.html" title="interface in javax.naming.ldap">LdapContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>connCtls</code> - 可能使用的空控件。</span>
<span>如果为空，则不使用控件。</span>
</dd>
<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="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/naming/ldap/LdapContext.html#getConnectControls--"><code>LdapContext.getConnectControls()</code></a> ， 
            <a href="../../../javax/naming/ldap/LdapContext.html#newInstance-javax.naming.ldap.Control:A-"><code>LdapContext.newInstance(javax.naming.ldap.Control[])</code></a>
</dd>
</dl> </li>
</ul> <a name="getConnectControls--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getConnectControls</h4> <pre>public <a href="../../../javax/naming/ldap/Control.html" title="interface in javax.naming.ldap">Control</a>[] getConnectControls()
                             throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/ldap/LdapContext.html#getConnectControls--">LdapContext</a></code>复制</span>
</div>
<div class="block">
<span>检索此上下文的连接请求控件。</span>
<span>控制由JNDI实现所有，并且是不可变的。</span>
<span>调用者都不能修改数组和控件。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/ldap/LdapContext.html#getConnectControls--">getConnectControls</a></code>在界面 
            <code><a href="../../../javax/naming/ldap/LdapContext.html" title="interface in javax.naming.ldap">LdapContext</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>一个可能为空的控件数组。</span>
<span>null表示没有为此上下文设置连接控件。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果在获取请求控件时发生错误。 
           </dd>
</dl> </li>
</ul> <a name="setRequestControls-javax.naming.ldap.Control:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setRequestControls</h4> <pre>public void setRequestControls(<a href="../../../javax/naming/ldap/Control.html" title="interface in javax.naming.ldap">Control</a>[] requestControls)
                        throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/ldap/LdapContext.html#setRequestControls-javax.naming.ldap.Control:A-">LdapContext</a></code>复制</span>
</div>
<div class="block">
<span>设置随后在此上下文中调用的方法的请求控件。</span>
<span>请求控制由JNDI实现拥有，并且是不可变的。</span>
<span>调用者都不能修改数组和控件。</span>
<p> <span>这将删除任何以前的请求控件，并添加<tt>requestControls</tt>以供在此上下文中调用的后续方法使用。</span> <span>此方法不影响此上下文的连接请求控件。</span> </p>
<p> <span>请注意， <tt>requestControls</tt>将在下一次调用setRequestControls()之前<tt>生效</tt> 。</span> <span>您需要显式地调用<tt>setRequestControls()</tt>与<tt>null</tt>或一个空数组来清除控件，如果您不希望它们影响上下文方法。</span> <span>要查看哪些请求控件对此上下文有效，请使用<tt>getRequestControls()</tt> 。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/ldap/LdapContext.html#setRequestControls-javax.naming.ldap.Control:A-">setRequestControls</a></code>在界面 
            <code><a href="../../../javax/naming/ldap/LdapContext.html" title="interface in javax.naming.ldap">LdapContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>requestControls</code> - 可能使用的空控件。</span>
<span>如果为空，则不使用控件。</span>
</dd>
<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="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/naming/ldap/LdapContext.html#getRequestControls--"><code>LdapContext.getRequestControls()</code></a>
</dd>
</dl> </li>
</ul> <a name="getRequestControls--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getRequestControls</h4> <pre>public <a href="../../../javax/naming/ldap/Control.html" title="interface in javax.naming.ldap">Control</a>[] getRequestControls()
                             throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/ldap/LdapContext.html#getRequestControls--">LdapContext</a></code>复制</span>
</div>
<div class="block">
<span>检索对该上下文有效的请求控件。</span>
<span>请求控制由JNDI实现拥有，并且是不可变的。</span>
<span>调用者都不能修改数组和控件。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/ldap/LdapContext.html#getRequestControls--">getRequestControls</a></code>在界面 
            <code><a href="../../../javax/naming/ldap/LdapContext.html" title="interface in javax.naming.ldap">LdapContext</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>一个可能为空的控件数组。</span>
<span>null表示没有为此上下文设置请求控件。</span>
</dd>
<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="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/naming/ldap/LdapContext.html#setRequestControls-javax.naming.ldap.Control:A-"><code>LdapContext.setRequestControls(javax.naming.ldap.Control[])</code></a>
</dd>
</dl> </li>
</ul> <a name="getResponseControls--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getResponseControls</h4> <pre>public <a href="../../../javax/naming/ldap/Control.html" title="interface in javax.naming.ldap">Control</a>[] getResponseControls()
                              throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">描述从界面： <code><a href="../../../javax/naming/ldap/LdapContext.html#getResponseControls--">LdapContext</a></code>复制</span>
</div>
<div class="block">
<span>检索由此上下文调用的最后一个方法生成的响应控件。</span>
<span>响应控制由JNDI实现拥有，并且是不可变的。</span>
<span>调用者都不能修改数组和控件。</span>
<p> <span>这些响应控制可能是由成功或失败的操作生成的。</span> </p>
<p> <span>当调用可能返回响应控件的上下文方法时，将清除来自先前方法调用的响应控制。</span> <span><tt>getResponseControls()</tt>以从LDAP服务器接收的顺序返回由上下文方法使用的LDAP操作生成的所有响应控件。</span> <span>调用<tt>getResponseControls()</tt>不会清除响应控件。</span> <span>您可以多次调用它（并返回相同的控件），直到调用可能返回控件的下一个上下文方法。</span> </p>
<p></p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/ldap/LdapContext.html#getResponseControls--">getResponseControls</a></code>在界面 
            <code><a href="../../../javax/naming/ldap/LdapContext.html" title="interface in javax.naming.ldap">LdapContext</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>一个可能为null的控件数组。</span>
<span>如果为null，则在此上下文中调用的上一个方法没有产生任何控件。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - If an error occurred while getting the response controls. 
           </dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>