Serializable
, Iterable<Throwable>
BatchUpdateException
, RowSetWarning
, SerialException
, SQLClientInfoException
, SQLNonTransientException
, SQLRecoverableException
, SQLTransientException
, SQLWarning
, SyncFactoryException
, SyncProviderException
public class SQLException extends Exception implements Iterable<Throwable>
An exception that provides information on a database access error or other errors.
Each SQLException
provides several kinds of information:
getMessage
. DatabaseMetaData
method getSQLStateType
can be used to discover whether the driver returns the XOPEN type or the SQL:2003 type. SQLException
. Constructor | Description |
---|---|
SQLException() |
Constructs a SQLException object. |
SQLException |
Constructs a SQLException object with a given reason . |
SQLException |
Constructs a SQLException object with a given reason and SQLState . |
SQLException |
Constructs a SQLException object with a given reason , SQLState and vendorCode . |
SQLException |
Constructs a SQLException object with a given reason , SQLState , vendorCode and cause . |
SQLException |
Constructs a SQLException object with a given reason , SQLState and cause . |
SQLException |
Constructs a SQLException object with a given reason and cause . |
SQLException |
Constructs a SQLException object with a given cause . |
Modifier and Type | Method | Description |
---|---|---|
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. |
Iterator |
iterator() |
Returns an iterator over the chained SQLExceptions. |
void |
setNextException |
Adds an SQLException object to the end of the chain. |
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
forEach, spliterator
public SQLException(String reason, String SQLState, int vendorCode)
SQLException
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.reason
- a description of the exceptionSQLState
- an XOPEN or SQL:2003 code identifying the exceptionvendorCode
- a database vendor-specific exception codepublic SQLException(String reason, String SQLState)
SQLException
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.reason
- a description of the exceptionSQLState
- an XOPEN or SQL:2003 code identifying the exceptionpublic SQLException(String reason)
SQLException
object with a given reason
. The SQLState
is 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.reason
- a description of the exceptionpublic SQLException()
SQLException
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.public SQLException(Throwable cause)
SQLException
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
.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.public SQLException(String reason, Throwable cause)
SQLException
object with a given reason
and cause
. The SQLState
is initialized to null
and the vendor code is initialized to 0.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.public SQLException(String reason, String sqlState, Throwable cause)
SQLException
object with a given reason
, SQLState
and cause
. The vendor code is initialized to 0.reason
- a description of the exception.sqlState
- an XOPEN or SQL:2003 code identifying the exceptioncause
- 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.public SQLException(String reason, String sqlState, int vendorCode, Throwable cause)
SQLException
object with a given reason
, SQLState
, vendorCode
and cause
.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 this SQLException
(which is saved for later retrieval by the getCause()
method); may be null indicating the cause is non-existent or unknown.public String getSQLState()
SQLException
object.public int getErrorCode()
SQLException
object.public SQLException getNextException()
SQLException
object by setNextException(SQLException ex).SQLException
object in the chain; null
if there are nonepublic void setNextException(SQLException ex)
SQLException
object to the end of the chain.ex
- the new exception that will be added to the end of the SQLException
chainpublic Iterator<Throwable> iterator()
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.sql/java/sql/SQLException.html