Name: sdR10048 Date: 10/22/2003
Filed By : SPB JCK team (###@###.###)
JDK : java full version "1.5.0-beta-b23"
Problem description
===================
Uncertainty in BaseRowSet spec while calling BaseRowSet class.
Quotes:
"public int getFetchDirection() throws java.sql.SQLException
Retrieves this JDBC RowSet object's current setting for the fetch
direction."
(Here BaseRowSet class called as "JDBC RowSet")
Quote:
"public void setUrl(java.lang.String url) throws java.sql.SQLException
The JDBC RowSet will use the URL internally to create a database
connection in order to read or write data."
(Here "JDBC RowSet" means the BaseRowSet subclass wich
implements some of interfaces JdbcRowSet, CachedRowSet..)
That is pretty confusing. It takes time to determine what
functionality belongs to what class (this BaseRowSet or some
subclass) because it is ambiguous.
And that problem exists all over the BaseRowSet class
description. It is un-separated the current (BaseRowSet) class's
definition and some abstract description of BaseRowSet's
subclasses implementations. May be some assertion like "here and
further under "JDBC RowSet we mean BaseRowSet" should be stated or
something should be done here.
======================================================================
Filed By : SPB JCK team (###@###.###)
JDK : java full version "1.5.0-beta-b23"
Problem description
===================
Uncertainty in BaseRowSet spec while calling BaseRowSet class.
Quotes:
"public int getFetchDirection() throws java.sql.SQLException
Retrieves this JDBC RowSet object's current setting for the fetch
direction."
(Here BaseRowSet class called as "JDBC RowSet")
Quote:
"public void setUrl(java.lang.String url) throws java.sql.SQLException
The JDBC RowSet will use the URL internally to create a database
connection in order to read or write data."
(Here "JDBC RowSet" means the BaseRowSet subclass wich
implements some of interfaces JdbcRowSet, CachedRowSet..)
That is pretty confusing. It takes time to determine what
functionality belongs to what class (this BaseRowSet or some
subclass) because it is ambiguous.
And that problem exists all over the BaseRowSet class
description. It is un-separated the current (BaseRowSet) class's
definition and some abstract description of BaseRowSet's
subclasses implementations. May be some assertion like "here and
further under "JDBC RowSet we mean BaseRowSet" should be stated or
something should be done here.
======================================================================