Name: sdR10048 Date: 08/28/2003
Filed By : SPB JCK team (###@###.###)
JDK : java full version "1.5.0-beta-b16"
Specification excerpt:
======================
--------- J2SE API spec v.1.5 ---------
...
public void setFetchDirection(int direction) throws SQLException
Gives the driver a performance hint as to the direction in
which the rows in this JDBC RowSet will be
processed. The driver may ignore this hint.
The default fetch direction is set by the Statement object
that created this JDBC RowSet. A JDBC RowSet
may use this method at any time to change its setting for the fetch direction.
@param direction one of ResultSet.FETCH_FORWARD,
ResultSet.FETCH_REVERSE, or
ResultSet.FETCH_UNKNOWN
@throws SQLException if the JDBC RowSet type is
TYPE_FORWARD_ONLY and the given fetch direction is not
FETCH_FORWARD
@see #getFetchDirection
---------- end-of-excerpt ---------------
Problem description
===================
The spec for this method does not state the expected
behaviour if 'direction' is not one of three designated ints.
The API Spec Requirements says
(http://java.sun.com/j2se/javadoc/writingapispecs/index.html#method):
"Method Specification
This section applies to Java methods and constructors.
Each method and constructor specification must include:
. . .
Range of Valid Argument Values - Specify all valid and invalid values
for each argument, including expected behavior for invalid input
value or range of values. See example."
======================================================================
Name: sdR10048 Date: 09/02/2003
The same problem with:
RowSetMetaDataImpl.setColumnType(int columnIndex, int SQLType)
(cases when SQLType is not from Types.* should be specified)
RowSetMetaDataImpl.setNullable(int, an invalid int)
======================================================================
Filed By : SPB JCK team (###@###.###)
JDK : java full version "1.5.0-beta-b16"
Specification excerpt:
======================
--------- J2SE API spec v.1.5 ---------
...
public void setFetchDirection(int direction) throws SQLException
Gives the driver a performance hint as to the direction in
which the rows in this JDBC RowSet will be
processed. The driver may ignore this hint.
The default fetch direction is set by the Statement object
that created this JDBC RowSet. A JDBC RowSet
may use this method at any time to change its setting for the fetch direction.
@param direction one of ResultSet.FETCH_FORWARD,
ResultSet.FETCH_REVERSE, or
ResultSet.FETCH_UNKNOWN
@throws SQLException if the JDBC RowSet type is
TYPE_FORWARD_ONLY and the given fetch direction is not
FETCH_FORWARD
@see #getFetchDirection
---------- end-of-excerpt ---------------
Problem description
===================
The spec for this method does not state the expected
behaviour if 'direction' is not one of three designated ints.
The API Spec Requirements says
(http://java.sun.com/j2se/javadoc/writingapispecs/index.html#method):
"Method Specification
This section applies to Java methods and constructors.
Each method and constructor specification must include:
. . .
Range of Valid Argument Values - Specify all valid and invalid values
for each argument, including expected behavior for invalid input
value or range of values. See example."
======================================================================
Name: sdR10048 Date: 09/02/2003
The same problem with:
RowSetMetaDataImpl.setColumnType(int columnIndex, int SQLType)
(cases when SQLType is not from Types.* should be specified)
RowSetMetaDataImpl.setNullable(int, an invalid int)
======================================================================