compact3

javax.naming.ldap

Interface Control

All Superinterfaces:

Serializable

所有已知实现类：

BasicControl ， ManageReferralControl ， PagedResultsControl ， PagedResultsResponseControl ， SortControl ， SortResponseControl

public interface Control
extends Serializable

此接口表示为在所定义的控制LDAPv3的RFC 2251 。

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

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

从以下版本开始：

1.3

另请参见：

ControlFactory

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	CRITICAL 表示关键控制。
static boolean	NONCRITICAL 表示非关键控制。

方法摘要

Modifier and Type	Method and Description
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编码值的可能的空字节数组。