Commons DBCP example source code file (changes.xml)
The Commons DBCP changes.xml source code
<?xml version="1.0"?>
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<!--
This file is used by the maven-changes-plugin to generate the release notes.
Useful ways of finding items to add to this file are:
1. Add items when you fix a bug or add a feature (this makes the
release process easy :-).
2. Do a bugzilla search for tickets closed since the previous release.
3. Use the report generated by the maven-changelog-plugin to see all
CVS commits. Set the project.properties' maven.changelog.range
property to the number of days since the last release.
The <action> type attribute can be add,update,fix,remove.
-->
<document>
<properties>
<title>Commons DBCP Release Notes
</properties>
<body>
<release version="1.4" date="TBD" description="This release includes
new features as well as bug fixes and enhancements. Some bug fixes
change semantics (e.g. connection close is now idempotent). The 1.3
and 1.4 releases of DBCP are built from the same sources. Version 1.4
supports JDBC 4, so requires JDK 1.6. Applications running under
JDK 1.4-1.5 must use DBCP 1.3. Applications running under JDK 1.6
should use DBCP 1.4. Other than support for the added methods in JDBC 4,
there is nothing new or different in DBCP 1.4 vs. DBCP 1.3. The list of
changes below since 1.2.2 applies to both the 1.3 and 1.4 release. Other than
the one issue related to adding JDBC 4 support (DBCP-191), all bug fixes
or new features are included in both DBCP 1.3 and 1.4 ">
<action dev="psteitz" type="fix" issue="DBCP-320">
Eliminated poolKeys cache from PerUserPoolDataSource.
</action>
<action dev="sebb" type="fix" issue="DBCP-321">
Eliminated userKeys LRUMap cache from SharedPoolDataSource.
</action>
<action dev="psteitz" type="fix" issue="DBCP-319" due-to="Sebastian Bazley">
Made private fields final where possible.
</action>
<action dev="sebb" type="fix" issue="DBCP-318" due-to="Sebastian Bazley">
PerUserPoolDataSource.getPooledConnectionAndInfo multi-threading bug.
</action>
<action dev="sebb" type="fix" issue="DBCP-315" due-to="Sebastian Bazley">
Remove throws clause from method that does not throw an exception.
</action>
<action dev="sebb" type="fix" issue="DBCP-313" due-to="Sebastian Bazley">
Remove code that catches and ignores Exceptions when calling
PooledConnection.removeConnectionEventListener(ConnectionEventListener)
as the method does not throw any Exceptions.
</action>
<action dev="sebb" type="fix" issue="DBCP-316" due-to="Sebastian Bazley">
Remove impossible null check.
</action>
<action dev="sebb" type="update" issue="DBCP-314" due-to="Sebastian Bazley">
Renamed variables with duplicate names in different scopes.
</action>
<action dev="psteitz" type="update" issue="DBCP-312" due-to="Glen Mazza">
Clarified javadoc for BasicDataSource close() method.
</action>
<action dev="psteitz" type="add" issue="DBCP-204" due-to="Wei Chen">
Made PoolingConnection pool CallableStatements. When BasicDataSource's
poolPreparedStatements property is true, CallableStatements are now
pooled along with PreparedStatements. The maxOpenPreparedStatements
property limits the combined number of Callable and Prepared statements
that can be in use at a given time.
</action>
<action dev="markt" type="update" issue="DBCP-305" due-to="Christopher Schultz">
Use an API specific exception for logging abandoned objects to make
scanning the logs for these exceptions simpler and to provide a better
message that includes the creation time of the abandoned object.
</action>
<action dev="markt" type="fix" issue="DBCP-303" due-to="Dave Oxley">
Ensure Statement.getGeneratedKeys() works correctly with the CPDS
adapter.
</action>
<action dev="psteitz" type="fix" issue="DBCP-302" due-to="Sebastian Bazley">
Removed incorrectly advertised ClassNotFoundException from
JOCLContentHandler.ConstructorDetails.createObject().
</action>
<action dev="markt" type="update" issue="DBCP-203" due-to="Mark Grand">
Make the class loader used to load the JDBC driver configurable for the
BasicDatasource.
</action>
<action dev="markt" type="fix" issue="DBCP-8">
Handle user password changes for InstanceKeyDataSources.
</action>
<action dev="psteitz" type="update" issue="DBCP-289" due-to="Marc Kannegießer">
Made XADataSource configurable in BasicManagedDataSource.
</action>
<action dev="psteitz" type="fix" issue="DBCP-294" due-to="Philippe Mouawad">
Added PoolableManagedConnection and PoolableManagedConnectionFactory so that
pooled managed connections can unregister themselves from transaction registries,
avoiding resource leaks.
</action>
<action dev="psteitz" type="update" issue="DBCP-276">
Added connectionProperties property to DriverAdapterCPDS.
</action>
<action dev="psteitz" type="add" issue="DBCP-226">
Added a validationQueryTimeout configuration parameter to BasicDataSource
allowing the user to specify a timeout value (in seconds) for connection
validation queries.
</action>
<action dev="psteitz" type="add" issue="DBCP-175" due-to="Jiri Melichna and Jerome Lacoste">
Added a connectionInitSqls configuration parameter to BasicDataSource
allowing the user to specify a collection of SQL statements to execute
one time when a physical database connection is first opened.
</action>
<action dev="markt" type="fix" issue="DBCP-212">
PoolableConnectionFactory.makeObject() is no longer synchronized. This
provides improved response times when load spikes at the cost of a
faster rise in database server load. This change was made as a partial
fix for DBCP-212. The synchronization changes in Commons Pool 1.5 complete
the fix for this issue.
</action>
<action dev="psteitz" type="fix" issue="DBCP-242">
Reverted DelegatingConnection close to 1.2.2 version to ensure
open statements are closed before the underlying connection is closed.
</action>
<action dev="markt" type="fix" issue="DBCP-235">
Refactor DelegatingConnection and ManagedConnection enable overridden
equals() and hashcode() to work correctly.
</action>
<action dev="markt" type="update" issue="DBCP-265">
Add a DelegatingDatabaseMetaData to track ResultSets returned from
DatabaseMetaData objects.
</action>
<action dev="markt" type="fix" issue="DBCP-215">
Modified BasicDataSourceFactory to complete initialization of the pool
by creating initialSize connections rather than leaving this to lazy
initialization when the pool is used.
</action>
<action dev="markt" type="fix" issue="DBCP-253">
Eliminated masked _stmt field in descendents of DelegatingStatement.
</action>
<action dev="markt" type="fix" issue="DBCP-191" due-to="Michael Heuer and J. David Beutel" >
Modified DBCP sources to support compilation under JDK 1.4-1.6
using Ant flags to do conditional compilation.
</action>
<action dev="markt" type="fix" issue="DBCP-272">
Added a static initializer to BasicDatasource that calls
DriverManager.getDrivers() to force initialization before we ever do
anything that might use Class.forName() to load (and register) a JDBC
driver.
</action>
<action dev="markt" type="fix" issue="DBCP-4">
Eliminated direct System.out calls in AbandonedTrace.
</action>
<action dev="niallp" type="fix" issue="DBCP-264">
Modified DelegatingStatment close to clear open batches.
</action>
<action dev="psteitz" type="fix" issue="DBCP-255">
Eliminated unused private "parent" field in AbandonedTrace.
</action>
<action dev="psteitz" type="fix" issue="DBCP-273" due-to="Mark Lin">
Fixed errors handling boolean-valued Reference properties in
InstanceKeyObjectFactory, DriverAdapterCPDS that were causing
testOnBorrow and poolPreparedStatements properties to be incorrectly
set when creating objects from javax.naming.Reference instances.
</action>
<action dev="psteitz" type="fix" issue="DBCP-271" due-to="Sebastian Bazley">
Made private instance fields of AbandonedTrace volatile (parent,
createdBy, lastUsed, createdTime) or final (trace).
</action>
<action dev="psteitz" type="fix" issue="DBCP-270" due-to="Filip Hanik">
Narrowed synchronization in AbandonedTrace to resolve an Evictor deadlock.
</action>
<action dev="bayard" type="fix" issue="DBCP-218">
Corrected Javadoc to state that getLoginTimeout and setLoginTimeout are
NOT supported by BasicDataSource.
</action>
<action dev="bayard" type="update" issue="DBCP-211">
Added Maven 2 pom.xml. Removed a block of code from TestJOCLed that set
the Xerces parser manually. This was to support early JDKs. The 1.3
version of DBCP requires JDK 1.4+.
</action>
<action dev="psteitz" type="add" issue="DBCP-228" due-to="Dain Sundstrom">
Added support for pooling managed connections.
</action>
<action dev="psteitz" type="add" issue="DBCP-230" due-to="Dain Sundstrom">
Added BasicManagedDataSource, extending BasicDataSource.
Also improved extensibility of BasicDataSource by encapsulating
methods to create object pool, connection factory and datasource
instance previously embedded in createDataSource.
</action>
<action dev="psteitz" type="update" issue="DBCP-233" due-to="Dain Sundstrom">
Changed behavior to allow Connection, Statement, PreparedStatement,
CallableStatement and ResultSet to be closed multiple times. The first
time close is called the resource is closed and any subsequent calls
have no effect. This behavior is required as per the JavaDocs for these
classes. Also added tests for closing all types multiple times and
updated any tests that incorrectly assert that a resource can not be
closed more then once. Fixes DBCP-3, DBCP-5, DBCP-23 and DBCP-134.
</action>
<action dev="psteitz" type="update" issue="DBCP-11" due-to="Dain Sundstrom">
Modified PoolingDataSource, PoolingDriver and DelegatingStatement to
assure that all returned Statements, PreparedStatements,
CallableStatements and ResultSets are wrapped with a delegating object,
which already properly handle the back pointers for Connection and
Statement. Also added tests to to assure that the *same* object used
to create the statement or result set is returned from either
getConnection() or getStatement().
</action>
<action dev="dain" type="update" issue="DBCP-143">
SQLNestedException has been deprecated and will be replaced in DBCP 2.0 with
SQLException and standard Java exception chaining.
</action>
<action dev="dain" type="fix" issue="DBCP-221">
BasicDataSource.close() now permanently marks the data source as closed,
and no new connections can be obtained from the data source. At close all
idle connections are destroyed and the method returns. As the remaining
active connections are closed, they are destroyed.
</action>
<action dev="psteitz" type="fix" issue="DBCP-241">
Eliminated potential sources of NullPointerExceptions in
PoolingConnection.
</action>
<action dev="psteitz" type="fix" issue="DBCP-216" due-to="Marcos Sanz">
Improved error recovery and listener cleanup in
KeyedCPDSConnectionFactory. Substituted calls to destroyObject with
_pool.invalidateObject on error to ensure pool active count is
decremented on error events. Ensured that events from closed or invalid
connections are ignored and listeners are cleaned up.
</action>
<action dev="psteitz" type="fix" issue="DBCP-245" due-to="Michael Drechsel">
Fixed error in SharedPoolDataSource causing incorrect passwords to be
stored under certain conditions.
</action>
<action dev="psteitz" type="fix" issue="DBCP-237" due-to="Oliver Matz">
Added exception handler to ensure that PooledConnections are not
orphaned when an exception occurs in setUpDefaults or clearWarnings in
IntanceKeyDataSource.getConnection.
</action>
<action dev="psteitz" type="fix" issue="DBCP-252" due-to="FindBugs">
Made getPool synchronized in PoolableConnectionFactory.
Fixes inconsistent synchronization accessing _pool.
</action>
<action dev="psteitz" type="fix" issue="DBCP-252" due-to="FindBugs">
Fixed inconsistent synchronization on _rollbackAfterValidation,
_validationQuery and _pool in CPDSConnectionFactory and
KeyedCPDSConnectionFactory by making the first two volatile and making
both getter and setter for _pool synchronized.
</action>
</release>
<release version="1.3" date="TBD" description="Compatability release for JDBC 3.
See version 1.4 description and change log.">
<action type="update">
See <a href="changes-report.html#a1.4">DBCP 1.4 Changes </a> for details. Version
1.3 is identical to 1.4, other than JDBC 4 methods being filtered out of the DBCP 1.3 sources. Changes
Since 1.2.2 are the same for 1.3 and 1.4.
</action>
</release>
<release version="1.2.2" date="2007-04-04"
description="This is a maintenance release containing bug fixes
and enhancements. All API changes are binary compatible with version 1.2.1.">
<action dev="dirkv " type="add">
Add a <i>JNDI How To</i> to the User Guide.
</action>
<action dev="dirkv " type="fix" issue="DBCP-108" due-to="Maxwell Grender-Jones">
DriverManagerConnectionFactory: blank username/password handling.
</action>
<action dev="dirkv " type="fix" issue="DBCP-113" due-to="Rohan Lenard">
Broken behaviour for BasicDataSource.setMaxActive(0).
</action>
<action dev="dirkv " type="fix" issue="DBCP-36" due-to="Jonathan Whitall">
BasicDataSource does not work with getConnection(String, String).
</action>
<action dev="dirkv " type="update" issue="DBCP-164" due-to="Todd Carmichael">
Enhancements to prepared statement in DriverAdapterCPDS.
</action>
<action dev="yoavs" type="update" issue="DBCP-186" due-to="Ralf Hauser">
Better messages and docs for LoginTimeout UnsupportedOperationException.
</action>
<action dev="yoavs" type="fix" issue="DBCP-50" due-to="Nicky Nicolson">
Error in JOCL snippet in org.apache.commons.dbcp package javadoc.
</action>
<action dev="yoavs" type="update" issue="DBCP-165" due-to="QM">
Added toString() methods to DelegatingPreparedStatement and DelegatingStatement
</action>
<action dev="yoavs" type="fix">
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).
</action>
<action dev="dirkv " type="fix" issue="DBCP-20" due-to="Chris Nappin">
Per-user pooling with Oracle driver and default isolation settings.
</action>
<action dev="dirkv " type="fix" issue="DBCP-9" due-to="Adrian Baker">
Error in JOCL document in javadoc.
</action>
<action dev="sullis" type="update">
Added toString() method to DelegatingConnection.
</action>
<action dev="dirkv " type="update" issue="DBCP-181" due-to="Meikel Bisping">
Add DriverManager.invalidateConnection().
</action>
<action dev="dirkv " type="fix" issue="DBCP-184" due-to="Meikel Bisping">
Improved Exception nesting in ConnectionPool.
</action>
<action dev="dennisl" type="fix" issue="DBCP-144" due-to="Sebb">
Fix broken website links for examples.
</action>
<action dev="psteitz" type="fix" issue="DBCP-28"
due-to="Huw Lewis, James Ring">
Modified PoolableConnection close method to invalidate instance
when invoked on an already closed connection.
</action>
<action dev="joehni" type="fix" issue="DBCP-81">
Inserted null checks to avoid NPE in close operations.
</action>
<action dev="psteitz" type="fix" issue="DBCP-105"
due-to="Sandy McArthur, Thomas Fischer">
Changed getReference method in InstanceKeyDataSource to return a
concrete factory and added implementations of getReference in concrete
subclasses.
</action>
<action dev="psteitz" type="fix" issue="DBCP-39" due-to="Jindrich Vimr">
Inserted null check in close method of SharedPoolDataSource to avoid
NPE when invoked on non-initialized pool.
</action>
<action dev="psteitz" type="fix" issue="DBCP-71" due-to="Douglas Squirrel">
Document fact that true values for testOnBorrow, testOnReturn, testWhileIdle
only have effect when validationQuery is set to a non-null string.
</action>
<action dev="psteitz" type="fix" issue="DBCP-102">
Modified activateObject in PoolableConnection to test connection
properties before resetting to defaults.
</action>
<action dev="sandymac" type="fix" issue="DBCP-188">
Corrected maxActive documentation in configuration.html.
</action>
<action dev="psteitz" type="update">
Upgraded dependency to Pool 1.3.
</action>
<action dev="psteitz" type="update" issue="DBCP-187" due-to="Ralf Hauser">
Added connection info to SQLException messages when closed connections
(resp stmts) are accessed in DelegatingConnection, DelegatingStatement.
</action>
<action dev="psteitz" type="fix" issue="DBCP-41" due-to="Anton Tagunov">
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.
</action>
<action dev="psteitz" type="fix" issue="DBCP-100">
Made userKeys an instance variable (i.e., not static)
in SharedPoolDataSource.
</action>
<action dev="psteitz" type="fix" issue="DBCP-198">
Changed implementation of equals in
PoolingDataSource.PoolGuardConnectionWrapper
to ensure it is reflexive, even when wrapped connections are not
DelegatingConnections.
</action>
<action dev="psteitz" type="update" issue="DBCP-116" due-to="Thomas Fischer">
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.
</action>
<action dev="psteitz" type="update" issue="DBCP-68">
Removed dependency on Commons Collections by adding collections
2.1 sources for LRUMap and SequencedHashMap with package scope to
datasources package.
</action>
<action dev="psteitz" type="fix" issue="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.
</action>
</release>
<release version="1.2.1" date="2004-06-12" description="Maintenance Release to restore JDK 1.3 compatibility">
<action type="fix">
See <a href="release-notes-1.2.1.html">DBCP 1.2.1 Release Notes</a> for details.
</action>
</release>
<release version="1.2" date="2004-06-07">
<action type="update">
See <a href="release-notes-1.2.html">DBCP 1.2 Release Notes</a> for details.
</action>
</release>
<release version="1.1" date="2003-10-20">
<action type="update">
See <a href="release-notes-1.1.html">DBCP 1.1 Release Notes</a> for details.
</action>
</release>
<release version="1.0" date="2002-08-12" description="Initial Release">
<action type="add">
Initial Release
</action>
</release>
</body>
</document>
Other Commons DBCP examples (source code examples)Here is a short list of links related to this Commons DBCP changes.xml source code file: |
The search page
Other Commons DBCP source code examples at this package level
Click here to learn more about this project
