attachDatabaseConnection
クラス名：CIWConnectionCoordinator
構文
public void attachDatabaseConnection(
java.sql.Connection aDBConnection
)
throws CIWFatalException,
CIWSQLTransientException
機能
トランザクションを開始しているJDBCコネクションをCIWServerオブジェクトに関連づけます。
引数
attachDatabaseConnectionの引数を次の表に示します。
|
仮引数名 |
名称 |
in/out |
説明 |
|---|---|---|---|
|
aDBConnection |
JDBCコネクション |
in |
CIWServerオブジェクトに関連づけるJDBCコネクションを指定します。 nullは指定できません。 |
戻り値
ありません。
例外
attachDatabaseConnectionで発生する例外を次の表に示します。
|
クラス名 |
説明 |
|---|---|
|
処理を続行できない障害が発生した場合 |
|
|
DBアクセスで一時的エラーが発生した場合 |
注意事項
-
次に示す場合は，例外（CIWFatalException）が発生します。
-
引数に渡すJDBCコネクションにnullを指定した場合
-
空文字列引数に渡すJDBCコネクションの自動コミットモードが有効になっている場合
-
このメソッドを実行する前にCIWServerオブジェクトのAPIを発行した場合
-
-
このメソッドを実行したあとは，関連づけを解除するまでJDBCコネクションを切断したり，トランザクションを終了したりしないでください。