Summary: Ctors | Methods | Inherited Methods | [Expand All]

public class

BatchUpdateException

extends SQLException
implements Serializable

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

Class Overview

This exception is 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 which were executed 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 default `BatchUpdateException` with the parameters reason, SQLState, and update counts set to `null` and the vendor code set to 0.
	BatchUpdateException(int[] updateCounts) Creates a `BatchUpdateException` with the `updateCounts` set to the supplied value.
	BatchUpdateException(String reason, int[] updateCounts) Creates a `BatchUpdateException` with the `updateCounts` and `reason` set to the supplied values.
	BatchUpdateException(String reason, String SQLState, int[] updateCounts) Creates a `BatchUpdateException` with the `reason`, `SQLState` and `updateCounts` set to the supplied values.
	BatchUpdateException(String reason, String SQLState, int vendorCode, int[] updateCounts) Creates a `BatchUpdateException` for the case where all relevant information is provided.

Public Methods
int[]	getUpdateCounts() Gets the update count array giving status information for every command that was attempted in the batch.

[Expand]

Inherited Methods

From class java.sql.SQLException

From class java.lang.Throwable

Throwable	fillInStackTrace() Records the stack trace from the point where this method has been called to this `Throwable`.
Throwable	getCause() Returns the cause of this `Throwable`, or `null` if there is no cause.
String	getLocalizedMessage() Returns the extra information message which was provided when this `Throwable` was created.
String	getMessage() Returns the extra information message which was provided when this `Throwable` was created.
StackTraceElement[]	getStackTrace() Returns the array of stack trace elements of this `Throwable`.
Throwable	initCause(Throwable throwable) Initializes the cause of this `Throwable`.
void	printStackTrace() Writes a printable representation of this `Throwable`'s stack trace to the `System.err` stream.
void	printStackTrace(PrintWriter err) Writes a printable representation of this `Throwable`'s stack trace to the specified print writer.
void	printStackTrace(PrintStream err) Writes a printable representation of this `Throwable`'s stack trace to the specified print stream.
void	setStackTrace(StackTraceElement[] trace) Sets the array of stack trace elements.
String	toString() Returns a string containing a concise, human-readable description of this object.

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals(Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Is called before the object's memory is being reclaimed by the VM.
final Class<? extends Object>	getClass() Returns the unique instance of `Class` which represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.

Public Constructors

public BatchUpdateException ()

Since: API Level 1

Creates a default BatchUpdateException with the parameters reason, SQLState, and update counts set to null and the vendor code set to 0.

public BatchUpdateException (int[] updateCounts)

Since: API Level 1

Creates a BatchUpdateException with the updateCounts set to the supplied value. All other fields are set to their default values.

Parameters

updateCounts	the array of `updateCounts` giving the number of successful updates (or another status code) for each command in the batch that was attempted.

public BatchUpdateException (String reason, int[] updateCounts)

Since: API Level 1

Creates a BatchUpdateException with the updateCounts and reason set to the supplied values. All other fields are set to their default values.

Parameters

reason	the message providing information about the source of this exception.
updateCounts	the array of `updateCounts` giving the number of successful updates (or another status code) for each command in the batch that was attempted.

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

Since: API Level 1

Creates a BatchUpdateException with the reason, SQLState and updateCounts set to the supplied values. All other fields are set to their default values.

Parameters

reason	the message providing information about the source of this exception.
SQLState	the X/OPEN value to use for the `SQLState`
updateCounts	the array of `updateCounts` giving the number of successful updates (or another status code) for each command in the batch that was attempted.

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

Since: API Level 1

Creates a BatchUpdateException for the case where all relevant information is provided.

Parameters

reason	the message providing information about the source of this exception.
SQLState	the X/OPEN value to use for the `SQLState`.
vendorCode	the value to use for the vendor error code.
updateCounts	the array of `updateCounts` giving the number of successful updates (or another status code) for each command in the batch that was attempted.

Public Methods

public int[] getUpdateCounts ()

Since: API Level 1

Gets the update count array giving status information for every command that was attempted in the batch.

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 so, 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 was thrown. Alternatively, if the driver continues to process commands following an error, for each successive command there is a corresponding element in the array giving one of the following status values:
1. the number of successful updates
2. Statement.SUCCESS_NO_INFO indicating that the command completed successfully, but the amount of altered rows is unknown.
3. Statement.EXECUTE_FAILED indicating that the command was unsuccessful.

Interfaces

Classes

Exceptions

BatchUpdateException

Class Overview

Summary

Public Constructors

public BatchUpdateException ()

public BatchUpdateException (int[] updateCounts)

Parameters

public BatchUpdateException (String reason, int[] updateCounts)

Parameters

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

Parameters

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

Parameters

Public Methods

public int[] getUpdateCounts ()

Returns