public class RowSetWarning extends SQLException
SQLException
that provides information
about database warnings set on RowSet
objects.
Warnings are silently chained to the object whose method call
caused it to be reported.
This class complements the SQLWarning
class.
Rowset warnings may be retrieved from JdbcRowSet
,
CachedRowSet
TM,
WebRowSet
, FilteredRowSet
, or JoinRowSet
implementations. To retrieve the first warning reported on any
RowSet
implementation, use the method getRowSetWarnings
defined
in the JdbcRowSet
interface or the CachedRowSet
interface. To retrieve a warning chained to the first warning, use the
RowSetWarning
method
getNextWarning
. To retrieve subsequent warnings, call
getNextWarning
on each RowSetWarning
object that is
returned.
The inherited methods getMessage
, getSQLState
,
and getErrorCode
retrieve information contained in a
RowSetWarning
object.
Constructor and Description |
---|
RowSetWarning()
Constructs a default
RowSetWarning object. |
RowSetWarning(String reason)
Constructs a
RowSetWarning object
with the given value for the reason; SQLState defaults to null,
and vendorCode defaults to 0. |
RowSetWarning(String reason,
String SQLState)
Constructs a
RowSetWarning object initialized with the
given values for the reason and SQLState. |
RowSetWarning(String reason,
String SQLState,
int vendorCode)
Constructs a fully specified
RowSetWarning object initialized
with the given values for the reason, SQLState and vendorCode. |
Modifier and Type | Method and Description |
---|---|
RowSetWarning |
getNextWarning()
Retrieves the warning chained to this
RowSetWarning
object. |
void |
setNextWarning(RowSetWarning warning)
Sets warning as the next warning, that is, the warning chained
to this
RowSetWarning object. |
getErrorCode, getNextException, getSQLState, iterator, setNextException
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
public RowSetWarning(String reason)
RowSetWarning
object
with the given value for the reason; SQLState defaults to null,
and vendorCode defaults to 0.reason
- a String
object giving a description
of the warning; if the String
is null
,
this constructor behaves like the default (zero parameter)
RowSetWarning
constructorpublic RowSetWarning()
RowSetWarning
object. The reason
defaults to null
, SQLState defaults to null and vendorCode
defaults to 0.public RowSetWarning(String reason, String SQLState)
RowSetWarning
object initialized with the
given values for the reason and SQLState. The vendor code defaults to 0.
If the reason
or SQLState
parameters are null
,
this constructor behaves like the default (zero parameter)
RowSetWarning
constructor.reason
- a String
giving a description of the
warning;SQLState
- an XOPEN code identifying the warning; if a non standard
XOPEN SQLState is supplied, no exception is thrown.public RowSetWarning(String reason, String SQLState, int vendorCode)
RowSetWarning
object initialized
with the given values for the reason, SQLState and vendorCode.
If the reason
, or the SQLState
parameters are null
, this constructor behaves like the default
(zero parameter) RowSetWarning
constructor.reason
- a String
giving a description of the
warning;SQLState
- an XOPEN code identifying the warning; if a non standard
XPOEN SQLState is supplied, no exception is thrown.vendorCode
- a database vendor-specific warning codepublic RowSetWarning getNextWarning()
RowSetWarning
object.RowSetWarning
object chained to this one; if no
RowSetWarning
object is chained to this one,
null
is returned (default value)setNextWarning(javax.sql.rowset.RowSetWarning)
public void setNextWarning(RowSetWarning warning)
RowSetWarning
object.warning
- the RowSetWarning
object to be set as the
next warning; if the RowSetWarning
is null, this
represents the finish point in the warning 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