compact3
javax.sql.rowset
Class RowSetWarning
- 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 and 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 and 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 inherited from class java.sql.SQLException
getErrorCode, getNextException, getSQLState, iterator, setNextException
-
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from 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()
-
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, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.
