Name: sdR10048 Date: 10/22/2003


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

Problem description
===================
BaseRowSet's javadoc sometimes does not make a difference between
this BaseRowSet's behaviour and BaseRowSet's subclasses' behaviour.
The problem points are:

public java.lang.String getCommand()

    Quote:
    "The command property contains the query that will be executed to
    populate this JDBC RowSet."

    This "JDBC RowSet" does not have method execute. There is no
    possibility to populate this class.

public int getConcurrency() throws java.sql.SQLException

    Quote:
    "The concurrency is initially determined by the statement that
    created the JDBC RowSet."

    I guess it means BaseRowSet's subclass.

public int getConcurrency() throws java.sql.SQLException

    Quote:
    "For disconnected JDBC RowSet implementations such as the
    CachedRowSet that operate in a disconnected environment the
    SyncFactory SPIs and SyncProvider mechanisms offer complimentary
    concurrency options. The options described below are pertinant
    only to connected JDBC RowSet's such as the JdbcRowSet."

    I believe that the better place for this information in
    corresponding subclasses (CachedRowSet, JdbcRowSet). May be in
    class description part.

    (Sort of refinement issue)

Some methods have the following javadoc quote:

    "The parameter value set by this method is stored internally and
     will be supplied as the appropriate parameter in this JDBC
     RowSet's command when the method execute is called."

    Unclear point: BaseRowSet does not have execute method
    (yet). Clarifications needed.

    The methods are (not complete list):
    public void setShort(int parameterIndex, short x) throws java.sql.SQLException
    public void setInt(int parameterIndex, int x) throws java.sql.SQLException
    public void setNull(int parameterIndex, int sqlType) throws java.sql.SQLException
    public void setNull(int parameterIndex, int sqlType, java.lang.String typeName) 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
    ...

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