Added in API level 9

SQLRecoverableException

open class SQLRecoverableException : 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.

Summary

Public constructors

Constructs a SQLRecoverableException object.

Constructs a SQLRecoverableException object with a given reason.

SQLRecoverableException(reason: String!, SQLState: String!)

Constructs a SQLRecoverableException object with a given reason and SQLState.

SQLRecoverableException(reason: String!, SQLState: String!, vendorCode: Int)

Constructs a SQLRecoverableException object with a given reason, SQLState and vendorCode.

SQLRecoverableException(reason: String!, SQLState: String!, vendorCode: Int, cause: Throwable!)

Constructs a SQLRecoverableException object with a given reason, SQLState, vendorCode and cause.

SQLRecoverableException(reason: String!, SQLState: String!, cause: Throwable!)

Constructs a SQLRecoverableException object with a given reason, SQLState and cause.

Constructs a SQLRecoverableException object with a given reason and cause.

Constructs a SQLRecoverableException object with a given cause.

Inherited functions
Int getErrorCode()

Retrieves the vendor-specific exception code for this SQLException object.

SQLException! getNextException()

Retrieves the exception chained to this SQLException object by setNextException(SQLException ex).

String! getSQLState()

Retrieves the SQLState for this SQLException object.

MutableIterator<Throwable!> iterator()

Returns an iterator over the chained SQLExceptions. The iterator will be used to iterate over each SQLException and its underlying cause (if any).

Unit setNextException(ex: SQLException!)

Adds an SQLException object to the end of the chain.

Public constructors

SQLRecoverableException

Added in API level 9
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.

SQLRecoverableException

Added in API level 9
SQLRecoverableException(reason: String!)

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 String!: a description of the exception

SQLRecoverableException

Added in API level 9
SQLRecoverableException(
    reason: String!,
    SQLState: String!)

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 String!: a description of the exception
SQLState String!: an XOPEN or SQL:2003 code identifying the exception

SQLRecoverableException

Added in API level 9
SQLRecoverableException(
    reason: String!,
    SQLState: String!,
    vendorCode: Int)

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 String!: a description of the exception
SQLState String!: an XOPEN or SQL:2003 code identifying the exception
vendorCode Int: a database vendor specific exception code

SQLRecoverableException

Added in API level 9
SQLRecoverableException(
    reason: String!,
    SQLState: String!,
    vendorCode: Int,
    cause: Throwable!)

Constructs a SQLRecoverableException object with a given reason, SQLState, vendorCode and cause.

Parameters
reason String!: a description of the exception
SQLState String!: an XOPEN or SQL:2003 code identifying the exception
vendorCode Int: a database vendor-specific exception code
cause Throwable!: 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

Added in API level 9
SQLRecoverableException(
    reason: String!,
    SQLState: String!,
    cause: Throwable!)

Constructs a SQLRecoverableException object with a given reason, SQLState and cause. The vendor code is initialized to 0.

Parameters
reason String!: a description of the exception.
SQLState String!: an XOPEN or SQL:2003 code identifying the exception
cause Throwable!: 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

Added in API level 9
SQLRecoverableException(
    reason: String!,
    cause: Throwable!)

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 String!: a description of the exception.
cause Throwable!: 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

Added in API level 9
SQLRecoverableException(cause: Throwable!)

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 Throwable!: 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.