Android - An Open Handset Alliance Project

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

getErrorCode, getNextException, getSQLState, setNextException

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

				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.

Methods inherited from class java.lang.Object

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

	Object	clone()
		Answers 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 answers 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	getClass()
		Answers the unique instance of java.lang.Class which represents the class of the receiver.
	int	hashCode()
		Answers 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()
		Answers 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`).

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)

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.

				int	getErrorCode()
					Returns the integer error code for this SQLException
				SQLException	getNextException()
					Retrieves the SQLException chained to this SQLException, if any.
				String	getSQLState()
					Retrieves the SQLState description string for this SQLException object
				void	setNextException(SQLException ex)
					Adds the SQLException to the end of this SQLException chain.

Android - An Open Handset Alliance Project

Documentation

Goodies

java.sql.BatchUpdateException

Summary

Public Constructors

Public Methods

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()

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


e.g. "intent" or "activity"