- 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 ofSQLException
that provides information about database warnings set onRowSet
objects. Warnings are silently chained to the object whose method call caused it to be reported. This class complements theSQLWarning
class.Rowset warnings may be retrieved from
JdbcRowSet
,CachedRowSet
™,WebRowSet
,FilteredRowSet
, orJoinRowSet
implementations. To retrieve the first warning reported on anyRowSet
implementation, use the methodgetRowSetWarnings
defined in theJdbcRowSet
interface or theCachedRowSet
interface. To retrieve a warning chained to the first warning, use theRowSetWarning
methodgetNextWarning
. To retrieve subsequent warnings, callgetNextWarning
on eachRowSetWarning
object that is returned.The inherited methods
getMessage
,getSQLState
, andgetErrorCode
retrieve information contained in aRowSetWarning
object.- Since:
- 1.5
- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor and Description RowSetWarning()
Constructs a defaultRowSetWarning
object.RowSetWarning(String reason)
Constructs aRowSetWarning
object with the given value for the reason; SQLState defaults to null, and vendorCode defaults to 0.RowSetWarning(String reason, String SQLState)
Constructs aRowSetWarning
object initialized with the given values for the reason and SQLState.RowSetWarning(String reason, String SQLState, int vendorCode)
Constructs a fully specifiedRowSetWarning
object initialized with the given values for the reason, SQLState and vendorCode.
-
Method Summary
Methods Modifier and Type Method and Description RowSetWarning
getNextWarning()
Retrieves the warning chained to thisRowSetWarning
object.void
setNextWarning(RowSetWarning warning)
Sets warning as the next warning, that is, the warning chained to thisRowSetWarning
object.-
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
-
-
-
-
Constructor Detail
-
RowSetWarning
public RowSetWarning(String reason)
Constructs aRowSetWarning
object with the given value for the reason; SQLState defaults to null, and vendorCode defaults to 0.- Parameters:
reason
- aString
object giving a description of the warning; if theString
isnull
, this constructor behaves like the default (zero parameter)RowSetWarning
constructor
-
RowSetWarning
public RowSetWarning()
Constructs a defaultRowSetWarning
object. The reason defaults tonull
, SQLState defaults to null and vendorCode defaults to 0.
-
RowSetWarning
public RowSetWarning(String reason, String SQLState)
Constructs aRowSetWarning
object initialized with the given values for the reason and SQLState. The vendor code defaults to 0. If thereason
orSQLState
parameters arenull
, this constructor behaves like the default (zero parameter)RowSetWarning
constructor.- Parameters:
reason
- aString
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.
-
RowSetWarning
public RowSetWarning(String reason, String SQLState, int vendorCode)
Constructs a fully specifiedRowSetWarning
object initialized with the given values for the reason, SQLState and vendorCode. If thereason
, or theSQLState
parameters arenull
, this constructor behaves like the default (zero parameter)RowSetWarning
constructor.- Parameters:
reason
- aString
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.vendorCode
- a database vendor-specific warning code
-
-
Method Detail
-
getNextWarning
public RowSetWarning getNextWarning()
Retrieves the warning chained to thisRowSetWarning
object.- Returns:
- the
RowSetWarning
object chained to this one; if noRowSetWarning
object is chained to this one,null
is 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 thisRowSetWarning
object.- Parameters:
warning
- theRowSetWarning
object to be set as the next warning; if theRowSetWarning
is null, this represents the finish point in the warning chain- See Also:
getNextWarning()
-
-
Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-javax/sql/rowset/rowsetwarning.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.