Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| JavaTM 2 Platform Standard Ed. 5.0
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## 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

    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`TM, `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.

See Also:
  Serialized Form

Constructor Summary
`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
`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
`getErrorCode, getNextException, getSQLState, setNextException`

Methods inherited from class java.lang.Throwable
`fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

Constructor Detail

### RowSetWarning

    public RowSetWarning(String 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 reason,
                         String 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 reason,
                         String 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 XPOEN 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 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)`

### setNextWarning

    public void setNextWarning(RowSetWarning 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()`

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| JavaTM 2 Platform Standard Ed. 5.0
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.