クラスPagedResultsResponseControl

java.lang.Object
javax.naming.ldap.BasicControl
javax.naming.ldap.PagedResultsResponseControl
すべての実装されたインタフェース:
Serializable, Control
public final class PagedResultsResponseControl extends BasicControl
1セットの検索結果が終了したことを示します。 この結果セットにある合計エントリ数の推定値と、不透明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()
      この検索結果にあるエントリ数(推定値)を取得します。
      戻り値:
      この検索結果にあるエントリ数。不明な場合は0。

    • getCookie

      public byte[] getCookie()
      サーバーで生成されたCookieを取得します。 サーバーにそれ以上エントリがないときは、nullが返されます。
      戻り値:
      サーバーで生成されたCookie。nullの場合もある。 これは複製されないので、このCookieを変更するとコントロールの状態が更新される。したがって、Cookieを変更することは推奨しない。