java.lang.Object
java.lang.Throwable
java.lang.Exception
java.sql.SQLException
java.sql.BatchUpdateException
- すべての実装されたインタフェース:
Serializable,Iterable<Throwable>
public class BatchUpdateException extends SQLException
バッチ更新操作中にエラーが発生したときにスローされる
SQLExceptionのサブクラスです。 BatchUpdateExceptionは、SQLExceptionによって提供される情報に加えて、バッチ更新中に正常に実行されたすべてのコマンド、つまり、エラーが発生する前に実行されたすべてのコマンドの更新カウントを提供します。 更新カウントの配列での要素の順序は、コマンドがバッチに追加されたときの順序になります。
バッチ更新のコマンドが正しく実行されずBatchUpdateExceptionがスローされたあと、ドライバはバッチに残っているコマンドの処理を続けることも、中止することもできます。 失敗後にドライバが処理を継続する場合、BatchUpdateException.getUpdateCountsメソッドによって返される配列は、エラーまでに正常に実行されたコマンドの要素だけではなく、バッチの全コマンドの要素を含んでいます。 ドライバがコマンドの処理を継続する場合、失敗したコマンドの配列要素はどれもStatement.EXECUTE_FAILEDになります。
JDBCドライバ実装では、更新カウントがオーバーフローする可能性を避けるため、int[]を取るコンストラクタのかわりにコンストラクタBatchUpdateException(String reason, String SQLState, int vendorCode, long []updateCounts, Throwable cause)を使用するようにしてください。
Statement.executeLargeBatchメソッドが呼び出された場合は、整数の更新カウントがオーバーフローする可能性を避けるため、getUpdateCountsのかわりにgetLargeUpdateCountsを呼び出すことをお薦めします。
- 導入されたバージョン:
- 1.2
- 関連項目:
-
コンストラクタのサマリー
コンストラクタコンストラクタ説明BatchUpdateExceptionオブジェクトを構築します。BatchUpdateException(int[] updateCounts) 指定されたupdateCountsで初期化されたBatchUpdateExceptionオブジェクトを構築します。BatchUpdateException(int[] updateCounts, Throwable cause) 指定されたcauseとupdateCountsで初期化されたBatchUpdateExceptionオブジェクトを構築します。BatchUpdateException(String reason, int[] updateCounts) 指定されたreasonとupdateCountsで初期化されたBatchUpdateExceptionオブジェクトを構築します。BatchUpdateException(String reason, int[] updateCounts, Throwable cause) 指定されたreason、cause、およびupdateCountsで初期化されたBatchUpdateExceptionオブジェクトを構築します。BatchUpdateException(String reason, String SQLState, int[] updateCounts) 指定されたreason、SQLState、およびupdateCountsで初期化されたBatchUpdateExceptionオブジェクトを構築します。BatchUpdateException(String reason, String SQLState, int[] updateCounts, Throwable cause) 指定されたreason、SQLState、cause、およびupdateCountsで初期化されたBatchUpdateExceptionオブジェクトを構築します。BatchUpdateException(String reason, String SQLState, int vendorCode, int[] updateCounts) 指定されたreason、SQLState、vendorCode、およびupdateCountsで初期化されたBatchUpdateExceptionオブジェクトを構築します。BatchUpdateException(String reason, String SQLState, int vendorCode, int[] updateCounts, Throwable cause) 指定されたreason、SQLState、vendorCode、cause、およびupdateCountsで初期化されたBatchUpdateExceptionオブジェクトを構築します。BatchUpdateException(String reason, String SQLState, int vendorCode, long[] updateCounts, Throwable cause) 指定されたreason、SQLState、vendorCode、cause、およびupdateCountsで初期化されたBatchUpdateExceptionオブジェクトを構築します。BatchUpdateException(Throwable cause) 指定されたcauseで初期化されたBatchUpdateExceptionオブジェクトを構築します。 -
メソッドのサマリー
修飾子と型メソッド説明long[]バッチ更新内の更新文のうち、この例外が発生するまでに正常に実行されたものすべてに対する更新カウントを取り出します。int[]バッチ更新内の更新文のうち、この例外が発生するまでに正常に実行されたものすべてに対する更新カウントを取り出します。クラスjava.sql.SQLExceptionで宣言されたメソッド
getErrorCode, getNextException, getSQLState, iterator, setNextExceptionクラスjava.lang.Throwableで宣言されたメソッド
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toStringクラスjava.lang.Objectで宣言されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitインタフェースjava.lang.Iterableで宣言されたメソッド
forEach, spliterator
-
コンストラクタの詳細
-
BatchUpdateException
指定されたreason、SQLState、vendorCode、およびupdateCountsで初期化されたBatchUpdateExceptionオブジェクトを構築します。causeは初期化されませんが、続いてThrowable.initCause(java.lang.Throwable)メソッドを呼び出すことで初期化できます。ノート:
updateCountsのオーバーフローに関する検証は行われません。このため、コンストラクタBatchUpdateException(String reason, String SQLState, int vendorCode, long []updateCounts, Throwable cause)を使用することをお薦めします。- パラメータ:
reason- エラーの説明SQLState- 例外を識別するXOPENコードまたはSQL:2003コードvendorCode- 特定のデータベース・ベンダーの例外コードupdateCounts-intの配列。各要素は、コマンドの失敗後に処理を続けるJDBCドライバのバッチ内にある各SQLコマンドの更新カウント、Statement.SUCCESS_NO_INFOまたはStatement.EXECUTE_FAILED、あるいはコマンドの失敗後に処理を停止するJDBCドライバのバッチ内にある各SQLコマンドの、失敗前の更新カウントまたはStatement.SUCCESS_NO_INFOを表す- 導入されたバージョン:
- 1.2
- 関連項目:
-
BatchUpdateException
指定されたreason、SQLState、およびupdateCountsで初期化されたBatchUpdateExceptionオブジェクトを構築します。causeは初期化されませんが、続いてThrowable.initCause(java.lang.Throwable)メソッドを呼び出すことで初期化できます。 ベンダー・コードは0に初期化されます。ノート:
updateCountsのオーバーフローに関する検証は行われません。このため、コンストラクタBatchUpdateException(String reason, String SQLState, int vendorCode, long []updateCounts, Throwable cause)を使用することをお薦めします。- パラメータ:
reason- 例外の説明SQLState- 例外を識別するXOPENコードまたはSQL:2003コードupdateCounts-intの配列。各要素は、コマンドの失敗後に処理を続けるJDBCドライバのバッチ内にある各SQLコマンドの更新カウント、Statement.SUCCESS_NO_INFOまたはStatement.EXECUTE_FAILED、あるいはコマンドの失敗後に処理を停止するJDBCドライバのバッチ内にある各SQLコマンドの、失敗前の更新カウントまたはStatement.SUCCESS_NO_INFOを表す- 導入されたバージョン:
- 1.2
- 関連項目:
-
BatchUpdateException
public BatchUpdateException(String reason, int[] updateCounts) 指定されたreasonとupdateCountsで初期化されたBatchUpdateExceptionオブジェクトを構築します。causeは初期化されませんが、続いてThrowable.initCause(java.lang.Throwable)メソッドを呼び出すことで初期化できます。SQLStateはnullに初期化され、ベンダー・コードは0に初期化されます。ノート:
updateCountsのオーバーフローに関する検証は行われません。このため、コンストラクタBatchUpdateException(String reason, String SQLState, int vendorCode, long []updateCounts, Throwable cause)を使用することをお薦めします。- パラメータ:
reason- 例外の説明updateCounts-intの配列。各要素は、コマンドの失敗後に処理を続けるJDBCドライバのバッチ内にある各SQLコマンドの更新カウント、Statement.SUCCESS_NO_INFOまたはStatement.EXECUTE_FAILED、あるいはコマンドの失敗後に処理を停止するJDBCドライバのバッチ内にある各SQLコマンドの、失敗前の更新カウントまたはStatement.SUCCESS_NO_INFOを表す- 導入されたバージョン:
- 1.2
- 関連項目:
-
BatchUpdateException
public BatchUpdateException(int[] updateCounts) 指定されたupdateCountsで初期化されたBatchUpdateExceptionオブジェクトを構築します。Throwable.initCause(java.lang.Throwable)メソッドを呼び出すことによって、初期化されます。reasonおよびSQLStateはnullに初期化され、ベンダー・コードは0に初期化されます。ノート:
updateCountsのオーバーフローに関する検証は行われません。このため、コンストラクタBatchUpdateException(String reason, String SQLState, int vendorCode, long []updateCounts, Throwable cause)を使用することをお薦めします。- パラメータ:
updateCounts-intの配列。各要素は、コマンドの失敗後に処理を続けるJDBCドライバのバッチ内にある各SQLコマンドの更新カウント、Statement.SUCCESS_NO_INFOまたはStatement.EXECUTE_FAILED、あるいはコマンドの失敗後に処理を停止するJDBCドライバのバッチ内にある各SQLコマンドの、失敗前の更新カウントまたはStatement.SUCCESS_NO_INFOを表す- 導入されたバージョン:
- 1.2
- 関連項目:
-
BatchUpdateException
public BatchUpdateException()BatchUpdateExceptionオブジェクトを構築します。reason、SQLState、およびupdateCountsはnullに初期化され、ベンダー・コードは0に初期化されます。causeは初期化されませんが、続いてThrowable.initCause(java.lang.Throwable)メソッドを呼び出すことで初期化できます。- 導入されたバージョン:
- 1.2
- 関連項目:
-
BatchUpdateException
public BatchUpdateException(Throwable cause) 指定されたcauseで初期化されたBatchUpdateExceptionオブジェクトを構築します。SQLStateおよびupdateCountsはnullに初期化され、ベンダー・コードは0に初期化されます。reasonはcause==nullの場合にnullに初期化され、cause!=nullの場合にcause.toString()に初期化されます。- パラメータ:
cause- このSQLExceptionの基となる原因(あとでgetCause()メソッドで取得するために保存されます); null値が許可されており、原因が存在しないか不明であることを示します。- 導入されたバージョン:
- 1.6
- 関連項目:
-
BatchUpdateException
public BatchUpdateException(int[] updateCounts, Throwable cause) 指定されたcauseとupdateCountsで初期化されたBatchUpdateExceptionオブジェクトを構築します。SQLStateはnullに初期化され、ベンダー・コードは0に初期化されます。reasonはcause==nullの場合にnullに初期化され、cause!=nullの場合にcause.toString()に初期化されます。ノート:
updateCountsのオーバーフローに関する検証は行われません。このため、コンストラクタBatchUpdateException(String reason, String SQLState, int vendorCode, long []updateCounts, Throwable cause)を使用することをお薦めします。- パラメータ:
updateCounts-intの配列。各要素は、コマンドの失敗後に処理を続けるJDBCドライバのバッチ内にある各SQLコマンドの更新カウント、Statement.SUCCESS_NO_INFOまたはStatement.EXECUTE_FAILED、あるいはコマンドの失敗後に処理を停止するJDBCドライバのバッチ内にある各SQLコマンドの、失敗前の更新カウントまたはStatement.SUCCESS_NO_INFOを表すcause- このSQLExceptionの基となる原因(あとでgetCause()メソッドで取得するために保存されます); null値が許可されており、原因が存在しないか不明であることを示します。- 導入されたバージョン:
- 1.6
- 関連項目:
-
BatchUpdateException
指定されたreason、cause、およびupdateCountsで初期化されたBatchUpdateExceptionオブジェクトを構築します。SQLStateはnullに初期化され、ベンダー・コードは0に初期化されます。ノート:
updateCountsのオーバーフローに関する検証は行われません。このため、コンストラクタBatchUpdateException(String reason, String SQLState, int vendorCode, long []updateCounts, Throwable cause)を使用することをお薦めします。- パラメータ:
reason- 例外の説明updateCounts-intの配列。各要素は、コマンドの失敗後に処理を続けるJDBCドライバのバッチ内にある各SQLコマンドの更新カウント、Statement.SUCCESS_NO_INFOまたはStatement.EXECUTE_FAILED、あるいはコマンドの失敗後に処理を停止するJDBCドライバのバッチ内にある各SQLコマンドの、失敗前の更新カウントまたはStatement.SUCCESS_NO_INFOを表すcause- このSQLExceptionの基となる原因(あとでgetCause()メソッドで取得するために保存されます); null値が許可されており、原因が存在しないか不明であることを示します。- 導入されたバージョン:
- 1.6
- 関連項目:
-
BatchUpdateException
指定されたreason、SQLState、cause、およびupdateCountsで初期化されたBatchUpdateExceptionオブジェクトを構築します。 ベンダー・コードは0に初期化されます。- パラメータ:
reason- 例外の説明SQLState- 例外を識別するXOPENコードまたはSQL:2003コードupdateCounts-intの配列。各要素は、コマンドの失敗後に処理を続けるJDBCドライバのバッチ内にある各SQLコマンドの更新カウント、Statement.SUCCESS_NO_INFOまたはStatement.EXECUTE_FAILED、あるいはコマンドの失敗後に処理を停止するJDBCドライバのバッチ内にある各SQLコマンドの、失敗前の更新カウントまたはStatement.SUCCESS_NO_INFOを表すノート:
updateCountsのオーバーフローに関する検証は行われません。このため、コンストラクタBatchUpdateException(String reason, String SQLState, int vendorCode, long []updateCounts, Throwable cause)を使用することをお薦めします。cause- このSQLExceptionの基となる原因(あとでgetCause()メソッドで取得するために保存されます); null値が許可されており、原因が存在しないか不明であることを示します。- 導入されたバージョン:
- 1.6
- 関連項目:
-
BatchUpdateException
public BatchUpdateException(String reason, String SQLState, int vendorCode, int[] updateCounts, Throwable cause) 指定されたreason、SQLState、vendorCode、cause、およびupdateCountsで初期化されたBatchUpdateExceptionオブジェクトを構築します。- パラメータ:
reason- エラーの説明SQLState- 例外を識別するXOPENコードまたはSQL:2003コードvendorCode- 特定のデータベース・ベンダーの例外コードupdateCounts-intの配列。各要素は、コマンドの失敗後に処理を続けるJDBCドライバのバッチ内にある各SQLコマンドの更新カウント、Statement.SUCCESS_NO_INFOまたはStatement.EXECUTE_FAILED、あるいはコマンドの失敗後に処理を停止するJDBCドライバのバッチ内にある各SQLコマンドの、失敗前の更新カウントまたはStatement.SUCCESS_NO_INFOを表すノート:
updateCountsのオーバーフローに関する検証は行われません。このため、コンストラクタBatchUpdateException(String reason, String SQLState, int vendorCode, long []updateCounts, Throwable cause)を使用することをお薦めします。cause- このSQLExceptionの基となる原因(あとでgetCause()メソッドで取得するために保存されます); null値が許可されており、原因が存在しないか不明であることを示します。- 導入されたバージョン:
- 1.6
- 関連項目:
-
BatchUpdateException
public BatchUpdateException(String reason, String SQLState, int vendorCode, long[] updateCounts, Throwable cause) 指定されたreason、SQLState、vendorCode、cause、およびupdateCountsで初期化されたBatchUpdateExceptionオブジェクトを構築します。返される更新カウントが
Integer.MAX_VALUEを超える可能性がある場合は、このコンストラクタを使用するようにしてください。- パラメータ:
reason- エラーの説明SQLState- 例外を識別するXOPENコードまたはSQL:2003コードvendorCode- 特定のデータベース・ベンダーの例外コードupdateCounts-longの配列。各要素は、コマンドの失敗後に処理を続けるJDBCドライバのバッチ内にある各SQLコマンドの更新カウント、Statement.SUCCESS_NO_INFOまたはStatement.EXECUTE_FAILED、あるいはコマンドの失敗後に処理を停止するJDBCドライバのバッチ内にある各SQLコマンドの、失敗前の更新カウントまたはStatement.SUCCESS_NO_INFOを表すcause- このSQLExceptionの基となる原因(あとでgetCause()メソッドで取得するために保存されます); null値が許可されており、原因が存在しないか不明であることを示します。- 導入されたバージョン:
- 1.8
-
-
メソッドの詳細
-
getUpdateCounts
public int[] getUpdateCounts()バッチ更新内の更新文のうち、この例外が発生するまでに正常に実行されたものすべてに対する更新カウントを取り出します。 コマンドの1つが正しく実行されなかった場合、バッチ更新を実装するドライバは、バッチに残っているコマンドの処理を続けることも中止することもできます。 ドライバがコマンドの処理を継続する場合、このメソッドによって返される配列は、バッチにあるコマンドと同じ数の要素を持っています。そうでない場合、配列は、BatchUpdateExceptionがスローされるまでに正常に実行されたすべてのコマンドに対する更新カウントを含んでいます。このメソッドが返す可能性のある値は、Java 2 SDK, Standard Edition, Version 1.3で変更されました。 これは、
BatchUpdateExceptionオブジェクトがスローされたあともバッチ更新内のコマンドの処理を継続する、という新しいオプションに適応するために行われました。- 戻り値:
- このエラーが発生するまでに正常に実行された更新の更新カウントを含む
int型の配列。 ただし、エラー後もドライバがコマンドの処理を続ける場合は、バッチ内の各コマンドに対して次のいずれかの値が格納される。- 更新カウント
- コマンドが正常に実行されたが影響を受けた行数は不明であることを示す
Statement.SUCCESS_NO_INFO - コマンドが正常に実行されなかったことを示す
Statement.EXECUTE_FAILED
- 導入されたバージョン:
- 1.3
- 関連項目:
-
getLargeUpdateCounts
public long[] getLargeUpdateCounts()バッチ更新内の更新文のうち、この例外が発生するまでに正常に実行されたものすべてに対する更新カウントを取り出します。 コマンドの1つが正しく実行されなかった場合、バッチ更新を実装するドライバは、バッチに残っているコマンドの処理を続けることも中止することもできます。 ドライバがコマンドの処理を継続する場合、このメソッドによって返される配列は、バッチにあるコマンドと同じ数の要素を持っています。そうでない場合、配列は、BatchUpdateExceptionがスローされるまでに正常に実行されたすべてのコマンドに対する更新カウントを含んでいます。Statement.executeLargeBatchが呼び出され、返される更新カウントがInteger.MAX_VALUEを超える可能性がある場合は、このメソッドを使用するようにしてください。- 戻り値:
- このエラーが発生するまでに正常に実行された更新の更新カウントを含む
long型の配列。 ただし、エラー後もドライバがコマンドの処理を続ける場合は、バッチ内の各コマンドに対して次のいずれかの値が格納される。- 更新カウント
- コマンドが正常に実行されたが影響を受けた行数は不明であることを示す
Statement.SUCCESS_NO_INFO - コマンドが正常に実行されなかったことを示す
Statement.EXECUTE_FAILED
- 導入されたバージョン:
- 1.8
-