Java Platform 1.2

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

Java Platform 1.2

Submit a bug or feature Version 1.2 of Java Platform API Specification
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.