Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-4914161

javax.sql.rowset.BaseRowSet.setFetchDirection: spec unclear

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Fixed
    • Icon: P3 P3
    • 5.0
    • 5.0
    • docs
    • beta
    • sparc
    • solaris_2.6
    • Verified

      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)



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

            jbrucesunw Jonathan Bruce (Inactive)
            dsvsunw Dsv Dsv (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: