- java.lang.Object
- 
- java.lang.Throwable
- 
- java.lang.Exception
- 
- java.sql.SQLException
- 
- java.sql.SQLRecoverableException
 
 
 
 
- 
- All Implemented Interfaces:
- Serializable,- Iterable<Throwable>
 
 public class SQLRecoverableException extends SQLException The subclass ofSQLExceptionthrown 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 SummaryConstructors Constructor Description SQLRecoverableException()Constructs aSQLRecoverableExceptionobject.SQLRecoverableException(String reason)Constructs aSQLRecoverableExceptionobject with a givenreason.SQLRecoverableException(String reason, String SQLState)Constructs aSQLRecoverableExceptionobject with a givenreasonandSQLState.SQLRecoverableException(String reason, String SQLState, int vendorCode)Constructs aSQLRecoverableExceptionobject with a givenreason,SQLStateandvendorCode.SQLRecoverableException(String reason, String SQLState, int vendorCode, Throwable cause)Constructs aSQLRecoverableExceptionobject with a givenreason,SQLState,vendorCodeandcause.SQLRecoverableException(String reason, String SQLState, Throwable cause)Constructs aSQLRecoverableExceptionobject with a givenreason,SQLStateandcause.SQLRecoverableException(String reason, Throwable cause)Constructs aSQLRecoverableExceptionobject with a givenreasonandcause.SQLRecoverableException(Throwable cause)Constructs aSQLRecoverableExceptionobject with a givencause.
 - 
Method Summary- 
Methods declared in class java.sql.SQLExceptiongetErrorCode, getNextException, getSQLState, iterator, setNextException
 - 
Methods declared in class java.lang.ThrowableaddSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
 - 
Methods declared in class java.lang.Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 - 
Methods declared in interface java.lang.IterableforEach, spliterator
 
- 
 
- 
- 
- 
Constructor Detail- 
SQLRecoverableExceptionpublic SQLRecoverableException() Constructs aSQLRecoverableExceptionobject. Thereason,SQLStateare initialized tonulland the vendor code is initialized to 0. Thecauseis not initialized, and may subsequently be initialized by a call to theThrowable.initCause(java.lang.Throwable)method.- Since:
- 1.6
 
 - 
SQLRecoverableExceptionpublic SQLRecoverableException(String reason) Constructs aSQLRecoverableExceptionobject with a givenreason. TheSQLStateis initialized tonulland the vendor code is initialized to 0. Thecauseis 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
 
 - 
SQLRecoverableExceptionpublic SQLRecoverableException(String reason, String SQLState) Constructs aSQLRecoverableExceptionobject with a givenreasonandSQLState. Thecauseis 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 exception
- SQLState- an XOPEN or SQL:2003 code identifying the exception
- Since:
- 1.6
 
 - 
SQLRecoverableExceptionpublic SQLRecoverableException(String reason, String SQLState, int vendorCode) Constructs aSQLRecoverableExceptionobject with a givenreason,SQLStateandvendorCode. Thecauseis not initialized, and may subsequently be initialized by a call to theThrowable.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
 
 - 
SQLRecoverableExceptionpublic SQLRecoverableException(Throwable cause) Constructs aSQLRecoverableExceptionobject with a givencause. TheSQLStateis initialized tonulland the vendor code is initialized to 0. Thereasonis initialized tonullifcause==nullor tocause.toString()ifcause!=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
 
 - 
SQLRecoverableExceptionpublic SQLRecoverableException(String reason, Throwable cause) Constructs aSQLRecoverableExceptionobject with a givenreasonandcause. TheSQLStateis initialized tonulland 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
 
 - 
SQLRecoverableExceptionpublic SQLRecoverableException(String reason, String SQLState, Throwable cause) Constructs aSQLRecoverableExceptionobject with a givenreason,SQLStateandcause. 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
 
 - 
SQLRecoverableExceptionpublic SQLRecoverableException(String reason, String SQLState, int vendorCode, Throwable cause) Constructs aSQLRecoverableExceptionobject with a givenreason,SQLState,vendorCodeandcause.- 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
 
 
- 
 
-