Control (Java SE 9 & JDK 9 )

All Superinterfaces:

Serializable

所有已知实现类：

BasicControl ， ManageReferralControl ， PagedResultsControl ， PagedResultsResponseControl ， SortControl ， SortResponseControl
```
public interface Control
extends Serializable
```
此接口表示RFC 2251中定义的LDAPv3控件。
LDAPv3协议使用控件来发送和接收附加数据以影响预定义操作的行为。控件可以与任何LDAP操作一起发送到服务器。这些被称为请求控件 。例如，可以使用LDAP搜索操作发送“排序”控件，以请求以特定顺序返回结果。被请求和未经请求的控件也可以从服务器的响应返回。这种控制被称为响应控制 。例如，LDAP服务器可能会定义一个特殊控件来返回更改通知。

此接口用于表示请求和响应控件。

从以下版本开始：

1.3

另请参见：

ControlFactory

Field Summary

Fields
Modifier and Type	Field	描述
`static boolean`	`CRITICAL`	表示关键控制。
`static boolean`	`NONCRITICAL`	表示非关键控制。

方法摘要

所有方法接口方法抽象方法
Modifier and Type	方法	描述
`byte[]`	`getEncodedValue()`	检索LDAP控制的ASN.1 BER编码值。
`String`	`getID()`	检索分配给LDAP控件的对象标识符。
`boolean`	`isCritical()`	确定LDAP控件的关键性。

- 字段详细信息
  - CRITICAL
```
static final boolean CRITICAL
```
    表示关键控制。该常数的值为true 。
    
    另请参见：
    
    Constant Field Values
  - NONCRITICAL
```
static final boolean NONCRITICAL
```
    表示非关键控制。该常数的值为false 。
    
    另请参见：
    
    Constant Field Values
- 方法详细信息
  - getID
```
String getID()
```
    检索分配给LDAP控件的对象标识符。
    
    结果
    
    非空对象标识符字符串。
  - isCritical
```
boolean isCritical()
```
    确定LDAP控件的关键性。服务器不能忽视关键控件。换句话说，如果服务器接收到不支持的关键控制，无论控制是否对操作有意义，则不会执行操作，并且将抛出OperationNotSupportedException 。
    
    结果
    
    如果这个控制是关键的; 否则为假。
  - getEncodedValue
```
byte[] getEncodedValue()
```
    检索LDAP控制的ASN.1 BER编码值。结果是原始BER字节包括标签和控件值的长度。它不包括控件OID或关键性。如果值不存在则返回空值。
    
    结果
    
    表示LDAP控件的ASN.1 BER编码值的可能的空字节数组。