モジュール java.naming
パッケージ 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
    関連項目:
    PagedResultsControl, 直列化された形式

    • フィールドの詳細

      • 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を変更することは推奨しない。