compact3

javax.naming.ldap

Interface Control

All Superinterfaces:

Serializable

所有已知实现类：

BasicControl， ManageReferralControl， PagedResultsControl， PagedResultsResponseControl， SortControl， SortResponseControl

public interface Control
extends Serializable

这是一个提升控制接口中定义的 RFC 2251。

的LDAPv3协议使用控制发送和接收更多的数据到预定义的操作行为。控件可以一起发送到服务器的LDAP操作。这些被称为请求控制。例如，一个“排序”的控制，可以发送一个LDAP搜索操作请求的结果是在一个特定的顺序返回。征求和主动控制还可以返回来自服务器的响应。这些控件被称为响应控件。例如，一个LDAP服务器可以定义一个特殊的控制返回更改通知。

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

从以下版本开始：

一点三

另请参见：

ControlFactory

Field Summary

Fields

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

方法摘要

Modifier and Type	Method and Description
byte[]	getEncodedValue() 检索ASN.1 BER编码1的LDAP控制值。
String	getID() 检索标识符指定LDAP控制对象。
boolean	isCritical() 确定LDAP控制临界。

Field Detail

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()

检索ASN.1 BER编码1的LDAP控制值。其结果是原始的比特率字节，包括标签和控件的值的长度。它不包括OID或临界控制。如果值不在，则返回。

结果

一个可能的空字节数组表示ASN.1 BER编码1 LDAP控制值。