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

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
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()

メソッドの詳細

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