oracle.adfnmc.java.sql
Class BatchUpdateException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.lang.RuntimeException
              oracle.adfnmc.AdfNmcException
                  oracle.adfnmc.java.sql.SQLException
                      oracle.adfnmc.java.sql.BatchUpdateException

public class BatchUpdateException
extends SQLException

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.

Field Summary

Fields inherited from class oracle.adfnmc.java.sql.SQLException

SQL_ERRORCODE_FILENOTFOUND

Fields inherited from class oracle.adfnmc.AdfNmcException

CLASS_INSTANCE, PRIORITY_HIGH, PRIORITY_LOW, PRIORITY_MEDIUM

Constructor Summary

BatchUpdateException(java.lang.Class callingClass, java.lang.String callingMethod)
Creates a BatchUpdateException with the Reason, SQLState, and Update Counts set to null and a Vendor Code of 0.

BatchUpdateException(java.lang.Class callingClass, java.lang.String callingMethod, 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(java.lang.Class callingClass, java.lang.String callingMethod, java.lang.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(java.lang.Class callingClass, java.lang.String callingMethod, java.lang.String reason, java.lang.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(java.lang.Class callingClass, java.lang.String callingMethod, java.lang.String reason, java.lang.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.

Method Summary

int[]

getUpdateCounts() Gets the Update Counts array.

Methods inherited from class oracle.adfnmc.java.sql.SQLException

getErrorCode, getNextException, getSQLState, setNextException

Methods inherited from class oracle.adfnmc.AdfNmcException

addLogMessage, addLogMessage, getCallerInfo, getCause, getPriority, getStringContent, getStringContent, isFatal, printLogMessages, setFatal, setInnerException, setPriority, toLogString, toString

Methods inherited from class java.lang.Throwable

getMessage, printStackTrace

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

BatchUpdateException

public BatchUpdateException(java.lang.Class callingClass,
                            java.lang.String callingMethod)

Creates a BatchUpdateException with the Reason, SQLState, and Update Counts set to null and a Vendor Code of 0.

BatchUpdateException

public BatchUpdateException(java.lang.Class callingClass,
                            java.lang.String callingMethod,
                            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

BatchUpdateException

public BatchUpdateException(java.lang.Class callingClass,
                            java.lang.String callingMethod,
                            java.lang.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

BatchUpdateException

public BatchUpdateException(java.lang.Class callingClass,
                            java.lang.String callingMethod,
                            java.lang.String reason,
                            java.lang.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

BatchUpdateException

public BatchUpdateException(java.lang.Class callingClass,
                            java.lang.String callingMethod,
                            java.lang.String reason,
                            java.lang.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

Method Detail

getUpdateCounts

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.