Module  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
    • Field Summary

      Fields  
      Modifier and Type Field 描述
      static boolean CRITICAL
      表示关键控制。
      static boolean NONCRITICAL
      表示非关键控制。
    • 字段详细信息

      • 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编码值的可能的空字节数组。