public class SQLWarning extends SQLException
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.
Constructor and Description |
---|
SQLWarning()
Constructs a
SQLWarning object. |
SQLWarning(String reason)
Constructs a
SQLWarning object
with a given reason . |
SQLWarning(String reason,
String SQLState)
Constructs a
SQLWarning object
with a given reason and SQLState . |
SQLWarning(String reason,
String SQLState,
int vendorCode)
Constructs a
SQLWarning object
with a given reason , SQLState and
vendorCode . |
SQLWarning(String reason,
String SQLState,
int vendorCode,
Throwable cause)
Constructs a
SQLWarning object
with a given
reason , SQLState , vendorCode
and cause . |
SQLWarning(String reason,
String SQLState,
Throwable cause)
Constructs a
SQLWarning object
with a given
reason , SQLState and cause . |
SQLWarning(String reason,
Throwable cause)
Constructs a
SQLWarning object
with a given
reason and cause . |
SQLWarning(Throwable cause)
Constructs a
SQLWarning object
with a given cause . |
Modifier and Type | Method and Description |
---|---|
SQLWarning |
getNextWarning()
Retrieves the warning chained to this
SQLWarning object by
setNextWarning . |
void |
setNextWarning(SQLWarning w)
Adds a
SQLWarning object to the end of the chain. |
getErrorCode, getNextException, getSQLState, iterator, setNextException
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 SQLWarning(String reason, String SQLState, int vendorCode)
SQLWarning
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 warningSQLState
- an XOPEN or SQL:2003 code identifying the warningvendorCode
- a database vendor-specific warning codepublic SQLWarning(String reason, String SQLState)
SQLWarning
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 warningSQLState
- an XOPEN or SQL:2003 code identifying the warningpublic SQLWarning(String reason)
SQLWarning
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 warningpublic SQLWarning()
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
Throwable.initCause(java.lang.Throwable)
method.public SQLWarning(Throwable cause)
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
.
cause
- 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.public SQLWarning(String reason, Throwable cause)
SQLWarning
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 warningcause
- 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.public SQLWarning(String reason, String SQLState, Throwable cause)
SQLWarning
object
with a given
reason
, SQLState
and cause
.
The vendor code is initialized to 0.
reason
- a description of the warningSQLState
- an XOPEN or SQL:2003 code identifying the warningcause
- 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.public SQLWarning(String reason, String SQLState, int vendorCode, Throwable cause)
SQLWarning
object
with a given
reason
, SQLState
, vendorCode
and cause
.
reason
- a description of the warningSQLState
- an XOPEN or SQL:2003 code identifying the warningvendorCode
- a database vendor-specific warning codecause
- 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.public SQLWarning getNextWarning()
SQLWarning
object by
setNextWarning
.SQLException
in the chain; null
if nonesetNextWarning(java.sql.SQLWarning)
public void setNextWarning(SQLWarning w)
SQLWarning
object to the end of the chain.w
- the new end of the SQLException
chaingetNextWarning()
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, 2016, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.