createCIWServer
クラス名:CIWFactory
形式
public CIWServer createCIWServer( java.lang.String aUserDescription, javax.sql.DataSource aDataSource ) throws CIWFatalException
機能
javax.sql.DataSourceオブジェクトを設定して,CIWServerオブジェクトを生成します。
このメソッドで生成したCIWServerオブジェクトについては,データベースコネクションとCIWServerオブジェクトの関連づけおよび解除は自動的に行われます。このメソッドで生成したCIWServerオブジェクトに対して,CIWServer#getConnectionCoordinator()を実行した場合は(CIWFatalException)が発生します。
引数
createCIWServerの引数を次の表に示します。
戻り値
CIWServerオブジェクトを返します。
注意事項
-
ユーザ記述子に次に示す文字列を指定した場合,例外(java.lang.IllegalArgumentException)が発生します。
-
ユーザ記述子に<SYSTEMID>_PROCESS_INSTANCEテーブルのCreatorカラムのバイト数を超える文字列
-
空文字列
-
null
-
-
ユーザアプリケーションで使用しているDataSourceオブジェクトにnullを指定した場合は,例外(java.lang.IllegalArgumentException)が発生します。
-
DataSourceから取得したjava.sql.Connectionが,実行スレッドで同一のトランザクションでDBMSにアクセスできる場合に,このメソッドを呼び出すことができます。例えば,J2EEサーバ上のEJBから利用する場合などです。