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

Confusing description for interface PooledConnection .getConnection

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Fixed
    • Icon: P3 P3
    • 6
    • 5.0
    • core-libs
    • b86
    • x86
    • windows_xp
    • Verified

      A DESCRIPTION OF THE PROBLEM :
      Interface description says:
      "If no PooledConnection object is available, the connection pool manager calls the PooledConnection method getConnection to create a new physical connection and returns a handle to it.
      "

      I understand that ConnectionPoolDataSource.getPooledConnection() is being called in this situation, not PooledConnection.getConnection(). Latter is just used to create a new Connection Handle. (in the interface description, it would mean that one physical pooled connection may have multiple Connection objects associated)



      regards,
      Kristof Decloedt

      EXPECTED VERSUS ACTUAL BEHAVIOR :
      EXPECTED -
      "If no PooledConnection object is available, the connection pool manager calls the ConnectionPoolDataSource method getPooledConnection() to create a new logical ConnectionPool object and returns a handle to it to the application by calling the getConnection() method on this new ConnectionPool object.
      "

      ACTUAL -
      "If no PooledConnection object is available, the connection pool manager calls the PooledConnection method getConnection to create a new physical connection and returns a handle to it.
      "


      URL OF FAULTY DOCUMENTATION :
      http://java.sun.com/j2se/1.5.0/docs/api/
      ###@###.### 2005-04-07 06:08:39 GMT

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

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: