compact2, compact3
java.sql
Class SQLRecoverableException
- 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 ofSQLException
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:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor and Description SQLRecoverableException()
Constructs 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 Detail
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
public SQLRecoverableException(String reason)
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
public SQLRecoverableException(String reason, String SQLState)
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 exception -
SQLState
- an XOPEN or SQL:2003 code identifying the exception - Since:
- 1.6
SQLRecoverableException
public SQLRecoverableException(String reason, String SQLState, int vendorCode)
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 exception -
SQLState
- an XOPEN or SQL:2003 code identifying the exception -
vendorCode
- a database vendor specific exception code - Since:
- 1.6
SQLRecoverableException
public SQLRecoverableException(Throwable cause)
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
public SQLRecoverableException(String reason, Throwable cause)
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
public SQLRecoverableException(String reason, String SQLState, Throwable cause)
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 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
public SQLRecoverableException(String reason, String SQLState, int vendorCode, Throwable cause)
Constructs aSQLRecoverableException
object with a givenreason
,SQLState
,vendorCode
andcause
.- 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 thisSQLException
(which is saved for later retrieval by thegetCause()
method); may be null indicating the cause is non-existent or unknown. - Since:
- 1.6
-
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.