225 lines
8.5 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">
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>