- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- java.sql.SQLException
-
- javax.sql.rowset.RowSetWarning
-
- All Implemented Interfaces:
Serializable,Iterable<Throwable>
public class RowSetWarning extends SQLException
An extension ofSQLExceptionthat provides information about database warnings set onRowSetobjects. Warnings are silently chained to the object whose method call caused it to be reported. This class complements theSQLWarningclass.Rowset warnings may be retrieved from
JdbcRowSet,CachedRowSet™,WebRowSet,FilteredRowSet, orJoinRowSetimplementations. To retrieve the first warning reported on anyRowSetimplementation, use the methodgetRowSetWarningsdefined in theJdbcRowSetinterface or theCachedRowSetinterface. To retrieve a warning chained to the first warning, use theRowSetWarningmethodgetNextWarning. To retrieve subsequent warnings, callgetNextWarningon eachRowSetWarningobject that is returned.The inherited methods
getMessage,getSQLState, andgetErrorCoderetrieve information contained in aRowSetWarningobject.- Since:
- 1.5
- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor Description RowSetWarning()Constructs 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
All Methods Instance Methods Concrete Methods Modifier and Type Method Description RowSetWarninggetNextWarning()Retrieves 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, setNextException
-
Methods declared in class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
Methods declared in class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods declared in interface java.lang.Iterable
forEach, spliterator
-
-
-
-
Constructor Detail
-
RowSetWarning
public RowSetWarning(String reason)
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
public RowSetWarning(String reason, String SQLState)
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
public RowSetWarning(String reason, String SQLState, int vendorCode)
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 Detail
-
getNextWarning
public RowSetWarning 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(javax.sql.rowset.RowSetWarning)
-
setNextWarning
public void setNextWarning(RowSetWarning warning)
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:
getNextWarning()
-
-