javax.sql.rowset

インタフェース CachedRowSet

すべてのスーパーインタフェース:

AutoCloseable、Joinable、ResultSet、RowSet、Wrapper

既知のすべてのサブインタフェース:

FilteredRowSet、JoinRowSet、WebRowSet

public interface CachedRowSet
extends RowSet, Joinable

CachedRowSet のすべての標準実装が実装しなければならないインタフェースです。

Oracle Corporation から提供された CachedRowSet インタフェースのリファレンス実装は、標準実装です。開発者はこれをそのまま使用することも、拡張することも、またはこのインタフェースの実装を独自に作成することもできます。

CachedRowSet オブジェクトは、メモリー内に行をキャッシュする、データ行のコンテナであり、常にそのデータソースに接続していなくても処理を実行できます。また、スクロール、更新、直列化が可能な JavaBeans^TM コンポーネントです。CachedRowSet オブジェクトには、通常、結果セットの行が格納されますが、スプレッドシートなど、表形式のあらゆるファイルの行を格納することもできます。リファレンス実装は、ResultSet オブジェクトからのデータの取得しかサポートしませんが、開発者は、その他の表形式のデータソースにアクセスできるように、SyncProvider 実装を拡張することができます。

アプリケーションは、CachedRowSet オブジェクト内のデータを変更できます。これらの変更は、データソースにも反映されます。

CachedRowSet オブジェクトは未接続の行セットです。つまり、データソースとの接続を少ししか利用しません。CachedRowSet オブジェクトがデータソースに接続するのは、データを読み取って自身に行を読み込むときと、配下のデータソースに変更内容を反映するときだけです。それ以外のときは、CachedRowSet オブジェクトはデータの変更中も含めて、データソースから切断されています。RowSet オブジェクトは、このように、データソースから切断されているためムダが少なく、その他のコンポーネントに渡しやすくなっています。たとえば、未接続の RowSet オブジェクトを直列化し、回線経由で PDA などの thin クライアントに渡すことができます。

1.0 CachedRowSet オブジェクトの作成

次のコードは、リファレンス実装 (RI) の CachedRowSet のデフォルトコンストラクタを使用して、デフォルトの CachedRowSet オブジェクトを作成します。

     CachedRowSetImpl crs = new CachedRowSetImpl();
 

この新しい CachedRowSet オブジェクトは、そのプロパティーを BaseRowSet オブジェクトのデフォルトのプロパティーに設定します。さらに、同期プロバイダとして RIOptimisticProvider オブジェクトを持ちます。RI に含まれる 2 つの SyncProvider 実装のうちの 1 つ、RIOptimisticProvider は、同期プロバイダが指定されていない場合に SyncFactory シングルトンから提供されるデフォルトのプロバイダです。

SyncProvider オブジェクトは、CachedRowSet オブジェクトと、データソースからデータを読み取って自身にデータを読み込むリーダー (RowSetReader オブジェクト) を提供します。リーダーを実装することにより、ResultSet オブジェクトや表形式のファイルからデータを読み取ることができます。SyncProvider オブジェクトは、ライター (RowSetWriter オブジェクト) も提供します。ライターは、配下のデータソース内のデータから切断されている間に CachedRowSet オブジェクトに加えられた変更内容を同期します。

ライターを実装することにより、さまざまなレベルで、行セットに値を読み込んだあとでデータソース内の値が変更された場合に発生する競合のチェックや予防を行うことができます。RIOptimisticProvider 実装は、競合がほとんどないか、まったくないものとして、ロックを一切設定しません。この実装は、競合がない場合にのみ、CachedRowSet オブジェクトの値でデータソースを更新します。変更されたデータをデータソースへ書き込む目的でのみ実装されるライターもあります。この実装は、競合のチェックを行わないか、そのまったく逆で、データソース内のデータの変更を十分防げるだけのロックを設定することによって行われます。また、そのほぼ中間のライター実装もあります。

