Module java.sql
Package java.sql

Class SQLRecoverableException

All Implemented Interfaces:
Serializable, Iterable<Throwable>

public class SQLRecoverableException
extends SQLException
The subclass of SQLException 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:
Serialized Form
  • Constructor Details

    • SQLRecoverableException

      public SQLRecoverableException()
      Constructs a SQLRecoverableException object. The reason, SQLState are initialized to null and the vendor code is initialized to 0. The cause is not initialized, and may subsequently be initialized by a call to the Throwable.initCause(java.lang.Throwable) method.
      Since:
      1.6
    • SQLRecoverableException

      public SQLRecoverableException​(String reason)
      Constructs a SQLRecoverableException object with a given reason. The SQLState is initialized to null and the vendor code is initialized to 0. The cause is not initialized, and may subsequently be initialized by a call to the Throwable.initCause(java.lang.Throwable) method.
      Parameters:
      reason - a description of the exception
      Since:
      1.6
    • SQLRecoverableException

      public SQLRecoverableException​(String reason, String SQLState)
      Constructs a SQLRecoverableException object with a given reason and SQLState. The cause is not initialized, and may subsequently be initialized by a call to the Throwable.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 a SQLRecoverableException object with a given reason, SQLState and vendorCode. The cause is not initialized, and may subsequently be initialized by a call to the Throwable.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 a SQLRecoverableException object with a given cause. The SQLState is initialized to null and the vendor code is initialized to 0. The reason is initialized to null if cause==null or to cause.toString() if cause!=null.
      Parameters:
      cause - the underlying reason for this SQLException (which is saved for later retrieval by the getCause() method); may be null indicating the cause is non-existent or unknown.
      Since:
      1.6
    • SQLRecoverableException

      public SQLRecoverableException​(String reason, Throwable cause)
      Constructs a SQLRecoverableException object with a given reason and cause. The SQLState is initialized to null and the vendor code is initialized to 0.
      Parameters:
      reason - a description of the exception.
      cause - the underlying reason for this SQLException (which is saved for later retrieval by the getCause() 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 a SQLRecoverableException object with a given reason, SQLState and cause. 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 this SQLException (which is saved for later retrieval by the getCause() 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 a SQLRecoverableException object with a given reason, SQLState, vendorCode and cause.
      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 this SQLException (which is saved for later retrieval by the getCause() method); may be null indicating the cause is non-existent or unknown.
      Since:
      1.6