Author: sebb
Date: Fri Apr 13 18:00:42 2012
New Revision: 1325883
URL: http://svn.apache.org/viewvc?rev=1325883&view=rev
Log:
Commit current release notes, generated using:
mvn changes:announcement-generate -Prelease-notes -Dchanges.version=2.0
Modified:
commons/proper/pool/trunk/RELEASE-NOTES.txt
commons/proper/pool/trunk/pom.xml
commons/proper/pool/trunk/src/changes/changes.xml
Modified: commons/proper/pool/trunk/RELEASE-NOTES.txt
URL:
http://svn.apache.org/viewvc/commons/proper/pool/trunk/RELEASE-NOTES.txt?rev=1325883&r1=1325882&r2=1325883&view=diff
==============================================================================
--- commons/proper/pool/trunk/RELEASE-NOTES.txt (original)
+++ commons/proper/pool/trunk/RELEASE-NOTES.txt Fri Apr 13 18:00:42 2012
@@ -1,27 +1,51 @@
-
- commons-pool-1.5.6 RELEASE NOTES
+ Apache Commons Pool 2.0 RELEASE NOTES
-This is a patch release, including bugfixes only.
+The Commons Pool team is pleased to announce the release of
commons-pool2-2.0-SNAPSHOT
+
+Commons Object Pooling Library
+
+This is a major new release that provides significant performance improvements
in high concurrency environments. Pools now provide a mechanism for tracking
objects that have been borrowed from the pool but not returned. There have been
numerous API changes to support these and other new features as well as to
clarify behaviour and improve consistency across the API.
Changes in this version include:
Fixed Bugs:
-o POOL-179: Correctly handle an InterruptedException when waiting for an
object from
- the pool. Thanks to Axel Grossmann.
-o POOL-180: Only stop tracking objects for a key when there are no idle
objects, no
- active objects and no objects being processed.
-o POOL-184: Correct bug that could lead to inappropriate pool starvation
when evict()
- and borrowObject() are called concurrently.
-o Fix performance issues when object destruction has latency. Thanks to
psteitz.
+o POOL-188: Remove confusing method
PoolUtils.ErodingKeyedObjectPool.numIdle(K key). Thanks to sebb.
+o POOL-150: Ensure GKOP.preparePool() throws an exception if no factory has
been
+ defined.
+o POOL-134: Add the ability to specify a per call wait time when borrowing an
object.
+o POOL-121: Provide a name for the eviction timer thread.
+o POOL-173: Reduce duplication in configuration code.
+o POOL-178: Re-factor common code into common base classes.
+o POOL-100: Allow custom eviction policies to be defined.
Changes:
-o POOL-181: Make BaseObjectPool.isClosed() public.
+o POOL-194: Replace synchronized blocks in PoolUtils with Read/Write locks.
+o POOL-83: Support Java 1.5 Generics.
+o POOL-186: Developer documentation and examples have to be updated once the
2.0 repackaging has been done
+o Switch GOP to use a pooling mechanism based on
java.util.concurrent and a
+ LinkedBlockingQueue implementation from Apache Harmony (originally by
Doug
+ Lea and the JSR-166 expert group).
+o Make deprecated protected attributes private, requiring that
access is via
+ the appropriate getters.
+o Code clean-up. Add missing @Override annotations, remove unused
code,
+ remove deprecated code and unnecessary code.
+o Introduce an Enum (WhenExhaustedAction) to control pool behaviour
when no
+ more objects are available to allocate.
+o Remove WhenExhuastedAction.GROW since it is equivalent to
+ WhenExhuastedAction.FAIL with a maxActive value of Integer.MAX_VALUE.
+o POOL-155: Guard against multiple returns of the same object to the pool and
ensure
+ that only objects borrowed from the pool are returned to it.
+o Remove setFactory() method from GOP.
+o POOL-172: Expose GOP and GKOP attributes via JMX.
+o POOL-98: Add additional attributes (also accessible via JMX) for
monitoring.
+o Change meaning of zero for maxWait to a maximum wait of zero
milliseconds
+ rather than the unexpected infinite wait.
+
-
-For complete information on commons-pool, including instructions on how to
submit bug reports,
-patches, or suggestions for improvement, see the commons-pool website:
+For complete information on Commons Pool, including instructions on how to
submit bug reports,
+patches, or suggestions for improvement, see the Apache Commons Pool website:
http://commons.apache.org/pool/
Modified: commons/proper/pool/trunk/pom.xml
URL:
http://svn.apache.org/viewvc/commons/proper/pool/trunk/pom.xml?rev=1325883&r1=1325882&r2=1325883&view=diff
==============================================================================
--- commons/proper/pool/trunk/pom.xml (original)
+++ commons/proper/pool/trunk/pom.xml Fri Apr 13 18:00:42 2012
@@ -225,12 +225,12 @@
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-changes-plugin</artifactId>
- <version>2.0</version>
+ <version>${commons.changes.version}</version>
<configuration>
<xmlPath>${basedir}/src/changes/changes.xml</xmlPath>
<issueLinkTemplate>%URL%/%ISSUE%</issueLinkTemplate>
- <template>pool-release-notes.vm</template>
- <templateDirectory>src/template</templateDirectory>
+ <template>release-notes.vm</template>
+ <templateDirectory>src/changes</templateDirectory>
</configuration>
<reportSets>
<reportSet>
Modified: commons/proper/pool/trunk/src/changes/changes.xml
URL:
http://svn.apache.org/viewvc/commons/proper/pool/trunk/src/changes/changes.xml?rev=1325883&r1=1325882&r2=1325883&view=diff
==============================================================================
--- commons/proper/pool/trunk/src/changes/changes.xml (original)
+++ commons/proper/pool/trunk/src/changes/changes.xml Fri Apr 13 18:00:42 2012
@@ -15,6 +15,29 @@
See the License for the specific language governing permissions and
limitations under the License.
-->
+
+<!--
+This file is also 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 JIRA search for tickets closed since the previous release.
+
+3. Use the report generated by the maven-changelog-plugin to see all
+SVN commits. TBA how to use this with SVN.
+
+To generate the release notes from this file:
+
+mvn changes:announcement-generate -Prelease-notes [-Dchanges.version=nnn]
+
+then tweak the formatting if necessary
+and commit
+
+The <action> type attribute can be add,update,fix,remove.
+-->
+
<document>
<properties>
<title>Commons Pool Changes</title>
