| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public exception SQLException extends Exception implements Iterable
An exception that provides information on a database access error or other errors.
Each SQLException
provides several kinds of information:
getMesasge
.
DatabaseMetaData
method getSQLStateType
can be used to discover whether the driver returns the XOPEN type or
the SQL:2003 type.
SQLException
.
Constructor Summary | |
---|---|
Constructs a SQLException object.
|
|
SQLException(String reason) Constructs a SQLException object with a given
reason .
|
|
SQLException(String reason, String SQLState) Constructs a SQLException object with a given
reason and SQLState .
|
|
SQLException(String reason, String SQLState, int vendorCode) Constructs a SQLException object with a given
reason , SQLState and
vendorCode .
|
|
SQLException(String reason, String sqlState, int vendorCode, Throwable cause) Constructs a SQLException object with a given
reason , SQLState , vendorCode
and cause .
|
|
SQLException(String reason, String sqlState, Throwable cause) Constructs a SQLException object with a given
reason , SQLState and cause .
|
|
SQLException(String reason, Throwable cause) Constructs a SQLException object with a given
reason and cause .
|
|
SQLException(Throwable cause) Constructs a SQLException object with a given
cause .
|
Method Summary | |
---|---|
int |
Retrieves the vendor-specific exception code for this SQLException object.
|
SQLException |
Retrieves the exception chained to this SQLException object by setNextException(SQLException ex).
|
String |
Retrieves the SQLState for this SQLException object.
|
Iterator |
iterator() Returns an iterator over the chained SQLExceptions. |
void |
Adds an SQLException object to the end of the chain.
|
Methods inherited from class java.lang.Throwable |
---|
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public 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
{@link Throwable#initCause(java.lang.Throwable)} method.
public SQLException(String reason)
SQLException
object with a given
reason
. The SQLState
is initialized to
null
and the vender code is initialized to 0.
The cause
is not initialized, and may subsequently be
initialized by a call to the
{@link Throwable#initCause(java.lang.Throwable)} method.
reason
- a description of the exceptionpublic 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
{@link 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, 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
{@link 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, 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 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, 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(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.Method Detail |
---|
public int getErrorCode()
SQLException
object.
public SQLException getNextException()
SQLException
object by setNextException(SQLException ex).
SQLException
object in the chain;
null
if there are nonepublic String getSQLState()
SQLException
object.
public Iterator iterator()
public 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
chain
| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |