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

<div class="header">
<div class="subTitle">
     compact3 
   </div>
<div class="subTitle">
     javax.naming.ldap 
   </div>
<h2 class="title" title="Interface Control">Interface Control</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
         All Superinterfaces: 
       </dt>
<dd>
<span><a href="../../../java/io/Serializable.html" title="java.io中的接口">Serializable</a></span>
</dd>
</dl>
<dl>
<dt>
        所有已知实现类：
       </dt>
<dd>
<span><a href="../../../javax/naming/ldap/BasicControl.html" title="javax.naming.ldap中的类">BasicControl</a> ， <a href="../../../javax/naming/ldap/ManageReferralControl.html" title="javax.naming.ldap中的类">ManageReferralControl</a> ， <a href="../../../javax/naming/ldap/PagedResultsControl.html" title="javax.naming.ldap中的类">PagedResultsControl</a> ， <a href="../../../javax/naming/ldap/PagedResultsResponseControl.html" title="javax.naming.ldap中的类">PagedResultsResponseControl</a> ， <a href="../../../javax/naming/ldap/SortControl.html" title="javax.naming.ldap中的类">SortControl</a> ， <a href="../../../javax/naming/ldap/SortResponseControl.html" title="javax.naming.ldap中的类">SortResponseControl</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">Control</span>
extends <a href="../../../java/io/Serializable.html" title="interface in java.io">Serializable</a></pre>
<div class="block">
<span>此接口表示为在所定义的控制LDAPv3的<a href="http://www.ietf.org/rfc/rfc2251.txt">RFC 2251</a> 。</span>
<p> <span>LDAPv3协议使用控件来发送和接收附加数据以影响预定义操作的行为。</span> <span>控件可以与任何LDAP操作一起发送到服务器。</span> <span>这些被称为<em>请求控件</em> 。</span> <span>例如，可以使用LDAP搜索操作发送“排序”控件，以请求以特定顺序返回结果。</span> <span>被请求和未经请求的控件也可以从服务器的响应返回。</span> <span>这种控制被称为<em>响应控制</em> 。</span> <span>例如，LDAP服务器可能会定义一个特殊控件来返回更改通知。</span> </p>
<p> <span>此接口用于表示请求和响应控件。</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/ControlFactory.html" title="javax.naming.ldap中的类"><code>ControlFactory</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>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Field Summary table, listing fields, and an explanation">
<caption>
<span>Fields</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Field and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/ldap/Control.html#CRITICAL">CRITICAL</a></span></code>
<div class="block">
              表示关键控制。 
            </div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/ldap/Control.html#NONCRITICAL">NONCRITICAL</a></span></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="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>byte[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/ldap/Control.html#getEncodedValue--">getEncodedValue</a></span>()</code>
<div class="block">
              检索LDAP控制的ASN.1 BER编码值。 
            </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="../../../javax/naming/ldap/Control.html#getID--">getID</a></span>()</code>
<div class="block">
              检索分配给LDAP控件的对象标识符。 
            </div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/ldap/Control.html#isCritical--">isCritical</a></span>()</code>
<div class="block">
              确定LDAP控件的关键性。 
            </div> </td>
</tr>
</tbody>
</table> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ FIELD DETAIL =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.detail">
<!-- --> </a> <h3>字段详细信息</h3> <a name="CRITICAL">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>CRITICAL</h4> <pre>static final boolean CRITICAL</pre>
<div class="block">
<span>表示关键控制。</span>
<span>该常数的值为<tt>true</tt> 。</span>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../constant-values.html#javax.naming.ldap.Control.CRITICAL">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="NONCRITICAL">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>NONCRITICAL</h4> <pre>static final boolean NONCRITICAL</pre>
<div class="block">
<span>表示非关键控制。</span>
<span>该常数的值为<tt>false</tt> 。</span>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../constant-values.html#javax.naming.ldap.Control.NONCRITICAL">Constant Field Values</a>
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getID--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getID</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getID()</pre>
<div class="block">
            检索分配给LDAP控件的对象标识符。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             非空对象标识符字符串。 
           </dd>
</dl> </li>
</ul> <a name="isCritical--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isCritical</h4> <pre>boolean isCritical()</pre>
<div class="block">
<span>确定LDAP控件的关键性。</span>
<span>服务器不能忽视关键控件。</span>
<span>换句话说，如果服务器接收到不支持的关键控制，无论控制是否对操作有意义，则不会执行操作，并且将抛出<tt>OperationNotSupportedException</tt> 。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>如果这个控制是关键的;</span>
<span>否则为假。</span>
</dd>
</dl> </li>
</ul> <a name="getEncodedValue--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getEncodedValue</h4> <pre>byte[] getEncodedValue()</pre>
<div class="block">
<span>检索LDAP控制的ASN.1 BER编码值。</span>
<span>结果是原始BER字节包括标签和控件值的长度。</span>
<span>它不包括控件OID或关键性。</span>
<span>如果值不存在则返回空值。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             表示LDAP控件的ASN.1 BER编码值的可能的空字节数组。 
           </dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>