CachedRowSet オブジェクトは、SyncFactory シングルトンに登録された任意の SyncProvider 実装を使用できます。アプリケーションは、次のコードを呼び出すことにより、登録されている SyncProvider 実装を検出できます。

      java.util.Enumeration providers = SyncFactory.getRegisteredProviders();
 

CachedRowSet オブジェクトで使用する SyncProvider オブジェクトを指定する方法は、次の 2 とおりです。 コンストラクタに実装名を提供する
次のコードは、デフォルト値 (ただし SyncProvider を指定) で初期化される CachedRowSet オブジェクト crs2 を作成します。

          CachedRowSetImpl crs2 = new CachedRowSetImpl(
                                 "com.fred.providers.HighAvailabilityProvider");
     

CachedRowSet メソッド setSyncProvider を使って SyncProvider を設定する
次のコードは、crs の SyncProvider オブジェクト (デフォルトのコンストラクタで作成された CachedRowSet オブジェクト) をリセットします。

           crs.setSyncProvider("com.fred.providers.HighAvailabilityProvider");
      

SyncFactory および SyncProvider を参照してください。

2.0 CachedRowSet オブジェクトからのデータの取得

データは、ResultSet インタフェースから継承された取得メソッドを使って、CachedRowSet オブジェクトから取得されます。次の例は、crs を CachedRowSet オブジェクトとして行の繰り返し処理を行い、各行から列の値を取得する方法を示します。最初の例では、列番号を取る取得メソッドを使用します。2 番目の例では、列名を取る取得メソッドを使用します。列番号は、通常、RowSet オブジェクトのコマンドが SELECT * FROM TABLENAME の形式になる場合に使用されます。列名は、列名を指定するコマンドでよく使用されます。

    while (crs.next()) {
        String name = crs.getString(1);
        int id = crs.getInt(2);
        Clob comment = crs.getClob(3);
        short dept = crs.getShort(4);
        System.out.println(name + "  " + id + "  " + comment + "  " + dept);
    }
 

    while (crs.next()) {
        String name = crs.getString("NAME");
        int id = crs.getInt("ID");
        Clob comment = crs.getClob("COM");
        short dept = crs.getShort("DEPT");
        System.out.println(name + "  " + id + "  " + comment + "  " + dept);
    }
 

2.1 RowSetMetaData の取得

アプリケーションは、RowSetMetaData オブジェクト上に ResultSetMetaData メソッドと RowSetMetaData メソッドを呼び出すことにより、CachedRowSet オブジェクト内の列に関する情報を取得できます。次のコードの抜粋では、crs を CachedRowSet オブジェクトとして、この処理について説明します。1 行目では、crs 内の列に関する情報を持つ RowSetMetaData オブジェクトを作成します。ResultSet インタフェースから継承された getMetaData メソッドは、ResultSetMetaData オブジェクトを返します。返されたオブジェクトは、変数 rsmd に割り当てられる前に RowSetMetaData オブジェクトにキャストされます。2 行目では、jrs の列数を確認します。3 行目では、jrs の 2 番目の列に格納された値の JDBC 型を取得します。

     RowSetMetaData rsmd = (RowSetMetaData)crs.getMetaData();
     int count = rsmd.getColumnCount();
     int type = rsmd.getColumnType(2);
 

RowSetMetaData インタフェースは、次の 2 つの点で、ResultSetMetaData インタフェースとは異なっています。

• setter メソッドを含む:RowSetオブジェクトは、別の ResultSet オブジェクトのデータを読み込む際、これらのメソッドを内部で使用します。

• 含まれる getter メソッドの数が少ない: 一部の ResultSetMetaData メソッドは RowSet オブジェクトには適用されません。たとえば、列の値が書き込み可能であるか読み取り専用であるかを確認するメソッドは適用されません。これは、RowSet オブジェクトのすべての列は、行セットの更新が可能な場合は書き込み可能、行セットの更新ができない場合は読み取り専用であるからです。

