java.sql
Class BatchUpdateException

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Exception
              |
              +--java.sql.SQLException
                    |
                    +--java.sql.BatchUpdateException

public class BatchUpdateException

extends SQLException

JDBC 2.0

An exception thrown when an error occurs during a batch update operation. In addition to the information provided by SQLException, a BatchUpdateException provides the update counts for all commands that were executed successfully during the batch update, that is, all commands that were executed before the error occurred. The order of elements in an array of update counts corresponds to the order in which commands were added to the batch.

See Also:

Serialized Form

Constructor Summary

BatchUpdateException()
Constructs a BatchUpdateException object with the reason, SQLState, and update count initialized to null and the vendor code initialized to 0.

BatchUpdateException(int[] updateCounts)
Constructs a BatchUpdateException initialized to null for the reason and SQLState and 0 for the vendor code.

BatchUpdateException(String reason, int[] updateCounts)
Constructs a BatchUpdateException initialized with reason, updateCounts and null for the SQLState and 0 for the vendorCode.

BatchUpdateException(String reason, String SQLState, int[] updateCounts)
Constructs a BatchUpdateException initialized with the given arguments (reason, SQLState, and updateCounts) and 0 for the vendor code.

BatchUpdateException(String reason, String SQLState, int vendorCode, int[] updateCounts)
Constructs a fully specified BatchUpdateException.

Method Summary

int[]

getUpdateCounts() Retrieves the update count for each update statement in the batch update that executed successfully before this exception occurred.

Methods inherited from class java.sql.SQLException

getErrorCode, getNextException, getSQLState, setNextException

Methods inherited from class java.lang.Throwable

fillInStackTrace, getLocalizedMessage, getMessage, printStackTrace, printStackTrace, printStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

BatchUpdateException

public BatchUpdateException(String reason,
                            String SQLState,
                            int vendorCode,
                            int[] updateCounts)

Constructs a fully specified BatchUpdateException.

Parameters:

reason - a description of the error

SQLState - an X/OPEN code identifying the error

vendorCode - an exception code for a particular database vendor

updateCounts - an array of int, with each element indicating the update count for a SQL command that executed successfully before the exception was thrown

BatchUpdateException

public BatchUpdateException(String reason,
                            String SQLState,
                            int[] updateCounts)

Constructs a BatchUpdateException initialized with the given arguments (reason, SQLState, and updateCounts) and 0 for the vendor code.

Parameters:

reason - a description of the exception

SQLState - an X/OPEN code identifying the exception

updateCounts - an array of int, with each element indicating the update count for a SQL command that executed successfully before the exception was thrown

BatchUpdateException

public BatchUpdateException(String reason,
                            int[] updateCounts)

Constructs a BatchUpdateException initialized with reason, updateCounts and null for the SQLState and 0 for the vendorCode.

Parameters:

reason - a description of the exception

updateCounts - an array of int, with each element indicating the update count for a SQL command that executed successfully before the exception was thrown

BatchUpdateException

public BatchUpdateException(int[] updateCounts)

Constructs a BatchUpdateException initialized to null for the reason and SQLState and 0 for the vendor code.

Parameters:

updateCounts - an array of int, with each element indicating the update count for a SQL command that executed successfully before the exception was thrown

BatchUpdateException

public BatchUpdateException()

Constructs a BatchUpdateException object with the reason, SQLState, and update count initialized to null and the vendor code initialized to 0.

Method Detail

getUpdateCounts

public int[] getUpdateCounts()

Retrieves the update count for each update statement in the batch update that executed successfully before this exception occurred.

Returns:

an array of int containing the update counts for the updates that were executed successfully before this error occurred