模块 java.naming
包 javax.naming.ldap

接口 Control

所有父级接口：
Serializable
所有已知的实现类：
BasicControl , ManageReferralControl , PagedResultsControl , PagedResultsResponseControl , SortControl , SortResponseControl
public interface Control extends Serializable
此接口表示 RFC 2251 中定义的 LDAPv3 控件。

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

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

自从：
1.3
参见：

  • 字段摘要

    字段
    修饰符和类型
    Field
    描述
    static final boolean
    CRITICAL
    表示关键控制。
    static final 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。
      返回：
      如果此控件至关重要，则为真；否则为假。

    • getEncodedValue

      byte[] getEncodedValue()
      检索 LDAP 控件的 ASN.1 BER 编码值。结果是原始 BER 字节，包括控件值的标记和长度。它不包括控件 OID 或关键性。如果该值不存在，则返回 Null。
      返回：
      表示 LDAP 控件的 ASN.1 BER 编码值的可能为空的字节数组。