8.4.3 cancel()
(1) 機能
該当するオブジェクト,および該当するオブジェクトと同一接続のオブジェクトが実行しているSQLの処理を取り消します。
このメソッドを使用して,実行中のSQLに非同期キャンセルを実行できます。
(2) 形式
public void cancel() throws SQLException
(3) 引数
なし。
(4) 戻り値
なし。
(5) 発生する例外
次に示す場合にSQLExceptionが投入されます。
-
Statementオブジェクトがクローズされている場合
-
Statementオブジェクトを生成したConnectionオブジェクトがクローズされている場合
(6) 留意事項
-
このメソッドは,該当するStatementオブジェクトがSQLの実行中でなくても,同一接続オブジェクトに対して,ほかのオブジェクトがSQLを実行している場合は,非同期キャンセルを行います。
-
該当するStatementオブジェクトがSQLの実行中ではなく,かつ同一接続オブジェクトに対してほかのオブジェクトがSQLを実行していない場合,このメソッドはキャンセルを実行しません。
-
SQLの非同期キャンセルに成功した場合,トランザクションがロールバックされます。