注: RowSetMetaData オブジェクトを返すためには、実装で java.sql.ResultSet に定義された getMetaData() メソッドをオーバーライドし、RowSetMetaData オブジェクトを返す必要があります。

3.0 CachedRowSet オブジェクトの更新

CachedRowSet オブジェクトの更新方法は ResultSet オブジェクトの更新方法と同様ですが、更新中、行セットはデータソースに接続していないので、配下のデータソースに変更を加える追加手順が必要になります。CachedRowSet オブジェクトは、updateRow メソッドか insertRow メソッドを呼び出したあと、acceptChanges メソッドを呼び出して、更新内容をデータソースに書き込む必要があります。次の例では、CachedRowSet オブジェクト crs 内の行にカーソルが置かれています。このコードは、現在の行の 2 つの列の値を更新し、RowSet オブジェクトの配下のデータソースを更新します。

     crs.updateShort(3, 58);
     crs.updateInt(4, 150000);
     crs.updateRow();
     crs.acceptChanges();
 

次の例では、挿入行に移動し、挿入行の上に新しい行を作成して、これを行セットに挿入します。さらに、acceptChanges メソッドを呼び出して、配下のデータソースに新しい行を追加します。取得メソッドの場合と同様に、更新メソッドでも、列インデックスか列名を使って処理対象の列を指定できます。

     crs.moveToInsertRow();
     crs.updateString("Name", "Shakespeare");
     crs.updateInt("ID", 10098347);
     crs.updateShort("Age", 58);
     crs.updateInt("Sal", 150000);
     crs.insertRow();
     crs.moveToCurrentRow();
     crs.acceptChanges();
 

注: insertRow() メソッドで、CachedRowSet オブジェクトの挿入行の内容を挿入する場所は、実装で定義します。CachedRowSet インタフェースのリファレンス実装は、現在の行の直後に新しい行を挿入しますが、ほかの任意の箇所にも挿入するように実装できます。

これらの例における acceptChanges メソッドの使用方法に注目してください。このメソッドは、RowSet オブジェクトのライターを内部で呼び出し、データソースに変更を書き込むことにより、CachedRowSet オブジェクト内の変更内容を配下のデータソースへ伝達します。このために、ライターは、データソースとの接続を確立しなければいけません。最初の 2 つのコードの抜粋は、updateRowまたは insertRow の呼び出し後ただちに acceptChanges メソッドを呼び出します。しかし、複数の行を変更する場合は、updateRow と insertRow の呼び出しがすべて完了してから acceptChanges を呼び出す方法のほうが効率がよくなります。acceptChanges を 1 回しか呼び出さない場合は、接続を 1 つ確立するだけで済みます。

4.0 配下のデータソースの更新

acceptChanges メソッドの実行時には、行セットへの変更点を配下のデータソースへ書き込むため、背後で CachedRowSet オブジェクトのライター、RowSetWriterImpl オブジェクトが呼び出されます。このライターが実装されることにより、データソースへの接続が確立され、更新情報が書き込まれます。

ライターは、セクション 1 の「CachedRowSet オブジェクトの作成」で説明したとおり、SyncProvider インタフェースの実装を介して利用できます。デフォルトのリファレンス実装プロバイダ RIOptimisticProvider は、オプティミスティック並行処理制御メカニズムを利用するため、ライターを実装しています。つまり、行セットがデータベースから切断されている間、配下のデータベースはロックされず、データソースへデータを書き込む前に競合がないかどうかの確認が行われるだけとなります。競合がある場合、データソースへは何も書き込まれません。

SyncProvider クラスによって提供されるリーダー/ライターの機能は、プラグイン可能であり、データの取得と更新のカスタマイズに利用できます。別の並行処理制御メカニズムが必要な場合は、setSyncProvider メソッドを使って、別の SyncProvider 実装をプラグインできます。

