RowSetWarning (Java Platform SE 8 ) (original) (raw)

• 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 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 anyRowSet implementation, use the method getRowSetWarnings defined in the JdbcRowSet interface or the CachedRowSet interface. To retrieve a warning chained to the first warning, use theRowSetWarning methodgetNextWarning. To retrieve subsequent warnings, callgetNextWarning on each RowSetWarning object that is returned.
The inherited methods getMessage, getSQLState, and getErrorCode retrieve information contained in aRowSetWarning object.
Since:
1.5
See Also:
Serialized Form

• • Constructor Summary

  Constructors

  Constructor	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.

  • Method Summary

  All Methods Instance Methods Concrete Methods

  Modifier and Type	Method	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.

     * ### Methods inherited from class java.sql.[SQLException](../../../java/sql/SQLException.html "class in java.sql")  
     `[getErrorCode](../../../java/sql/SQLException.html#getErrorCode--), [getNextException](../../../java/sql/SQLException.html#getNextException--), [getSQLState](../../../java/sql/SQLException.html#getSQLState--), [iterator](../../../java/sql/SQLException.html#iterator--), [setNextException](../../../java/sql/SQLException.html#setNextException-java.sql.SQLException-)`  
     * ### Methods inherited from class java.lang.[Throwable](../../../java/lang/Throwable.html "class in java.lang")  
     `[addSuppressed](../../../java/lang/Throwable.html#addSuppressed-java.lang.Throwable-), [fillInStackTrace](../../../java/lang/Throwable.html#fillInStackTrace--), [getCause](../../../java/lang/Throwable.html#getCause--), [getLocalizedMessage](../../../java/lang/Throwable.html#getLocalizedMessage--), [getMessage](../../../java/lang/Throwable.html#getMessage--), [getStackTrace](../../../java/lang/Throwable.html#getStackTrace--), [getSuppressed](../../../java/lang/Throwable.html#getSuppressed--), [initCause](../../../java/lang/Throwable.html#initCause-java.lang.Throwable-), [printStackTrace](../../../java/lang/Throwable.html#printStackTrace--), [printStackTrace](../../../java/lang/Throwable.html#printStackTrace-java.io.PrintStream-), [printStackTrace](../../../java/lang/Throwable.html#printStackTrace-java.io.PrintWriter-), [setStackTrace](../../../java/lang/Throwable.html#setStackTrace-java.lang.StackTraceElement:A-), [toString](../../../java/lang/Throwable.html#toString--)`  
     * ### Methods inherited from class java.lang.[Object](../../../java/lang/Object.html "class in java.lang")  
     `[clone](../../../java/lang/Object.html#clone--), [equals](../../../java/lang/Object.html#equals-java.lang.Object-), [finalize](../../../java/lang/Object.html#finalize--), [getClass](../../../java/lang/Object.html#getClass--), [hashCode](../../../java/lang/Object.html#hashCode--), [notify](../../../java/lang/Object.html#notify--), [notifyAll](../../../java/lang/Object.html#notifyAll--), [wait](../../../java/lang/Object.html#wait--), [wait](../../../java/lang/Object.html#wait-long-), [wait](../../../java/lang/Object.html#wait-long-int-)`  
     * ### Methods inherited from interface java.lang.[Iterable](../../../java/lang/Iterable.html "interface in java.lang")  
     `[forEach](../../../java/lang/Iterable.html#forEach-java.util.function.Consumer-), [spliterator](../../../java/lang/Iterable.html#spliterator--)`

• • Constructor Detail

     * #### RowSetWarning  
     public RowSetWarning([String](../../../java/lang/String.html "class in java.lang") reason)  
     Constructs a `RowSetWarning` object with the given value for the reason; SQLState defaults to null, and vendorCode defaults to 0.  
     Parameters:  
     `reason` \- a `String` object giving a description of the warning; if the `String` is `null`, this constructor behaves like the default (zero parameter)`RowSetWarning` constructor  
     * #### RowSetWarning  
     public RowSetWarning()  
     Constructs a default `RowSetWarning` object. The reason defaults to `null`, SQLState defaults to null and vendorCode defaults to 0.  
     * #### RowSetWarning  
     public RowSetWarning([String](../../../java/lang/String.html "class in java.lang") reason,  
                          [String](../../../java/lang/String.html "class in java.lang") SQLState)  
     Constructs a `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.  
     Parameters:  
     `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.  
     * #### RowSetWarning  
     public RowSetWarning([String](../../../java/lang/String.html "class in java.lang") reason,  
                          [String](../../../java/lang/String.html "class in java.lang") SQLState,  
                          int vendorCode)  
     Constructs a fully specified `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.  
     Parameters:  
     `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.  
     `vendorCode` \- a database vendor-specific warning code  

  • Method Detail

    * #### getNextWarning  
    public [RowSetWarning](../../../javax/sql/rowset/RowSetWarning.html "class in javax.sql.rowset") getNextWarning()  
    Retrieves the warning chained to this `RowSetWarning` object.  
    Returns:  
    the `RowSetWarning` object chained to this one; if no`RowSetWarning` object is chained to this one,`null` is returned (default value)  
    See Also:  
    [setNextWarning(javax.sql.rowset.RowSetWarning)](../../../javax/sql/rowset/RowSetWarning.html#setNextWarning-javax.sql.rowset.RowSetWarning-)  
    * #### setNextWarning  
    public void setNextWarning([RowSetWarning](../../../javax/sql/rowset/RowSetWarning.html "class in javax.sql.rowset") warning)  
    Sets _warning_ as the next warning, that is, the warning chained to this `RowSetWarning` object.  
    Parameters:  
    `warning` \- the `RowSetWarning` object to be set as the next warning; if the `RowSetWarning` is null, this represents the finish point in the warning chain  
    See Also:  
    [getNextWarning()](../../../javax/sql/rowset/RowSetWarning.html#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, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.