Module java.sql
Package java.sql

Class SQLRecoverableException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.sql.SQLException
java.sql.SQLRecoverableException
All Implemented Interfaces:
Serializable,Iterable<Throwable>
public classSQLRecoverableExceptionextendsSQLException
The subclass ofSQLException thrown in situations where a previously failed operation might be able to succeed if the application performs some recovery steps and retries the entire transaction or in the case of a distributed transaction, the transaction branch. At a minimum, the recovery operation must include closing the current connection and getting a new connection.
Since:
1.6
See Also:

  • Constructor Details

    • SQLRecoverableException

      public SQLRecoverableException()
      Constructs aSQLRecoverableException object. Thereason,SQLState are initialized tonull and the vendor code is initialized to 0. Thecause is not initialized, and may subsequently be initialized by a call to theThrowable.initCause(java.lang.Throwable) method.
      Since:
      1.6

    • SQLRecoverableException

      public SQLRecoverableException(String reason)
      Constructs aSQLRecoverableException object with a givenreason. TheSQLState is initialized tonull and the vendor code is initialized to 0. Thecause is not initialized, and may subsequently be initialized by a call to theThrowable.initCause(java.lang.Throwable) method.
      Parameters:
      reason - a description of the exception
      Since:
      1.6

    • SQLRecoverableException

      public SQLRecoverableException(String reason,String SQLState)
      Constructs aSQLRecoverableException object with a givenreason andSQLState. Thecause is not initialized, and may subsequently be initialized by a call to theThrowable.initCause(java.lang.Throwable) method. The vendor code is initialized to 0.
      Parameters:
      reason - a description of the exception
      SQLState - an XOPEN or SQL:2003 code identifying the exception
      Since:
      1.6

    • SQLRecoverableException

      public SQLRecoverableException(String reason,String SQLState, int vendorCode)
      Constructs aSQLRecoverableException object with a givenreason,SQLState andvendorCode. Thecause is not initialized, and may subsequently be initialized by a call to theThrowable.initCause(java.lang.Throwable) method.
      Parameters:
      reason - a description of the exception
      SQLState - an XOPEN or SQL:2003 code identifying the exception
      vendorCode - a database vendor specific exception code
      Since:
      1.6

    • SQLRecoverableException

      public SQLRecoverableException(Throwable cause)
      Constructs aSQLRecoverableException object with a givencause. TheSQLState is initialized tonull and the vendor code is initialized to 0. Thereason is initialized tonull ifcause==null or tocause.toString() ifcause!=null.
      Parameters:
      cause - the underlying reason for thisSQLException (which is saved for later retrieval by thegetCause() method); may be null indicating the cause is non-existent or unknown.
      Since:
      1.6

    • SQLRecoverableException

      public SQLRecoverableException(String reason,Throwable cause)
      Constructs aSQLRecoverableException object with a givenreason andcause. TheSQLState is initialized tonull and the vendor code is initialized to 0.
      Parameters:
      reason - a description of the exception.
      cause - the underlying reason for thisSQLException (which is saved for later retrieval by thegetCause() method); may be null indicating the cause is non-existent or unknown.
      Since:
      1.6

    • SQLRecoverableException

      public SQLRecoverableException(String reason,String SQLState,Throwable cause)
      Constructs aSQLRecoverableException object with a givenreason,SQLState andcause. The vendor code is initialized to 0.
      Parameters:
      reason - a description of the exception.
      SQLState - an XOPEN or SQL:2003 code identifying the exception
      cause - the underlying reason for thisSQLException (which is saved for later retrieval by thegetCause() method); may be null indicating the cause is non-existent or unknown.
      Since:
      1.6

    • SQLRecoverableException

      public SQLRecoverableException(String reason,String SQLState, int vendorCode,Throwable cause)
      Constructs aSQLRecoverableException object with a givenreason,SQLState,vendorCode andcause.
      Parameters:
      reason - a description of the exception
      SQLState - an XOPEN or SQL:2003 code identifying the exception
      vendorCode - a database vendor-specific exception code
      cause - the underlying reason for thisSQLException (which is saved for later retrieval by thegetCause() method); may be null indicating the cause is non-existent or unknown.
      Since:
      1.6