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

クラスRowSetProvider

java.lang.Object
javax.sql.rowset.RowSetProvider
public class RowSetProvider extends Object
各種のRowSet実装を作成するのに使用可能なRowSetFactory実装をアプリケーションで取得できるようにするファクトリAPI。

例: 

 RowSetFactory aFactory = RowSetProvider.newFactory();
 CachedRowSet crs = aFactory.createCachedRowSet();
 ...
 RowSetFactory rsf = RowSetProvider.newFactory("com.sun.rowset.RowSetFactoryImpl", null);
 WebRowSet wrs = rsf.createWebRowSet();

このクラスのトレースは、システム・プロパティjavax.sql.rowset.RowSetFactory.debugをfalse以外の任意の値に設定することによって、有効にできます。

導入されたバージョン:
1.7

  • コンストラクタの詳細

    • RowSetProvider

      protected RowSetProvider()
      RowSetProviderコンストラクタ

  • メソッドの詳細

    • newFactory

      public static RowSetFactory newFactory() throws SQLException

      RowSetFactory実装の新しいインスタンスを作成します。 このメソッドは次の検索順序で、ロードするRowSetFactory実装クラスを決定します。

      • システム・プロパティjavax.sql.rowset.RowSetFactory。 次に例を示します。
        • -Djavax.sql.rowset.RowSetFactory=com.sun.rowset.RowSetFactoryImpl
      • ServiceLoader API。 ServiceLoader APIは、実行時に使用できるjar内のMETA-INF/services/javax.sql.rowset.RowSetFactoryファイルからクラス名を検索する。 たとえば、RowSetFactory実装com.sun.rowset.RowSetFactoryImpl をロードするには、META-INF/services/javax.sql.rowset.RowSetFactoryのエントリは次のようになります:
        • com.sun.rowset.RowSetFactoryImpl
      • デフォルトのRowSetFactoryインスタンスをプラットフォームとする。

      アプリケーションがRowSetFactoryへの参照を取得すると、ファクトリを使用してRowSetのインスタンスを取得できます。

      戻り値:
      RowSetFactoryの新しいインスタンス
      例外:
      SQLException - デフォルト・ファクトリ・クラスをロードまたはインスタンス化できない場合。 原因は実際のExceptionに設定される
      導入されたバージョン:
      1.7
      関連項目:
      ServiceLoader

    • newFactory

      public static RowSetFactory newFactory​(String factoryClassName, ClassLoader cl) throws SQLException

      指定されたファクトリ・クラス名からRowSetFactoryの新しいインスタンスを作成します。 この関数は、クラス・パスに複数のプロバイダがある場合に便利です。 どのプロバイダがロードされるかを指定できるため、アプリケーションをさらに制御できます。

      アプリケーションがRowSetFactoryへの参照を取得すると、ファクトリを使用してRowSetのインスタンスを取得できます。

      パラメータ:
      factoryClassName - javax.sql.rowset.RowSetFactoryの実装を提供する完全修飾のファクトリ・クラス名。
      cl - ファクトリ・クラスのロードに使用されるClassLoader。 nullの場合は、現在のThreadのコンテキストclassLoaderが、ファクトリ・クラスのロードに使用されます。
      戻り値:
      RowSetFactoryの新しいインスタンス
      例外:
      SQLException - factoryClassNameがnull、またはファクトリ・クラスをロードまたはインスタンス化できない場合。
      導入されたバージョン:
      1.7
      関連項目:
      newFactory()