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

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.

[Expand]

Inherited Methods

From class java.sql.SQLException

From class java.lang.Throwable

Throwable	fillInStackTrace() Records in the receiver a stack trace from the point where this message was sent.
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 the throwable was created.
String	getMessage() Returns the extra information message which was provided when the throwable was created.
StackTraceElement[]	getStackTrace() Returns an array of StackTraceElement.
Throwable	initCause(Throwable throwable) Initialize the cause of the receiver.
void	printStackTrace() Outputs a printable representation of the receiver's stack trace on the System.err stream.
void	printStackTrace(PrintWriter err) Outputs a printable representation of the receiver's stack trace on the PrintWriter specified by the argument.
void	printStackTrace(PrintStream err) Outputs a printable representation of the receiver's stack trace on the PrintStream specified by the argument.
void	setStackTrace(StackTraceElement[] trace) Sets the array of StackTraceElements.
String	toString() Returns a string containing a concise, human-readable description of the receiver.

From class java.lang.Object

Object	clone() Returns a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
boolean	equals(Object o) Compares the argument to the receiver, and returns true if they represent the same object using a class specific comparison.
void	finalize() Called by the virtual machine when there are no longer any (non-weak) references to the receiver.
final Class<? extends Object>	getClass() Returns the unique instance of java.lang.Class which represents the class of the receiver.
int	hashCode() Returns an integer hash code for the receiver.
final void	notify() Causes one thread which is `wait` ing on the receiver to be made ready to run.
final void	notifyAll() Causes all threads which are `wait` ing on the receiver to be made ready to run.
String	toString() Returns a string containing a concise, human-readable description of the receiver.
final void	wait(long time, int frac) Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final void	wait(long time) Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final void	wait() Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by `notify` or `notifyAll`).

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.

Jan	FEB	Mar
	19
2008	2009	2010

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