java.sql
exception SQLRecoverableException

java.lang.Object java.lang.Throwable java.lang.Exception java.sql.SQLException java.sql.SQLRecoverableException

All Implemented Interfaces:

Serializable, Iterable

public exception SQLRecoverableException
extends SQLException

The subclass of {@link 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.

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 {@link Throwable#initCause(java.lang.Throwable)} method.

SQLRecoverableException

public SQLRecoverableException(String reason)

Constructs a SQLRecoverableException object with a given reason. The SQLState is initialized to null and the vender code is initialized to 0. The cause is not initialized, and may subsequently be initialized by a call to the {@link Throwable#initCause(java.lang.Throwable)} method.

Parameters:

reason - a description of the exception

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 {@link 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

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 {@link 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

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.

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.

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.

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.