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