モジュール 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

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
• 直列化された形式

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
static final String	OID	ページごとに区切られた結果の応答コントロールに割り当てられているオブジェクト識別子は1.2.840.113556.1.4.319です。

クラスjavax.naming.ldap.BasicControlで宣言されたフィールド

criticality, id, value

インタフェースjavax.naming.ldap.Controlで宣言されているフィールド

CRITICAL, NONCRITICAL

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
PagedResultsResponseControl(String id, boolean criticality, byte[] value)	ページごとに区切られた結果の応答コントロールを構築します。

メソッドのサマリー

修飾子と型	メソッド	説明
byte[]	getCookie()	サーバーで生成されたCookieを取得します。
int	getResultSize()	この検索結果にあるエントリ数(推定値)を取得します。

クラスjavax.naming.ldap.BasicControlで宣言されたメソッド

getEncodedValue, getID, isCritical

クラスjava.lang.Objectで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールド詳細

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