Control - Java 11中文版 - API参考文档

API Reference Document

All Superinterfaces:

Serializable

所有已知实现类：

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

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

从以下版本开始：

1.3

另请参见：

ControlFactory

字段汇总

字段
变量和类型	字段	描述
`static boolean`	`CRITICAL`	表示关键控件。
`static boolean`	`NONCRITICAL`	表示非关键控件。

方法摘要

所有方法实例方法抽象方法
变量和类型	方法	描述
`byte[]`	`getEncodedValue()`	检索LDAP控件的ASN.1 BER编码值。
`String`	`getID()`	检索为LDAP控件分配的对象标识符。
`boolean`	`isCritical()`	确定LDAP控件的重要性。

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