Android
java.sql
public class

java.sql.BatchUpdateException

java.lang.Object
java.lang.Throwable Serializable
java.lang.Exception
java.sql.SQLException Serializable
java.sql.BatchUpdateException Serializable

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

            BatchUpdateException()
Creates a BatchUpdateException with the Reason, SQLState, and Update Counts set to null and a Vendor Code of 0.
            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.
            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.
            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.
            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.

Public Methods

          int[]  getUpdateCounts()
Gets the Update Counts array.
Methods inherited from class java.sql.SQLException
Methods inherited from class java.lang.Throwable
Methods inherited from class java.lang.Object

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:
    1. an count of the updates
    2. Statement.SUCCESS_NO_INFO indicating that the command completed successfully, but the amount of altered rows is not known.
    3. Statement.EXECUTE_FAILED indicating that the command was unsuccessful.
Copyright 2007 Google Inc. Build 0.9_r1-98467 - 14 Aug 2008 18:56