java.sql.BatchUpdateException
An exception thrown if a problem occurs during a batch update operation.
A BatchUpdateException provides additional information about the problem that
occurred, compared with a standard SQLException. It supplies update counts
for successful commands that executed within the batch update, but before the
exception was encountered.
The element order in the array of update counts matches the order that the
commands were added to the batch operation.
Once a batch update command fails and a BatchUpdateException is thrown, the
JDBC driver may continue processing the remaining commands in the batch. If
the driver does process more commands after the problem occurs, the array
returned by BatchUpdateException.getUpdateCounts has an element for every
command in the batch, not only those that executed successfully. In this
case, the array element for any command which encountered a problem is set to
Statement.EXECUTE_FAILED.
Summary
Public Constructors
Public Methods
fillInStackTrace,
getCause,
getLocalizedMessage,
getMessage,
getStackTrace,
initCause,
printStackTrace,
printStackTrace,
printStackTrace,
setStackTrace,
toString
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait
Details
Public Constructors
public
BatchUpdateException()
Creates a BatchUpdateException with the Reason, SQLState, and Update
Counts set to null and a Vendor Code of 0.
public
BatchUpdateException(int[] updateCounts)
Creates a BatchUpdateException with the Update Counts set to the supplied
value and the Reason, SQLState set to null and a Vendor Code of 0.
Parameters
updateCounts
| the array of Update Counts to use in initialization
|
public
BatchUpdateException(String reason, int[] updateCounts)
Creates a BatchUpdateException with the Update Counts set to the supplied
value, the Reason set to the supplied value and SQLState set to null and
a Vendor Code of 0.
Parameters
reason
| the initialization value for Reason |
updateCounts
| the array of Update Counts to set
|
public
BatchUpdateException(String reason, String SQLState, int[] updateCounts)
Creates a BatchUpdateException with the Update Counts set to the supplied
value, the Reason set to the supplied value, the SQLState initialized to
the supplied value and the Vendor Code initialized to 0.
Parameters
reason
| the value to use for the Reason |
SQLState
| the X/OPEN value to use for the SQLState |
updateCounts
| the array of Update Counts to set
|
public
BatchUpdateException(String reason, String SQLState, int vendorCode, int[] updateCounts)
Creates a BatchUpdateException with the Update Counts set to the supplied
value, the Reason set to the supplied value, the SQLState initialized to
the supplied value and the Vendor Code set to the supplied value.
Parameters
reason
| the value to use for the Reason |
SQLState
| the X/OPEN value to use for the SQLState |
vendorCode
| the value to use for the vendor error code |
updateCounts
| the array of Update Counts to set
|
Public Methods
public
int[]
getUpdateCounts()
Gets the Update Counts array.
If a batch update command fails and a BatchUpdateException is thrown, the
JDBC driver may continue processing the remaining commands in the batch.
If the driver does process more commands after the problem occurs, the
array returned by BatchUpdateException.getUpdateCounts
has
an element for every command in the batch, not only those that executed
successfully. In this case, the array element for any command which
encountered a problem is set to Statement.EXECUTE_FAILED.
Returns
- an array that contains the successful update counts, before this
exception. Alternatively, if the driver continues to process
commands following an error, one of these listed items for every
command the batch contains:
- an count of the updates
Statement.SUCCESS_NO_INFO
indicating that the
command completed successfully, but the amount of altered rows is
not known.
Statement.EXECUTE_FAILED
indicating that the
command was unsuccessful.