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

Incorrect API documentation for java.sql.CallableStatement class

XMLWordPrintable

    • Icon: Enhancement Enhancement
    • Resolution: Fixed
    • Icon: P4 P4
    • 6
    • 5.0
    • core-libs
    • beta2
    • x86
    • windows_xp
    • Not verified

      A DESCRIPTION OF THE REQUEST :
      The JDBC 3.0 specification and API documentation (JavaDoc) for java.sql.CallableStatement class describes the escape syntax for calling a database stored procedure differently

      Spec: {call <procedure-name>[(<arg1>,<arg2>, ...)]}.
      JavaDoc: {call <procedure-name>[<arg1>,<arg2>, ...]}.

      The difference is the parentheses for parameter list.


      JUSTIFICATION :
      Some JDBC drivers (e.g. JNetDirect JSQLConnect) works fine with both syntax variants, but others (e.g. Microsoft JDBC Driver for MS SQL Server) fails w/o parentheses. That makes application code driver-dependent.


      CUSTOMER SUBMITTED WORKAROUND :
      Please, fix the API documentation.

            lancea Lance Andersen
            ndcosta Nelson Dcosta (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: