public
class
SQLWarning
extends SQLException
java.lang.Object | ||||
↳ | java.lang.Throwable | |||
↳ | java.lang.Exception | |||
↳ | java.sql.SQLException | |||
↳ | java.sql.SQLWarning |
Known Direct Subclasses |
An exception that provides information on database access warnings. Warnings are silently chained to the object whose method caused it to be reported.
Warnings may be retrieved from Connection
, Statement
,
and ResultSet
objects. Trying to retrieve a warning on a
connection after it has been closed will cause an exception to be thrown.
Similarly, trying to retrieve a warning on a statement after it has been
closed or on a result set after it has been closed will cause
an exception to be thrown. Note that closing a statement also
closes a result set that it might have produced.
See also:
Public constructors | |
---|---|
SQLWarning(String reason, String SQLState, int vendorCode)
Constructs a |
|
SQLWarning(String reason, String SQLState)
Constructs a |
|
SQLWarning(String reason)
Constructs a |
|
SQLWarning()
Constructs a |
|
SQLWarning(Throwable cause)
Constructs a |
|
SQLWarning(String reason, Throwable cause)
Constructs a |
|
SQLWarning(String reason, String SQLState, Throwable cause)
Constructs a |
|
SQLWarning(String reason, String SQLState, int vendorCode, Throwable cause)
Constructs a |
Public methods | |
---|---|
SQLWarning
|
getNextWarning()
Retrieves the warning chained to this |
void
|
setNextWarning(SQLWarning w)
Adds a |
Inherited methods | |
---|---|
From
class
java.sql.SQLException
| |
From
class
java.lang.Throwable
| |
From
class
java.lang.Object
| |
From
interface
java.lang.Iterable
|
SQLWarning (String reason, String SQLState, int vendorCode)
Constructs a SQLWarning
object
with a given reason
, SQLState
and
vendorCode
.
The cause
is not initialized, and may subsequently be
initialized by a call to the
initCause(java.lang.Throwable)
method.
Parameters | |
---|---|
reason |
String :
a description of the warning |
SQLState |
String :
an XOPEN or SQL:2003 code identifying the warning |
vendorCode |
int :
a database vendor-specific warning code
|
SQLWarning (String reason, String SQLState)
Constructs a SQLWarning
object
with a given reason
and SQLState
.
The cause
is not initialized, and may subsequently be
initialized by a call to the
initCause(java.lang.Throwable)
method. The vendor code
is initialized to 0.
Parameters | |
---|---|
reason |
String :
a description of the warning |
SQLState |
String :
an XOPEN or SQL:2003 code identifying the warning
|
SQLWarning (String reason)
Constructs a SQLWarning
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
initCause(java.lang.Throwable)
method.
Parameters | |
---|---|
reason |
String :
a description of the warning
|
SQLWarning ()
Constructs a SQLWarning
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
initCause(java.lang.Throwable)
method.
SQLWarning (Throwable cause)
Constructs a SQLWarning
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
.
Parameters | |
---|---|
cause |
Throwable :
the underlying reason for this SQLWarning (which is saved for later retrieval by the getCause() method); may be null indicating
the cause is non-existent or unknown.
|
SQLWarning (String reason, Throwable cause)
Constructs a SQLWarning
object
with a given
reason
and cause
.
The SQLState
is initialized to null
and the vendor code is initialized to 0.
Parameters | |
---|---|
reason |
String :
a description of the warning |
cause |
Throwable :
the underlying reason for this SQLWarning
(which is saved for later retrieval by the getCause() method);
may be null indicating the cause is non-existent or unknown.
|
SQLWarning (String reason, String SQLState, Throwable cause)
Constructs a SQLWarning
object
with a given
reason
, SQLState
and cause
.
The vendor code is initialized to 0.
Parameters | |
---|---|
reason |
String :
a description of the warning |
SQLState |
String :
an XOPEN or SQL:2003 code identifying the warning |
cause |
Throwable :
the underlying reason for this SQLWarning (which is saved for later retrieval by the getCause() method); may be null indicating
the cause is non-existent or unknown.
|
SQLWarning (String reason, String SQLState, int vendorCode, Throwable cause)
Constructs aSQLWarning
object
with a given
reason
, SQLState
, vendorCode
and cause
.
Parameters | |
---|---|
reason |
String :
a description of the warning |
SQLState |
String :
an XOPEN or SQL:2003 code identifying the warning |
vendorCode |
int :
a database vendor-specific warning code |
cause |
Throwable :
the underlying reason for this SQLWarning (which is saved for later retrieval by the getCause() method); may be null indicating
the cause is non-existent or unknown.
|
SQLWarning getNextWarning ()
Retrieves the warning chained to this SQLWarning
object by
setNextWarning
.
Returns | |
---|---|
SQLWarning |
the next SQLException in the chain; null if none |
See also:
void setNextWarning (SQLWarning w)
Adds a SQLWarning
object to the end of the chain.
Parameters | |
---|---|
w |
SQLWarning :
the new end of the SQLException chain |
See also: