java.sql: public class: SQLRecoverableException

java.sql
public class: SQLRecoverableException [javadoc | source]

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

All Implemented Interfaces:
Iterable, Serializable

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 -

Fields inherited from java.lang.Exception:
serialVersionUID

Constructor:

Constructor:
public SQLRecoverableException() { super(); } 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` -
public SQLRecoverableException(String reason) { super(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 Throwable#initCause(java.lang.Throwable) method. Parameters: `reason` - a description of the exception since: `1.6` -
public SQLRecoverableException(Throwable cause) { super(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` -
public SQLRecoverableException(String reason, String SQLState) { super(reason, 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` -
public SQLRecoverableException(String reason, Throwable cause) { super(reason, 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` -
public SQLRecoverableException(String reason, String SQLState, int vendorCode) { super(reason, SQLState, 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` -
public SQLRecoverableException(String reason, String SQLState, Throwable cause) { super(reason, SQLState, 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` -
public SQLRecoverableException(String reason, String SQLState, int vendorCode, Throwable cause) { super(reason, SQLState, vendorCode, 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` -

 public SQLRecoverableException() {
                super();
}

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)

since: 1.6 -

 public SQLRecoverableException(String reason) {
                super(reason);
}

SQLRecoverableException

reason

SQLState

null

cause

Throwable#initCause(java.lang.Throwable)

Parameters:

reason - a description of the exception

since: 1.6 -

 public SQLRecoverableException(Throwable cause) {
        super(cause);
}

SQLRecoverableException

cause

SQLState

null

reason

null

cause==null

cause.toString()

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 -

 public SQLRecoverableException(String reason,
    String SQLState) {
                super(reason, SQLState);
}

SQLRecoverableException

reason

SQLState

cause

Throwable#initCause(java.lang.Throwable)

Parameters:

reason - a description of the exception

SQLState - an XOPEN or SQL:2003 code identifying the exception

since: 1.6 -

 public SQLRecoverableException(String reason,
    Throwable cause) {
        super(reason, cause);
}

SQLRecoverableException

reason

cause

SQLState

null

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 -

 public SQLRecoverableException(String reason,
    String SQLState,
    int vendorCode) {
                super(reason, SQLState, vendorCode);
}

SQLRecoverableException

reason

SQLState

vendorCode

cause

Throwable#initCause(java.lang.Throwable)

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 -

 public SQLRecoverableException(String reason,
    String SQLState,
    Throwable cause) {
        super(reason, SQLState, cause);
}

SQLRecoverableException

reason

SQLState

cause

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 -

 public SQLRecoverableException(String reason,
    String SQLState,
    int vendorCode,
    Throwable cause) {
        super(reason, SQLState, vendorCode, cause);
}

SQLRecoverableException

reason

SQLState

vendorCode

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 -

Methods from java.sql.SQLException:
getErrorCode, getNextException, getSQLState, iterator, setNextException

Methods from java.lang.Throwable:
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods from java.lang.Object:
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait