SQLRecoverableException (Java SE 12 & JDK 12 )
- 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 of
SQLExceptionthrown 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 Description SQLRecoverableException()Constructs a
SQLRecoverableExceptionobject.SQLRecoverableException(String reason)Constructs a
SQLRecoverableExceptionobject with a givenreason.SQLRecoverableException(String reason, String SQLState)Constructs a
SQLRecoverableExceptionobject with a givenreasonandSQLState.SQLRecoverableException(String reason, String SQLState, int vendorCode)Constructs a
SQLRecoverableExceptionobject with a givenreason,SQLStateandvendorCode.SQLRecoverableException(String reason, String SQLState, int vendorCode, Throwable cause)Constructs a
SQLRecoverableExceptionobject with a givenreason,SQLState,vendorCodeandcause.SQLRecoverableException(String reason, String SQLState, Throwable cause)Constructs a
SQLRecoverableExceptionobject with a givenreason,SQLStateandcause.SQLRecoverableException(String reason, Throwable cause)Constructs a
SQLRecoverableExceptionobject with a givenreasonandcause.SQLRecoverableException(Throwable cause)Constructs a
SQLRecoverableExceptionobject with a givencause.
-
Method Summary
-
Methods declared in class java.sql.SQLException
getErrorCode, getNextException, getSQLState, iterator, setNextException
-
Methods declared in class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
Methods declared in class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods declared in interface java.lang.Iterable
forEach, spliterator
-
-
-
-
Constructor Detail
-
SQLRecoverableException
public SQLRecoverableException()
Constructs a
SQLRecoverableExceptionobject. 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
-
SQLRecoverableException
public SQLRecoverableException(String reason)
Constructs a
SQLRecoverableExceptionobject 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
-
SQLRecoverableException
public SQLRecoverableException(String reason, String SQLState)
Constructs a
SQLRecoverableExceptionobject 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 exceptionSQLState- an XOPEN or SQL:2003 code identifying the exception- Since:
- 1.6
-
SQLRecoverableException
public SQLRecoverableException(String reason, String SQLState, int vendorCode)
Constructs a
SQLRecoverableExceptionobject 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 exceptionSQLState- an XOPEN or SQL:2003 code identifying the exceptionvendorCode- a database vendor specific exception code- Since:
- 1.6
-
SQLRecoverableException
public SQLRecoverableException(Throwable cause)
Constructs a
SQLRecoverableExceptionobject 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 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 a
SQLRecoverableExceptionobject 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 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 a
SQLRecoverableExceptionobject 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 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
public SQLRecoverableException(String reason, String SQLState, int vendorCode, Throwable cause)
Constructs a
SQLRecoverableExceptionobject with a givenreason,SQLState,vendorCodeandcause.- 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
-
-
Report a bug or suggest an enhancement
For further API reference and developer documentation see the Java SE Documentation, which contains more detailed, developer-targeted descriptions with conceptual overviews, definitions of terms, workarounds, and working code examples.
Java is a trademark or registered trademark of Oracle and/or its affiliates in the US and other countries.
Copyright © 1993, 2019, Oracle and/or its affiliates, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
All rights reserved. Use is subject to license terms and the documentation redistribution policy.