オプティミスティック並行処理制御ルーチンを使用するため、RIOptismisticProvider は、現在の値と元の値 (現在の値の直前の値) の両方を保持します。RowSet オブジェクト内のデータが変更されなかった場合、現在の値と元の値は同一 (RowSet オブジェクトが最初に生成されたときの値) になります。しかし、RowSet オブジェクト内の値が変更された場合、現在の値と元の値は一致しません。この段階では、元の値は初期値のままです。その後の RowSet オブジェクト内のデータの変更により、元の値と現在の値は一致しなくなりますが、以前現在の値だった値が元の値になります。

元の値を追跡することで、ライターは、RowSet オブジェクトの元の値とデータベース内の値を比較できます。データベース内の値が RowSet オブジェクトの元の値と一致しない場合、データベース内の値が変更されており、競合が発生していることを意味します。ライターを使って競合のチェックを行うか、どの程度までチェックを行うか、競合をどのように処理するかは、すべて実装によって異なります。

5.0 リスナーの登録と通知

JavaBeans コンポーネントなので、すべての行セットは、BaseRowSet クラスからリスナーの登録と、変更内容を通知するためのメソッドを継承して、JavaBeans イベントモデルに参与します。CachedRowSet オブジェクトのリスナーは、行セット内に変更があったかどうかを通知されるコンポーネントです。たとえば、CachedRowSet オブジェクトにクエリーの結果が含まれ、これらの結果が表や棒グラフとして表示されるとします。表や棒グラフは、行セットのリスナーとして登録されることで、変更内容を反映するよう自身の更新を行うことができます。表および棒グラフのクラスがリスナーになるには、RowSetListener インタフェースを実装する必要があります。その後、これらを CachedRowSet オブジェクトのリスナーのリストに追加します。次のコードを参照してください。

    crs.addRowSetListener(table);
    crs.addRowSetListener(barGraph);
 

カーソルを移動したり、データを変更したりする CachedRowSet メソッドも、登録済みのリスナーに変更を通知します。したがって、crs 内に変更があると、table と barGraph はその通知を受けます。

6.0 thin クライアントへのデータの送信

CachedRowSet オブジェクトは、主に、アプリケーションコンポーネント間でのデータの受け渡しに利用されます。CachedRowSet オブジェクトは直列化可能なので、たとえば、サーバー環境で稼動中のエンタープライズ JavaBeans コンポーネントによって実行されたクエリーの結果を、Web ブラウザで稼動中のクライアントに、ネットワーク経由で送信するために利用することができます。

未接続の CachedRowSet オブジェクトは、同じデータを持つ ResultSet オブジェクトよりもコンパクトなので、リソースの制限やセキュリティー上の理由により JDBC ドライバを使用するのが難しい PDA などの thin クライアントへのデータ送信に最適です。このように、CachedRowSet オブジェクトでは、JDBC API を完全に実装しなくても行を取得できます。

7.0 スクロールと更新

CachedRowSet オブジェクトには、スクロール機能や更新機能を持たない ResultSet オブジェクトにこれらの機能を提供する働きもあります。DBMS がスクロールと更新の機能を完全にサポートしない場合は、CachedRowSet オブジェクトを使って、JDBC テクノロジを使用可能なドライバの機能を向上させることができます。スクロール機能を持たない読み取り専用の ResultSet オブジェクトにスクロール機能と更新機能を持たせるには、CachedRowSet オブジェクトを作成して、その ResultSet オブジェクトのデータを読み込むだけで済みます。具体例については、次のコードの抜粋を参照してください。この例では、stmt は Statement オブジェクトを表します。

    ResultSet rs = stmt.executeQuery("SELECT * FROM EMPLOYEES");
    CachedRowSetImpl crs = new CachedRowSetImpl();
    crs.populate(rs);
 

rs オブジェクトの場合と同様に、crs オブジェクトに、表 EMPLOYEES のデータが追加されます。ただし、crs のカーソルは前方、後方、または特定の行に移動できるのに対して、rs のカーソルは前方にしか移動できません。また、crs に更新機能があるのに対して、rs には更新機能はありません。これは、CachedRowSet オブジェクトに、スクロール機能と更新機能がデフォルトで用意されているからです。

