Author: psteitz
Date: Sun Apr 25 21:21:43 2010
New Revision: 937879
URL: http://svn.apache.org/viewvc?rev=937879&view=rev
Log:
Updated javadoc. JIRA: POOL-165.
Modified:
commons/proper/pool/trunk/src/java/org/apache/commons/pool/impl/GenericKeyedObjectPool.java
commons/proper/pool/trunk/src/java/org/apache/commons/pool/impl/GenericObjectPool.java
Modified:
commons/proper/pool/trunk/src/java/org/apache/commons/pool/impl/GenericKeyedObjectPool.java
URL:
http://svn.apache.org/viewvc/commons/proper/pool/trunk/src/java/org/apache/commons/pool/impl/GenericKeyedObjectPool.java?rev=937879&r1=937878&r2=937879&view=diff
==============================================================================
---
commons/proper/pool/trunk/src/java/org/apache/commons/pool/impl/GenericKeyedObjectPool.java
(original)
+++
commons/proper/pool/trunk/src/java/org/apache/commons/pool/impl/GenericKeyedObjectPool.java
Sun Apr 25 21:21:43 2010
@@ -128,11 +128,10 @@ import org.apache.commons.pool.PoolUtils
* as they sit idle in the pool and to ensure that a minimum number of idle
* objects is maintained for each key. This is performed by an
* "idle object eviction" thread, which runs asynchronously. Caution should be
- * used when configuring this optional feature. Eviction runs require an
- * exclusive synchronization lock on the pool, so if they run too frequently
- * and / or incur excessive latency when creating, destroying or validating
- * object instances, performance issues may result. The idle object eviction
- * thread may be configured using the following attributes:
+ * used when configuring this optional feature. Eviction runs contend with
client
+ * threads for access to objects in the pool, so if they run too frequently
+ * performance issues may result. The idle object eviction thread may be
+ * configured using the following attributes:
* <ul>
* <li>
* {...@link #setTimeBetweenEvictionRunsMillis timeBetweenEvictionRunsMillis}
Modified:
commons/proper/pool/trunk/src/java/org/apache/commons/pool/impl/GenericObjectPool.java
URL:
http://svn.apache.org/viewvc/commons/proper/pool/trunk/src/java/org/apache/commons/pool/impl/GenericObjectPool.java?rev=937879&r1=937878&r2=937879&view=diff
==============================================================================
---
commons/proper/pool/trunk/src/java/org/apache/commons/pool/impl/GenericObjectPool.java
(original)
+++
commons/proper/pool/trunk/src/java/org/apache/commons/pool/impl/GenericObjectPool.java
Sun Apr 25 21:21:43 2010
@@ -108,11 +108,10 @@ import org.apache.commons.pool.impl.Gene
* as they sit idle in the pool and to ensure that a minimum number of idle
* objects are available. This is performed by an "idle object eviction"
* thread, which runs asynchronously. Caution should be used when configuring
- * this optional feature. Eviction runs require an exclusive synchronization
- * lock on the pool, so if they run too frequently and / or incur excessive
- * latency when creating, destroying or validating object instances,
- * performance issues may result. The idle object eviction thread may be
- * configured using the following attributes:
+ * this optional feature. Eviction runs contend with client threads for access
+ * to objects in the pool, so if they run too frequently performance issues may
+ * result. The idle object eviction thread may be configured using the
following
+ * attributes:
* <ul>
* <li>
* {...@link #setTimeBetweenEvictionRunsMillis
<i>timeBetweenEvictionRunsMillis</i>}