模块  java.naming
软件包  javax.naming.ldap

Interface Control

  • All Superinterfaces:
    Serializable
    所有已知实现类:
    BasicControlManageReferralControlPagedResultsControlPagedResultsResponseControlSortControlSortResponseControl

    public interface Control
    extends Serializable
    此接口表示RFC 2251中定义的LDAPv3控件。

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

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

    从以下版本开始:
    1.3
    另请参见:
    ControlFactory
    • 字段汇总

      字段  
      变量和类型 字段 描述
      static boolean CRITICAL
      表示关键控件。
      static boolean NONCRITICAL
      表示非关键控件。
    • 字段详细信息

      • 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编码值。