|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object java.lang.Throwable java.lang.Exception java.sql.SQLException java.sql.BatchUpdateException
public class BatchUpdateException
バッチ更新操作中にエラーが発生したときにスローされる例外です。BatchUpdateException
は、SQLException
によって提供される情報に加えて、バッチ更新中に正常に実行されたすべてのコマンド、つまり、エラーが発生する前に実行されたすべてのコマンドの更新カウントを提供します。更新カウントの配列での要素の順序は、コマンドがバッチに追加されたときの順序になります。
バッチ更新のコマンドが正しく実行されず BatchUpdateException
がスローされたあと、ドライバはバッチに残っているコマンドの処理を続けることも、中止することもできます。失敗後にドライバが処理を継続する場合、メソッド BatchUpdateException.getUpdateCounts
によって返される配列は、エラーまでに正常に実行されたコマンドの要素だけではなく、バッチの全コマンドの要素を含んでいます。ドライバがコマンドの処理を継続する場合、失敗したコマンドの配列要素はどれも Statement.EXECUTE_FAILED
になります。
コンストラクタの概要 | |
---|---|
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, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, 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
型の配列。ただし、エラー後もドライバがコマンドの処理を続ける場合は、バッチ内の各コマンドに対して次のいずれかの値が格納される。Statement.SUCCESS_NO_INFO
Statement.EXECUTE_FAILED
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。