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 Detail

      • 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