模块 java.naming
包 javax.naming.ldap

类 PagedResultsResponseControl

java.lang.Object
javax.naming.ldap.BasicControl
javax.naming.ldap.PagedResultsResponseControl
所有已实现的接口：
Serializable , Control
public final class PagedResultsResponseControl extends BasicControl
表示一批搜索结果的结束。包含对结果集中条目总数的估计和一个不透明的 cookie。必须将 cookie 提供给下一个搜索操作才能获得下一批结果。

PagedResultsControl 中的代码示例显示了如何使用此类。

此类为 RFC 2696 中定义的分页结果实现 LDAPv3 响应控制。控件的值具有以下 ASN.1 定义：

   realSearchControlValue ::= SEQUENCE {
     size   INTEGER (0..maxInt),
              -- requested page size from client
              -- result set size estimate from server
     cookie  OCTET STRING
   }
自从：
1.5
参见：

  • 字段详细信息

    • OID

      public static final String  OID
      分页结果响应控件的分配对象标识符是 1.2.840.113556.1.4.319。
      参见：

  • 构造方法详细信息

    • PagedResultsResponseControl

      public PagedResultsResponseControl(String  id, boolean criticality, byte[] value) throws IOException
      构造分页结果响应控件。
      参数：
      id - 控件的对象标识符字符串。
      criticality - 控件的关键性。
      value - 控件的 ASN.1 BER 编码值。它不是克隆的 - 对值的任何更改都会影响控件的内容。
      抛出：
      IOException - 如果在解码控件的值时遇到错误。

  • 方法详情

    • getResultSize

      public int getResultSize()
      检索（估计）搜索结果中的条目数。
      返回：
      搜索结果中的条目数，如果未知则为零。

    • getCookie

      public byte[] getCookie()
      检索服务生成的 cookie。当没有更多条目可供服务返回时，返回 Null。
      返回：
      服务生成的可能为空的 cookie。它不是克隆的——对 cookie 的任何更改都会更新控件的状态，因此不推荐使用。