Name: sdR10048 Date: 10/22/2003


Filed By : SPB JCK team (###@###.###)
JDK : java full version "1.5.0-beta-b23"

Problem description
===================
There some methods (pretty considerable amount) with such an assertion
(this or something like this):
    "Throws: java.sql.SQLException - if an error occurs" or
    "Throws: java.sql.SQLException - if an error occurs internally
     determining..."
    "Throws: java.sql.SQLException - if error occurs retrieving the
     URL value used to establish the originating connection to the
     JDBC datasource"

It is unclear what kind of error can occur in this class. Unclear
which are the expected circumstances when the error can occur. There
is no connectivity or something more complicated than
setting/getting. As class description says:

"An abstract class providing a RowSet object with its basic
 functionality, including properties and event notification, which all
 JavaBeans components must implement.
 ...
 The BaseRowSet class provides the core functionality and basis for all
 standard RowSet implementations of the JdbcRowSet, CachedRowSet,
 WebRowSet, FilteredRowSet and JoinRowSet interfaces defined in this
 specification. Vendors and developer alike must extend this class and
 implement their chosen RowSet interface(s) to maintain compatibility
 with other implementations, and remain standard according to this
 specification."

It is understood that this class is designed to be extended. But this
specification is BaseRowSet's one. It should be ruled somehow, some
data regarding this issue should be stated here.

Here are some (not complete list) methods with the designated problem:

public void clearParameters() throws java.sql.SQLException
public java.lang.Object[] getParams() throws java.sql.SQLException
public void setBoolean(int?parameterIndex, boolean?x) throws java.sql.SQLException
public void setByte(int?parameterIndex, byte?x) throws java.sql.SQLException
public void setBytes(int?parameterIndex, byte[]?x) throws java.sql.SQLException
public int getType() throws java.sql.SQLException
public void setUnicodeStream(int?parameterIndex, java.io.InputStream?x, int?length) throws java.sql.SQLException
...


======================================================================