|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.lang.Throwable | +--java.lang.Exception | +--java.sql.SQLException | +--java.sql.BatchUpdateException
バッチ更新オペレーション中にエラーが発生したときにスローされる例外です。BatchUpdateException
は、SQLException
によって提供される情報に加えて、バッチ更新中に正常に実行されたすべてのコマンド、つまり、エラーが発生する前に実行されたすべてのコマンドの更新カウントを提供します。更新カウントの配列での要素の順序は、コマンドがバッチに追加されたときの順序になります。
バッチ更新のコマンドが正しく実行されず BatchUpdateException
がスローされたあと、ドライバはバッチに残っているコマンドの処理を続けることも、中止することもできます。失敗後にドライバが処理を継続する場合、メソッド BatchUpdateException.getUpdateCounts
によって返される配列は、エラーまでに正常に実行されたコマンドだけの要素ではなく、バッチの全コマンドの要素を含んでいます。ドライバがコマンドの処理を継続する場合、失敗したコマンドの配列要素はどれも -3
になります。
このクラスは JDBC 2.0 API で新しく追加されたものです。
コンストラクタの概要 | |
BatchUpdateException()
reason、SQLState、および更新カウントが null 、ベンダーコードが 0 に初期化された、BatchUpdateException オブジェクトを構築します。 |
|
BatchUpdateException(int[] updateCounts)
reason と SQLState が null 、ベンダーコードが 0 で初期化された、BatchUpdateException を構築します。 |
|
BatchUpdateException(String reason,
int[] updateCounts)
reason 、updateCounts 、null の SQLState、および 0 の vendorCode で初期化された、BatchUpdateException を構築します。 |
|
BatchUpdateException(String reason,
String SQLState,
int[] updateCounts)
指定された引数 ( reason 、SQLState 、updateCounts ) およびベンダーコード 0 で初期化された、BatchUpdateException を構築します。 |
|
BatchUpdateException(String reason,
String SQLState,
int vendorCode,
int[] updateCounts)
完全指定の BatchUpdateException オブジェクトを構築し、指定された値で初期化します。 |
メソッドの概要 | |
int[] |
getUpdateCounts()
この例外が発生するまでに正常に実行されたバッチ更新の、各更新文の更新カウントを取り出します。 |
クラス java.sql.SQLException から継承したメソッド |
getErrorCode, getNextException, getSQLState, setNextException |
クラス java.lang.Throwable から継承したメソッド |
fillInStackTrace, getLocalizedMessage, getMessage, printStackTrace, printStackTrace, printStackTrace, toString |
クラス java.lang.Object から継承したメソッド |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
コンストラクタの詳細 |
public BatchUpdateException(String reason, String SQLState, int vendorCode, int[] updateCounts)
BatchUpdateException
オブジェクトを構築し、指定された値で初期化します。reason
- エラーの説明SQLState
- エラーを識別する X/OPEN コードvendorCode
- 特定のデータベースベンダーの例外コードupdateCounts
- int
の配列。各要素は、例外がスローされるまでに正常に実行された SQL コマンドの更新カウントを示すpublic BatchUpdateException(String reason, String SQLState, int[] updateCounts)
reason
、SQLState
、updateCounts
) およびベンダーコード 0 で初期化された、BatchUpdateException
を構築します。reason
- 例外の説明SQLState
- 例外を識別する X/OPEN コードupdateCounts
- int
の配列。各要素は、例外がスローされるまでに正常に実行された SQL コマンドの更新カウントを示すpublic BatchUpdateException(String reason, int[] updateCounts)
reason
、updateCounts
、null
の SQLState、および 0 の vendorCode で初期化された、BatchUpdateException
を構築します。reason
- 例外の説明updateCounts
- int
の配列。各要素は、例外がスローされるまでに正常に実行された SQL コマンドの更新カウントを示すpublic BatchUpdateException(int[] updateCounts)
null
、ベンダーコードが 0 で初期化された、BatchUpdateException
を構築します。updateCounts
- int
の配列。各要素は、例外がスローされるまでに正常に実行された SQL コマンドの更新カウントを示すpublic BatchUpdateException()
null
、ベンダーコードが 0 に初期化された、BatchUpdateException
オブジェクトを構築します。メソッドの詳細 |
public int[] getUpdateCounts()
BatchUpdateException
がスローされるまでに正常に実行された各コマンドの更新カウントを含んでいます。
このメソッドに使用できる戻り値は、Java 2 SDK, Standard Edition, バージョン 1.3 で変更されました。これは、BatchUpdateException
オブジェクトがスローされたあともバッチ更新内のコマンドの処理を継続する、という新しいオプションに適応するために行われました。
int
の配列。あるいは、エラー後もドライバがコマンドの処理を続ける場合、バッチの全コマンドに対して次のうちの 1 つ。-2
-3
|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.