モジュール java.sql.rowset
パッケージ 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()