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

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

コンストラクタ

修飾子	コンストラクタ	説明
protected	RowSetProvider()	RowSetProviderのコンストラクタです

メソッドのサマリー

修飾子と型	メソッド	説明
static RowSetFactory	newFactory()	RowSetFactory実装の新しいインスタンスを作成します。
static RowSetFactory	newFactory(String factoryClassName, ClassLoader cl)	指定されたファクトリ・クラス名からRowSetFactoryの新しいインスタンスを作成します。

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

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

コンストラクタの詳細

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()