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, setNextExceptionaddSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toStringpublic 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 vender 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, 2011, Oracle and/or its affiliates. All rights reserved.
DRAFT ea-b138