Class SQLRecoverableException
java.lang.Object
java.lang.Throwable
java.lang.Exception
java.sql.SQLException
java.sql.SQLRecoverableException
- All Implemented Interfaces:
Serializable
,Iterable<Throwable>
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:
-
Constructor Summary
ConstructorDescriptionConstructs aSQLRecoverableException
object.SQLRecoverableException
(String reason) Constructs aSQLRecoverableException
object with a givenreason
.SQLRecoverableException
(String reason, String SQLState) Constructs aSQLRecoverableException
object with a givenreason
andSQLState
.SQLRecoverableException
(String reason, String SQLState, int vendorCode) Constructs aSQLRecoverableException
object with a givenreason
,SQLState
andvendorCode
.SQLRecoverableException
(String reason, String SQLState, int vendorCode, Throwable cause) Constructs aSQLRecoverableException
object with a givenreason
,SQLState
,vendorCode
andcause
.SQLRecoverableException
(String reason, String SQLState, Throwable cause) Constructs aSQLRecoverableException
object with a givenreason
,SQLState
andcause
.SQLRecoverableException
(String reason, Throwable cause) Constructs aSQLRecoverableException
object with a givenreason
andcause
.SQLRecoverableException
(Throwable cause) Constructs aSQLRecoverableException
object with a givencause
. -
Method Summary
Methods inherited from class java.sql.SQLException
getErrorCode, getNextException, getSQLState, iterator, setNextException
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface java.lang.Iterable
forEach, spliterator
-
Constructor Details
-
SQLRecoverableException
public SQLRecoverableException()Constructs aSQLRecoverableException
object. Thereason
,SQLState
are initialized tonull
and the vendor code is initialized to 0. Thecause
is not initialized, and may subsequently be initialized by a call to theThrowable.initCause(java.lang.Throwable)
method.- Since:
- 1.6
-
SQLRecoverableException
Constructs aSQLRecoverableException
object with a givenreason
. TheSQLState
is initialized tonull
and the vendor code is initialized to 0. Thecause
is not initialized, and may subsequently be initialized by a call to theThrowable.initCause(java.lang.Throwable)
method.- Parameters:
reason
- a description of the exception- Since:
- 1.6
-
SQLRecoverableException
Constructs aSQLRecoverableException
object with a givenreason
andSQLState
. Thecause
is not initialized, and may subsequently be initialized by a call to theThrowable.initCause(java.lang.Throwable)
method. The vendor code is initialized to 0.- Parameters:
reason
- a description of the exceptionSQLState
- an XOPEN or SQL:2003 code identifying the exception- Since:
- 1.6
-
SQLRecoverableException
Constructs aSQLRecoverableException
object with a givenreason
,SQLState
andvendorCode
. Thecause
is not initialized, and may subsequently be initialized by a call to theThrowable.initCause(java.lang.Throwable)
method.- Parameters:
reason
- a description of the exceptionSQLState
- an XOPEN or SQL:2003 code identifying the exceptionvendorCode
- a database vendor specific exception code- Since:
- 1.6
-
SQLRecoverableException
Constructs aSQLRecoverableException
object with a givencause
. TheSQLState
is initialized tonull
and the vendor code is initialized to 0. Thereason
is initialized tonull
ifcause==null
or tocause.toString()
ifcause!=null
.- Parameters:
cause
- the underlying reason for thisSQLException
(which is saved for later retrieval by thegetCause()
method); may be null indicating the cause is non-existent or unknown.- Since:
- 1.6
-
SQLRecoverableException
Constructs aSQLRecoverableException
object with a givenreason
andcause
. TheSQLState
is initialized tonull
and the vendor code is initialized to 0.- Parameters:
reason
- a description of the exception.cause
- the underlying reason for thisSQLException
(which is saved for later retrieval by thegetCause()
method); may be null indicating the cause is non-existent or unknown.- Since:
- 1.6
-
SQLRecoverableException
Constructs aSQLRecoverableException
object with a givenreason
,SQLState
andcause
. The vendor code is initialized to 0.- Parameters:
reason
- a description of the exception.SQLState
- an XOPEN or SQL:2003 code identifying the exceptioncause
- the underlying reason for thisSQLException
(which is saved for later retrieval by thegetCause()
method); may be null indicating the cause is non-existent or unknown.- Since:
- 1.6
-
SQLRecoverableException
Constructs aSQLRecoverableException
object with a givenreason
,SQLState
,vendorCode
andcause
.- Parameters:
reason
- a description of the exceptionSQLState
- an XOPEN or SQL:2003 code identifying the exceptionvendorCode
- a database vendor-specific exception codecause
- the underlying reason for thisSQLException
(which is saved for later retrieval by thegetCause()
method); may be null indicating the cause is non-existent or unknown.- Since:
- 1.6
-