java.lang.Object
java.lang.Throwable
java.lang.Exception
java.sql.SQLException
javax.sql.rowset.RowSetWarning
- All Implemented Interfaces:
Serializable,Iterable<Throwable>
An extension of
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,
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.
- Since:
- 1.5
- See Also:
-
Constructor Summary
ConstructorsConstructorDescriptionConstructs a defaultRowSetWarningobject.RowSetWarning(String reason) Constructs aRowSetWarningobject with the given value for the reason; SQLState defaults to null, and vendorCode defaults to 0.RowSetWarning(String reason, String SQLState) Constructs aRowSetWarningobject initialized with the given values for the reason and SQLState.RowSetWarning(String reason, String SQLState, int vendorCode) Constructs a fully specifiedRowSetWarningobject initialized with the given values for the reason, SQLState and vendorCode. -
Method Summary
Modifier and TypeMethodDescriptionRetrieves the warning chained to thisRowSetWarningobject.voidsetNextWarning(RowSetWarning warning) Sets warning as the next warning, that is, the warning chained to thisRowSetWarningobject.Methods declared in class java.sql.SQLException
getErrorCode, getNextException, getSQLState, iterator, setNextExceptionMethods declared in class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toStringMethods declared in class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitMethods declared in interface java.lang.Iterable
forEach, spliterator
-
Constructor Details
-
RowSetWarning
Constructs aRowSetWarningobject with the given value for the reason; SQLState defaults to null, and vendorCode defaults to 0.- Parameters:
reason- aStringobject giving a description of the warning; if theStringisnull, this constructor behaves like the default (zero parameter)RowSetWarningconstructor
-
RowSetWarning
public RowSetWarning()Constructs a defaultRowSetWarningobject. The reason defaults tonull, SQLState defaults to null and vendorCode defaults to 0. -
RowSetWarning
Constructs aRowSetWarningobject initialized with the given values for the reason and SQLState. The vendor code defaults to 0. If thereasonorSQLStateparameters arenull, this constructor behaves like the default (zero parameter)RowSetWarningconstructor.- Parameters:
reason- aStringgiving a description of the warning;SQLState- an XOPEN code identifying the warning; if a non standard XOPEN SQLState is supplied, no exception is thrown.
-
RowSetWarning
Constructs a fully specifiedRowSetWarningobject initialized with the given values for the reason, SQLState and vendorCode. If thereason, or theSQLStateparameters arenull, this constructor behaves like the default (zero parameter)RowSetWarningconstructor.- Parameters:
reason- aStringgiving a description of the warning;SQLState- an XOPEN code identifying the warning; if a non standard XOPEN SQLState is supplied, no exception is thrown.vendorCode- a database vendor-specific warning code
-
-
Method Details
-
getNextWarning
Retrieves the warning chained to thisRowSetWarningobject.- Returns:
- the
RowSetWarningobject chained to this one; if noRowSetWarningobject is chained to this one,nullis returned (default value) - See Also:
-
setNextWarning
Sets warning as the next warning, that is, the warning chained to thisRowSetWarningobject.- Parameters:
warning- theRowSetWarningobject to be set as the next warning; if theRowSetWarningis null, this represents the finish point in the warning chain- See Also:
-