つまり、CachedRowSet オブジェクトは、データソースの外部でキャッシュされる未接続の行になります。サイズが小さく、直列化可能なので、回線経由で簡単に送信できるだけでなく、thin クライアントへのデータ送信にも適しています。ただし、メモリー内に同時に格納できるデータ量が決まっているため、CachedRowSet オブジェクトのサイズは制限されています。

8.0 汎用データアクセスの取得

CachedRowSet クラスには、リレーショナルデータベース以外のソースからデータを取得し、格納できるという利点があります。行セットのリーダーを実装することにより、任意の表形式のデータソース (スプレッドシート、フラットファイルを含む) 行セットのデータを読み取り、読み込みできます。CachedRowSet オブジェクトとそのメタデータは、いずれもゼロから作成可能なので、行セットのファクトリとして機能するコンポーネントは、この機能を利用して、非 SQL データソースからデータを含む行セットを作成できます。しかし、ほとんどの場合、CachedRowSet オブジェクトは、JDBC API を使って SQL データベースから取得したデータを格納します。

9.0 プロパティーの設定

すべての行セットは、プロパティーのセットを持っています。このセットは通常、ツールを使って設定します。行セットのプロパティーの数と種類は、行セットの機能とデータの取得方法によって異なります。たとえば、ResultSet オブジェクトからデータを取得する行セットは、データベース接続を作成するために必要なプロパティーを設定する必要があります。行セットが DriverManager 機能を使って接続を作成する場合は、適切なドライバを識別する JDBC URL のプロパティーと、ユーザー名とパスワードを指定するプロパティーを設定する必要があります。一方、行セットが DataSource オブジェクトを使って接続を作成する場合 (この方法が優先される) は、JDBC URL のプロパティーを設定する必要はありません。代わりに、データソースの論理名のプロパティーとユーザー名およびパスワードのプロパティーを設定する必要があります。

注: DataSource オブジェクトを使って接続を作成する場合は、Java Naming and Directory Interface^TM (JNDI) API を使用するネームサービスに、DataSource オブジェクトを登録する必要があります。登録は通常、システム管理者が行います。

行セットにデータベースのデータを読み込むには、コマンドプロパティーを設定する必要があります。このプロパティーは、PreparedStatement オブジェクトを表すクエリーです。これにより、クエリーは、設計時ではなく実行時に設定されるパラメータプレースホルダを持つことができます。これらのプレースホルダパラメータに値を設定するため、行セットは、各データ型の値を設定する設定メソッドを提供します。これらの設定メソッドは、PreparedStatement インタフェースによって提供される設定メソッドとよく似ています。

次のコードの抜粋は、CachedRowSet オブジェクト crs にコマンドプロパティーを設定する方法を示しています。ツールを使ってプロパティーを設定する場合、このコードを使用します。

    crs.setCommand("SELECT FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS " +
                   "WHERE CREDIT_LIMIT > ? AND REGION = ?");
 

コマンドのプレースホルダパラメータの設定に使用される値は、RowSet オブジェクトの params フィールドに、Vector オブジェクトとして格納されます。CachedRowSet クラスは、params フィールド内の要素を設定する設定メソッドのセットを提供します。次のコードの抜粋は、先ほどの例で、クエリー内の 2 つのパラメータを設定する方法を示しています。

    crs.setInt(1, 5000);
    crs.setString(2, "West");
 

params フィールドに 2 つの要素が追加されました。これらはそれぞれ、要素 2 つ分の長さの配列になります。最初の要素はパラメータ番号、2 番目の要素は設定する値を表します。この場合、params の最初の要素は 1、5000、2 番目の要素は 2、"West" になります。アプリケーションは、execute メソッドを呼び出すことにより、この RowSet オブジェクトのリーダーを呼び出します。これにより、その readData メソッドが呼び出されます。この実装に含まれる readData は、params 内の値を取得し、これらを使ってコマンドのプレースホルダパラメータを設定します。次のコードの抜粋では、Connection オブジェクト con の取得後に、リーダーがプレースホルダパラメータを設定する手順を示します。

    PreparedStatement pstmt = con.prepareStatement(crs.getCommand());
    reader.decodeParams();
    // decodeParams figures out which setter methods to use and does something
    // like the following:
    //    for (i = 0; i < params.length; i++) {
    //        pstmt.setObject(i + 1, params[i]);
    //    }
 

この時点で、crs のコマンドは、クエリー "SELECT FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS WHERE CREDIT_LIMIT > 5000 AND REGION = "West" になります。readData メソッドは、次のコードでこのコマンドを実行することにより、crs に読み込まれる rs のデータを取得します。

     ResultSet rs = pstmt.executeQuery();
 

前のコードの抜粋では、背後で行われる処理について説明しました。これらのコードは、アプリケーション内では非表示であり、readData や decodeParams などのメソッドを呼び出しません。これに対して、次のコードの抜粋は、アプリケーションの実行内容を示しています。このコードでは、行セットのコマンドを設定し、コマンドのパラメータを設定し、コマンドを実行します。execute メソッドを呼び出すだけで、crs に、要求された表 CUSTOMERS のデータが読み込まれます。

    crs.setCommand("SELECT FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS" +
                   "WHERE CREDIT_LIMIT > ? AND REGION = ?");
    crs.setInt(1, 5000);
    crs.setString(2, "West");
    crs.execute();
 

10.0 ページングデータ

CachedRowSet オブジェクトはデータをメモリーに格納するため、一度に格納できるデータの量は使用可能なメモリーの量によって決まります。この制限を回避するため、CachedRowSet オブジェクトでは、ResultSet オブジェクトからページと呼ばれるチャンクで、データを取得できます。このメカニズムを利用するには、アプリケーションで、setPageSize メソッドを使用して、ページに含める行数を設定します。つまり、ページサイズを 5 に設定している場合、データソースから一度に 5 行のデータのチャンクがフェッチされます。また、アプリケーションでは、オプションで、一度にフェッチできる最大行数も設定できます。最大行数を 0 に設定した場合、または最大行数を設定しない場合、一度にフェッチ可能な行数の制限はありません。

プロパティーの設定後、CachedRowSet オブジェクトに、populate または execute メソッドを使用して、データを格納する必要があります。次のコード行に、populate メソッドを使用した例を示します。このメソッドでは、ResultSet ハンドルと、行の取得を開始する ResultSet オブジェクト内の行の 2 つのパラメータをとります。

     CachedRowSet crs = new CachedRowSetImpl();
     crs.setMaxRows(20);
     crs.setPageSize(4);
     crs.populate(rsHandle, 10);
 

このコードを実行すると、crs に rsHandle の 10 行目から始まる 4 行分が格納されます。

次のコードの抜粋に execute メソッドを使用して、CachedRowSet オブジェクトに格納する例を示します。このメソッドはパラメータとして Connection オブジェクトをとる場合ととらない場合があります。このコードでは execute に Connection オブジェクト conHandle を渡しています。

次のコードの抜粋と上記のコードには 2 つの違いがあります。まず、setMaxRows メソッドを呼び出していないため、crs に格納できる最大行数に制限がありません。(crs には常に、メモリー内に格納できるデータ量の制限が最優先で存在することに注意してください)。2 点目の違いは execute メソッドに、行の取得を開始する ResultSet オブジェクト内からの行番号を渡せないことです。このメソッドは常に先頭行から開始します。

     CachedRowSet crs = new CachedRowSetImpl();
     crs.setPageSize(5);
     crs.execute(conHandle);
 

このコードを実行すると、crs に対するコマンドによって生成された ResultSet オブジェクトから 5 行分のデータが crs に格納されます。crs ライターは conHandle を使用してデータソースに接続し、crs に対してコマンドを実行します。これにより、アプリケーションは、ほかの CachedRowSet オブジェクトのデータの操作と同じように crs のデータを操作できます。

アプリケーションで次のページ (データのチャンク) にアクセスするには、nextPage メソッドを呼び出します。このメソッドは新しい CachedRowSet オブジェクトを作成し、それに次のページのデータを格納します。たとえば、CachedRowSet オブジェクトのコマンドが 1000 行分のデータを格納する ResultSet オブジェクト rs を返したとします。ページサイズが 100 に設定されている場合、nextPage メソッドの最初の呼び出しで、rs の先頭の 100 行を格納する CachedRowSet オブジェクトが作成されます。この先頭の 100 行のデータの処理が終わったら、アプリケーションはふたたび nextPage メソッドを呼び出して、rs から次の 100 行を格納する別の CachedRowSet オブジェクトを作成できます。最初の CachedRowSet オブジェクトのデータは、2 番目の CachedRowSet オブジェクトのデータに置き換えられているため、メモリー内に残っていません。nextPage メソッドの 10 回目の呼び出しでは、10 番目の CachedRowSet オブジェクトに rs からの最後の 100 行のデータが格納され、これらがメモリーに格納されます。常にメモリーには、1 つの CachedRowSet オブジェクトのデータだけが格納されることになります。

nextPage メソッドは、現在のページが行の最後のページでない間は true を返し、それ以降のページがなくなると false を返します。したがって、次のコード行に示すように、while ループで使用すれば、すべてのページを取得できます。

     CachedRowSet crs = CachedRowSetImpl();
     crs.setPageSize(100);
     crs.execute(conHandle);

     while(crs.nextPage()) {
         while(crs.next()) {
             . . . // operate on chunks (of 100 rows each) in crs,
                   // row by row
         }
     }
 

このコードの抜粋を実行すると、アプリケーションは 1000 行をすべてトラバースしますが、メモリーには一度に 100 行までしか格納されません。

CachedRowSet インタフェースは previousPage メソッドも定義しています。nextPage メソッドが ResultSet の next メソッドに類似しているのと同様、previousPage メソッドは ResultSet の previous メソッドに似ています。nextPage メソッドと同様に、previousPage はページサイズとして設定されただけの行数を格納する CachedRowSet オブジェクトを作成します。そのため、たとえば、上記のコードの抜粋の最後の while ループ内で previousPage メソッドを使用して、最後のページから先頭のページまで、逆にページを移動することができます。previousPage メソッドは、while ループで使用できる点で nextPage とも似ています。ただし、前に別のページが存在する間 true を返し、それ以前のページがなくなると、false を返す点が異なります。

次のコードの抜粋に示すように、previous メソッドは各ページの最後の行の末尾にカーソルを置くことにより、各ページの最終行から先頭行まで移動します。もしくは、各ページの先頭行の前にカーソルを置き、while ループで next メソッドを使用して、各ページの先頭行から最終行まで移動することもできます。

次のコードの抜粋では、上記のコードの抜粋の続きで、10 個目の CachedRowSet オブジェクトのカーソルが最後の行にあると仮定しています。このコードではカーソルを最終行のあとに移動しているため、previous メソッドの最初の呼び出しで、カーソルを最終行に戻します。最後のページ (CachedRowSet オブジェクト crs) のすべての行を移動すると、コードは while ループに入り、9 ページ目に移動し、逆方向に行を移動し、8 ページ目に移動し、逆方向に行を移動し、同様にして先頭ページの先頭行まで進んでいきます。

     crs.afterLast();
     while(crs.previous())  {
         . . . // navigate through the rows, last to first
     {
     while(crs.previousPage())  {
         crs.afterLast();
         while(crs.previous())  {
             . . . // go from the last row to the first row of each page
         }
     }