javax.naming.ldap
介面 Control

所有父級介面：

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 控制元件分派的物件標識符。

返回：

非 null 物件標識符字元串。

isCritical

boolean isCritical()

確定 LDAP 控制元件的關鍵性。伺服器不得忽略關鍵控制元件。換句話說，如果伺服器收到一個它不支持的關鍵控制元件，則無論該控制元件對操作是否有意義，伺服器都將不執行操作並拋出 OperationNotSupportedException。

返回：

如果此控制元件是關鍵的，則返回 true；否則返回 false。

getEncodedValue

byte[] getEncodedValue()

檢索 LDAP 控制元件的 ASN.1 BER 編碼值。結果為原始 BER 位元組，包括控制元件值的標記和長度。它不包括控制元件 OID 和關鍵性。 如果值不存在，則返回 null。

返回：

表示 LDAP 控制元件的 ASN.1 BER 編碼值的位元組陣列（可能為 null）。