Jakarta Commons DBCP Version 1.2.2 
                                   RELEASE NOTES

      
This is a maintenance release containing bug fixes and enhancements. All API 
changes are binary compatible with version 1.2.1. 

For more information on Jakarta Commons DBCP, see
http://jakarta.apache.org/commons/dbcp/
      
Changes in this version include:

  Additions:

* Add a JNDI How To to the User Guide. 
          

  Bug fixes:

* DBCP-108. DriverManagerConnectionFactory: blank username/password handling. 
  Thanks to Maxwell Grender-Jones. 
          
* DBCP-113. Broken behaviour for BasicDataSource.setMaxActive(0). Thanks to 
  Rohan Lenard. 
          
* DBCP-36. BasicDataSource does not work with getConnection(String, String). 
  Thanks to Jonathan Whitall. 
          
* DBCP-50. Error in JOCL snippet in org.apache.commons.dbcp package javadoc. 
  Thanks to Nicky Nicolson. 
          
* Changes to make DBCP compile on JDK 1.5 by adding source="1.4" to compiler 
  arguments (there are compiler errors in JDK 5.0 without this source switch 
  that cannot be fixed without JDK 5.0-specific syntax). 
          
* DBCP-20. Per-user pooling with Oracle driver and default isolation 
  settings. Thanks to Chris Nappin. 
          
* DBCP-9. Error in JOCL document in javadoc. Thanks to Adrian Baker. 
          
* DBCP-184. Improved Exception nesting in ConnectionPool. Thanks to Meikel 
  Bisping. 
          
* DBCP-144. Fix broken website links for examples. Thanks to Sebb. 
          
* DBCP-28. Modified PoolableConnection close method to invalidate instance 
  when invoked on an already closed connection. Thanks to Huw Lewis, James 
  Ring. 
          
* DBCP-81. Inserted null checks to avoid NPE in close operations. 
          
* DBCP-105. Changed getReference method in InstanceKeyDataSource to return a 
  concrete factory and added implementations of getReference in concrete 
  subclasses. Thanks to Sandy McArthur, Thomas Fischer. 
          
* DBCP-39. Inserted null check in close method of SharedPoolDataSource to 
  avoid NPE when invoked on non-initialized pool. Thanks to Jindrich Vimr. 
          
* DBCP-71. Document fact that true values for testOnBorrow, testOnReturn, 
  testWhileIdle only have effect when validationQuery is set to a non-null 
  string. Thanks to Douglas Squirrel. 
          
* DBCP-102. Modified activateObject in PoolableConnection to test connection 
  properties before resetting to defaults. 
          
* DBCP-188. Corrected maxActive documentation in configuration.html. 
          
* DBCP-41. Fixed errors in pool parameter documentation and made 0 value for 
  _maxPreparedStatements in DriverAdapterCPDS behave like a negative value, 
  to be consistent with documentation and pool behavior. Thanks to Anton 
  Tagunov. 
          
* DBCP-100. Made userKeys an instance variable (i.e., not static) in 
  SharedPoolDataSource. 
          
* DBCP-198. Changed implementation of equals in 
  PoolingDataSource.PoolGuardConnectionWrapper to ensure it is reflexive, 
  even when wrapped connections are not DelegatingConnections. 
          
* DBCP-65. Removed synchronization from prepareStatement methods in 
  PoolingConnection. Synchronization in these methods was causing deadlocks. 
  No resources other than the prepared statement pool are accessed by these 
  methods, and the pool methods are synchronized. Also fixes DBCP-202. 
          

  Enhancements:

* DBCP-164. Enhancements to prepared statement in DriverAdapterCPDS. Thanks 
  to Todd Carmichael. 
          
* DBCP-186. Better messages and docs for LoginTimeout 
  UnsupportedOperationException. Thanks to Ralf Hauser. 
          
* DBCP-165. Added toString() methods to DelegatingPreparedStatement and 
  DelegatingStatement Thanks to QM. 
          
* Added toString() method to DelegatingConnection. 
          
* DBCP-181. Add DriverManager.invalidateConnection(). Thanks to Meikel 
  Bisping. 
          
* Upgraded dependency to Pool 1.3. 
          
* DBCP-187. Added connection info to SQLException messages when closed 
  connections (resp stmts) are accessed in DelegatingConnection, 
  DelegatingStatement. Thanks to Ralf Hauser. 
          
* DBCP-116. Added rollbackAfterValidation property and code to issue a 
  rollback on a connection after validation when this property is set to true 
  to eliminate Oracle driver exceptions. Default property value is false. 
  Thanks to Thomas Fischer. 
          
* DBCP-68. Removed dependency on Commons Collections by adding collections 
  2.1 sources for LRUMap and SequencedHashMap with package scope to 
  datasources package. 
          
Known Issues (significant open issues at time of release):
  
* Multiple issues (DBCP-3, DBCP-5, DBCP-23, DBCP-34, DBCP-61, DBCP-134,
  DBCP-148, DBCP-180) related to DBCP connection closing semantics. Fixing
  these issues could break existing clients, so they have been deferred to
  a major release.

* DBCP-44. Evictor thread in GenericObjectPool has potential for deadlock. 
  The GenericObjectPool Evictor thread can potentially cause a deadlock between
  its connection factory and java.sql.DriverManager. The deadlock occurs when
  the Evictor thread is trying to make enough connections to bring the pool's
  idle connections up to what's specified in minIdle, at the same time a
  connection is being requested through DriverManager.getConnection(). The
  suggested workaround is to either set minIdle to 0 when using the
  PoolingDriver or access connections directly from the pool if minIdle is
  set to a positive number. See the bug report for details.
  
* DBCP-191. DBCP does not compile under JDK 1.6 / JDBC 4.0.  Fixing this would
  break backward compatibility.

For a full list of open DBCP issues see
http://jakarta.apache.org/commons/dbcp/issue-tracking.html