モジュール java.sql
パッケージ javax.sql

インタフェースRowSetReader

既知のすべてのサブインタフェース:
XmlReader
public interface RowSetReader
切断されたRowSetオブジェクトが、列データ付きで自分自身を生成するために呼び出す機能です。 リーダー(RowSetReaderインタフェースを実装するオブジェクト)は、リーダー/ライターの仕組みをサポートするRowSetオブジェクトで登録されます。 RowSetオブジェクトのexecuteメソッドが呼び出されると、次にはリーダーのreadDataメソッドが呼び出されます。
導入されたバージョン:
1.4

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    void
    readData​(RowSetInternal caller)
    呼び出すRowSetオブジェクトの新しい内容を読み込みます。

  • メソッドの詳細

    • readData

      void readData​(RowSetInternal caller) throws SQLException
      呼び出すRowSetオブジェクトの新しい内容を読み込みます。 このメソッドを呼び出すためには、RowSetオブジェクトでRowSetInternalインタフェースが実装され、このRowSetReaderオブジェクトがリーダーとして登録されていなければいけません。 readDataメソッドは、リーダー/ライターの仕組みをサポートする行セットに対し、RowSet.executeメソッドによって内部的に呼び出されます。

      readDataメソッドによって、呼出し側に行が追加されます。 幅広い方法で実装が可能であり、呼出し側に非関係データ・ソースから行を生成することさえできます。 一般に、リーダーは行セットの任意のメソッドを呼び出すことができますが、例外が1つあります。 executeは再帰的呼出しができないため、executeメソッドを呼び出すとSQLExceptionがスローされる原因になります。 また、リーダーがRowSetのメソッドを呼び出すと、通知を受けるリスナーはありません。つまり、RowSetEventオブジェクトは生成されず、RowSetListenerのメソッドは呼び出されません。 このことは、executeメソッドによってリスナーがすでに通知を受けている場合に、当てはまります。

      パラメータ:
      caller - (1) RowSetInternalインタフェースを実装し、(2)このリーダーが登録されており、(3) executeメソッドでその登録されたリーダーを呼び出す、RowSetオブジェクト
      例外:
      SQLException - データベース・アクセス・エラーが発生した場合、または、このメソッドによってRowSet.executeメソッドが呼び出された場合