This is an automated email from the ASF dual-hosted git repository.
garydgregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-pool.git
The following commit(s) were added to refs/heads/master by this push:
new a6f3c4f8 Javadoc
a6f3c4f8 is described below
commit a6f3c4f886dfcf7fd877152978cc6a991d96eb29
Author: Gary Gregory <[email protected]>
AuthorDate: Sat Jul 11 11:22:42 2026 -0400
Javadoc
---
.../pool3/BaseKeyedPooledObjectFactory.java | 20 ++++++++++----------
.../commons/pool3/BasePooledObjectFactory.java | 2 +-
.../org/apache/commons/pool3/KeyedObjectPool.java | 22 +++++++++++-----------
.../commons/pool3/KeyedPooledObjectFactory.java | 22 +++++++++++-----------
.../java/org/apache/commons/pool3/ObjectPool.java | 6 +++---
.../org/apache/commons/pool3/PooledObject.java | 8 ++++----
.../apache/commons/pool3/PooledObjectFactory.java | 10 +++++-----
.../apache/commons/pool3/impl/AbandonedConfig.java | 4 ++--
.../commons/pool3/impl/BaseGenericObjectPool.java | 12 ++++++------
.../org/apache/commons/pool3/impl/CallStack.java | 2 +-
.../commons/pool3/impl/DefaultPooledObject.java | 2 +-
.../apache/commons/pool3/impl/EvictionTimer.java | 2 +-
.../commons/pool3/impl/GenericKeyedObjectPool.java | 16 ++++++++--------
.../commons/pool3/impl/GenericObjectPool.java | 4 ++--
.../pool3/impl/InterruptibleReentrantLock.java | 2 +-
.../commons/pool3/impl/LinkedBlockingDeque.java | 10 +++++-----
.../apache/commons/pool3/impl/PoolImplUtils.java | 10 +++++-----
.../pool3/impl/ResilientPooledObjectFactory.java | 4 ++--
.../commons/pool3/proxy/CglibProxySource.java | 2 +-
.../apache/commons/pool3/proxy/JdkProxySource.java | 4 ++--
.../commons/pool3/impl/AtomicIntegerFactory.java | 10 +++++-----
21 files changed, 87 insertions(+), 87 deletions(-)
diff --git
a/src/main/java/org/apache/commons/pool3/BaseKeyedPooledObjectFactory.java
b/src/main/java/org/apache/commons/pool3/BaseKeyedPooledObjectFactory.java
index 50c257b0..eab1474e 100644
--- a/src/main/java/org/apache/commons/pool3/BaseKeyedPooledObjectFactory.java
+++ b/src/main/java/org/apache/commons/pool3/BaseKeyedPooledObjectFactory.java
@@ -48,8 +48,8 @@ public abstract class BaseKeyedPooledObjectFactory<K, V, E
extends Exception> ex
* The default implementation is a no-op.
* </p>
*
- * @param key the key used when selecting the object
- * @param p a {@code PooledObject} wrapping the instance to be activated
+ * @param key The key used when selecting the object
+ * @param p A {@code PooledObject} wrapping the instance to be activated
*/
@Override
public void activateObject(final K key, final PooledObject<V> p) throws E {
@@ -59,7 +59,7 @@ public abstract class BaseKeyedPooledObjectFactory<K, V, E
extends Exception> ex
/**
* Creates an instance that can be served by the pool.
*
- * @param key the key used when constructing the object
+ * @param key The key used when constructing the object
* @return An instance that can be served by the pool
* @throws E if there is a problem creating a new instance,
* this will be propagated to the code requesting an object.
@@ -72,8 +72,8 @@ public abstract class BaseKeyedPooledObjectFactory<K, V, E
extends Exception> ex
* The default implementation is a no-op.
* </p>
*
- * @param key the key used when selecting the instance
- * @param p a {@code PooledObject} wrapping the instance to be destroyed
+ * @param key The key used when selecting the instance
+ * @param p A {@code PooledObject} wrapping the instance to be destroyed
*/
@Override
public void destroyObject(final K key, final PooledObject<V> p) throws E {
@@ -92,8 +92,8 @@ public abstract class BaseKeyedPooledObjectFactory<K, V, E
extends Exception> ex
* The default implementation is a no-op.
* </p>
*
- * @param key the key used when selecting the object
- * @param p a {@code PooledObject} wrapping the instance to be passivated
+ * @param key The key used when selecting the object
+ * @param p A {@code PooledObject} wrapping the instance to be passivated
*/
@Override
public void passivateObject(final K key, final PooledObject<V> p) throws E
{
@@ -106,8 +106,8 @@ public abstract class BaseKeyedPooledObjectFactory<K, V, E
extends Exception> ex
* The default implementation always returns {@code true}.
* </p>
*
- * @param key the key used when selecting the object
- * @param p a {@code PooledObject} wrapping the instance to be validated
+ * @param key The key used when selecting the object
+ * @param p A {@code PooledObject} wrapping the instance to be validated
* @return always {@code true} in this default implementation
*/
@Override
@@ -119,7 +119,7 @@ public abstract class BaseKeyedPooledObjectFactory<K, V, E
extends Exception> ex
* Wraps the provided instance with an implementation of
* {@link PooledObject}.
*
- * @param value the instance to wrap, should not be null.
+ * @param value The instance to wrap, should not be null.
* @return The provided instance, wrapped by a {@link PooledObject}
* @throws E if there is a problem wrapping an instance,
* this will be propagated to the code requesting an object.
diff --git
a/src/main/java/org/apache/commons/pool3/BasePooledObjectFactory.java
b/src/main/java/org/apache/commons/pool3/BasePooledObjectFactory.java
index 9ef69930..4f4ecb5b 100644
--- a/src/main/java/org/apache/commons/pool3/BasePooledObjectFactory.java
+++ b/src/main/java/org/apache/commons/pool3/BasePooledObjectFactory.java
@@ -101,7 +101,7 @@ public abstract class BasePooledObjectFactory<T, E extends
Exception> extends Ba
* Wraps the provided instance with an implementation of
* {@link PooledObject}.
*
- * @param obj the instance to wrap, should not be null.
+ * @param obj The instance to wrap, should not be null.
* @return The provided instance, wrapped by a {@link PooledObject}
*/
public abstract PooledObject<T> wrap(T obj);
diff --git a/src/main/java/org/apache/commons/pool3/KeyedObjectPool.java
b/src/main/java/org/apache/commons/pool3/KeyedObjectPool.java
index b7480dab..d589655f 100644
--- a/src/main/java/org/apache/commons/pool3/KeyedObjectPool.java
+++ b/src/main/java/org/apache/commons/pool3/KeyedObjectPool.java
@@ -75,7 +75,7 @@ public interface KeyedObjectPool<K, V, E extends Exception>
extends Closeable {
* in the idle object pool. {@code addObject} is useful for
* "pre-loading" a pool with idle objects (Optional operation).
*
- * @param key the key a new instance should be added to
+ * @param key The key a new instance should be added to
* @throws E
* when {@link KeyedPooledObjectFactory#makeObject} fails.
* @throws IllegalStateException
@@ -157,7 +157,7 @@ public interface KeyedObjectPool<K, V, E extends Exception>
extends Closeable {
* strictly specified (although it may be specified by implementations).
* </p>
*
- * @param key the key used to obtain the object
+ * @param key The key used to obtain the object
* @return An instance from this pool.
* @throws IllegalStateException
* after {@link #close close} has been called on this pool
@@ -184,7 +184,7 @@ public interface KeyedObjectPool<K, V, E extends Exception>
extends Closeable {
* Clears the specified pool, removing all pooled instances corresponding
to
* the given {@code key} (optional operation).
*
- * @param key the key to clear
+ * @param key The key to clear
* @throws UnsupportedOperationException when this implementation doesn't
* support the operation
*
@@ -231,7 +231,7 @@ public interface KeyedObjectPool<K, V, E extends Exception>
extends Closeable {
* returned to the pool corresponding to the given {@code key}.
* Returns a negative value if this information is not available.
*
- * @param key the key to query
+ * @param key The key to query
* @return The number of instances currently borrowed from but not yet
* returned to the pool corresponding to the given {@code key}.
*/
@@ -250,7 +250,7 @@ public interface KeyedObjectPool<K, V, E extends Exception>
extends Closeable {
* {@code key} currently idle in this pool. Returns a negative value if
* this information is not available.
*
- * @param key the key to query
+ * @param key The key to query
* @return The number of instances corresponding to the given
* {@code key} currently idle in this pool.
*/
@@ -270,8 +270,8 @@ public interface KeyedObjectPool<K, V, E extends Exception>
extends Closeable {
* determined (due to an exception or other problem) to be invalid.
* </p>
*
- * @param key the key used to obtain the object
- * @param obj a {@link #borrowObject borrowed} instance to be returned.
+ * @param key The key used to obtain the object
+ * @param obj A {@link #borrowObject borrowed} instance to be returned.
* @throws E if the instance cannot be invalidated
*/
void invalidateObject(K key, V obj) throws E;
@@ -291,8 +291,8 @@ public interface KeyedObjectPool<K, V, E extends Exception>
extends Closeable {
* determined (due to an exception or other problem) to be invalid.
* </p>
*
- * @param key the key used to obtain the object
- * @param obj a {@link #borrowObject borrowed} instance to be returned.
+ * @param key The key used to obtain the object
+ * @param obj A {@link #borrowObject borrowed} instance to be returned.
* @param destroyMode destroy activation context provided to the factory
* @throws E if the instance cannot be invalidated
* @since 2.9.0
@@ -308,8 +308,8 @@ public interface KeyedObjectPool<K, V, E extends Exception>
extends Closeable {
* implementation or sub-interface using a {@code key} that is
* equivalent to the one used to borrow the instance in the first place.
*
- * @param key the key used to obtain the object
- * @param obj a {@link #borrowObject borrowed} instance to be returned.
+ * @param key The key used to obtain the object
+ * @param obj A {@link #borrowObject borrowed} instance to be returned.
* @throws IllegalStateException
* if an attempt is made to return an object to the pool that
* is in any state other than allocated (i.e. borrowed).
diff --git
a/src/main/java/org/apache/commons/pool3/KeyedPooledObjectFactory.java
b/src/main/java/org/apache/commons/pool3/KeyedPooledObjectFactory.java
index dfbcbfda..242acf82 100644
--- a/src/main/java/org/apache/commons/pool3/KeyedPooledObjectFactory.java
+++ b/src/main/java/org/apache/commons/pool3/KeyedPooledObjectFactory.java
@@ -78,8 +78,8 @@ public interface KeyedPooledObjectFactory<K, V, E extends
Exception> {
/**
* Reinitializes an instance to be returned by the pool.
*
- * @param key the key used when selecting the object
- * @param p a {@code PooledObject} wrapping the instance to be activated
+ * @param key The key used when selecting the object
+ * @param p A {@code PooledObject} wrapping the instance to be activated
* @throws E if there is a problem activating {@code obj},
* this exception may be swallowed by the pool.
*
@@ -99,8 +99,8 @@ public interface KeyedPooledObjectFactory<K, V, E extends
Exception> {
* to the garbage collector may never be destroyed.
* </p>
*
- * @param key the key used when selecting the instance
- * @param p a {@code PooledObject} wrapping the instance to be destroyed
+ * @param key The key used when selecting the instance
+ * @param p A {@code PooledObject} wrapping the instance to be destroyed
* @throws E should be avoided as it may be swallowed by
* the pool implementation.
*
@@ -112,8 +112,8 @@ public interface KeyedPooledObjectFactory<K, V, E extends
Exception> {
/**
* Destroys an instance no longer needed by the pool, using the provided
{@link DestroyMode}.
*
- * @param key the key used when selecting the instance
- * @param p a {@code PooledObject} wrapping the instance to be destroyed
+ * @param key The key used when selecting the instance
+ * @param p A {@code PooledObject} wrapping the instance to be destroyed
* @param destroyMode DestroyMode providing context to the factory
* @throws E should be avoided as it may be swallowed by
* the pool implementation.
@@ -132,7 +132,7 @@ public interface KeyedPooledObjectFactory<K, V, E extends
Exception> {
* Creates an instance that can be served by the pool and
* wrap it in a {@link PooledObject} to be managed by the pool.
*
- * @param key the key used when constructing the object
+ * @param key The key used when constructing the object
* @return A {@code PooledObject} wrapping an instance that can
* be served by the pool.
*
@@ -144,8 +144,8 @@ public interface KeyedPooledObjectFactory<K, V, E extends
Exception> {
/**
* Uninitializes an instance to be returned to the idle object pool.
*
- * @param key the key used when selecting the object
- * @param p a {@code PooledObject} wrapping the instance to be passivated
+ * @param key The key used when selecting the object
+ * @param p A {@code PooledObject} wrapping the instance to be passivated
* @throws E if there is a problem passivating {@code obj},
* this exception may be swallowed by the pool.
*
@@ -156,8 +156,8 @@ public interface KeyedPooledObjectFactory<K, V, E extends
Exception> {
/**
* Ensures that the instance is safe to be returned by the pool.
*
- * @param key the key used when selecting the object
- * @param p a {@code PooledObject} wrapping the instance to be validated
+ * @param key The key used when selecting the object
+ * @param p A {@code PooledObject} wrapping the instance to be validated
* @return {@code false} if {@code obj} is not valid and should
* be dropped from the pool, {@code true} otherwise.
*/
diff --git a/src/main/java/org/apache/commons/pool3/ObjectPool.java
b/src/main/java/org/apache/commons/pool3/ObjectPool.java
index be01a134..da7d5e78 100644
--- a/src/main/java/org/apache/commons/pool3/ObjectPool.java
+++ b/src/main/java/org/apache/commons/pool3/ObjectPool.java
@@ -175,7 +175,7 @@ public interface ObjectPool<T, E extends Exception> extends
Closeable {
* determined (due to an exception or other problem) to be invalid.
* </p>
*
- * @param obj a {@link #borrowObject borrowed} instance to be disposed.
+ * @param obj A {@link #borrowObject borrowed} instance to be disposed.
* @throws E if the instance cannot be invalidated
*/
void invalidateObject(T obj) throws E;
@@ -193,7 +193,7 @@ public interface ObjectPool<T, E extends Exception> extends
Closeable {
* determined (due to an exception or other problem) to be invalid.
* </p>
*
- * @param obj a {@link #borrowObject borrowed} instance to be disposed.
+ * @param obj A {@link #borrowObject borrowed} instance to be disposed.
* @param destroyMode destroy activation context provided to the factory
* @throws E if the instance cannot be invalidated
* @since 2.9.0
@@ -207,7 +207,7 @@ public interface ObjectPool<T, E extends Exception> extends
Closeable {
* <strong>must</strong> have been obtained using {@link #borrowObject()}
or
* a related method as defined in an implementation or sub-interface.
*
- * @param obj a {@link #borrowObject borrowed} instance to be returned.
+ * @param obj A {@link #borrowObject borrowed} instance to be returned.
* @throws IllegalStateException
* if an attempt is made to return an object to the pool that
* is in any state other than allocated (i.e. borrowed).
diff --git a/src/main/java/org/apache/commons/pool3/PooledObject.java
b/src/main/java/org/apache/commons/pool3/PooledObject.java
index 762f27cd..a109032a 100644
--- a/src/main/java/org/apache/commons/pool3/PooledObject.java
+++ b/src/main/java/org/apache/commons/pool3/PooledObject.java
@@ -37,7 +37,7 @@ public interface PooledObject<T> extends
Comparable<PooledObject<T>> {
* Gets the wrapped object or null.
*
* @param <T> The type of object in the pool.
- * @param pooledObject the PooledObject to unwrap, may be null.
+ * @param pooledObject The PooledObject to unwrap, may be null.
* @return The wrapped object or null.
* @since 2.13.0
*/
@@ -48,7 +48,7 @@ public interface PooledObject<T> extends
Comparable<PooledObject<T>> {
/**
* Tests whether the given PooledObject is null <em>or</em> wraps a null.
*
- * @param pooledObject the PooledObject to test, may be null.
+ * @param pooledObject The PooledObject to test, may be null.
* @return whether the given PooledObject is null <em>or</em> wraps a null.
* @since 2.12.0
*/
@@ -59,7 +59,7 @@ public interface PooledObject<T> extends
Comparable<PooledObject<T>> {
/**
* Tests whether the given PooledObject isn't null <em>and</em> doesn't
wraps a null.
*
- * @param pooledObject the PooledObject to test, may be null.
+ * @param pooledObject The PooledObject to test, may be null.
* @return whether the given PooledObject isn't null <em>and</em> doesn't
wraps a null.
* @since 2.13.0
*/
@@ -247,7 +247,7 @@ public interface PooledObject<T> extends
Comparable<PooledObject<T>> {
* When set to false, abandoned logs may only include caller class
information rather than method names, line
* numbers, and other normal metadata available in a full stack trace.
*
- * @param requireFullStackTrace the new configuration setting for
abandoned object logging.
+ * @param requireFullStackTrace The new configuration setting for
abandoned object logging.
* @since 2.7.0
*/
default void setRequireFullStackTrace(final boolean requireFullStackTrace)
{
diff --git a/src/main/java/org/apache/commons/pool3/PooledObjectFactory.java
b/src/main/java/org/apache/commons/pool3/PooledObjectFactory.java
index 45cb51d4..6001a413 100644
--- a/src/main/java/org/apache/commons/pool3/PooledObjectFactory.java
+++ b/src/main/java/org/apache/commons/pool3/PooledObjectFactory.java
@@ -74,7 +74,7 @@ public interface PooledObjectFactory<T, E extends Exception> {
/**
* Reinitializes an instance to be returned by the pool.
*
- * @param p a {@code PooledObject} wrapping the instance to be activated
+ * @param p A {@code PooledObject} wrapping the instance to be activated
* @throws E if there is a problem activating {@code obj},
* this exception may be swallowed by the pool.
*
@@ -95,7 +95,7 @@ public interface PooledObjectFactory<T, E extends Exception> {
* to the garbage collector may never be destroyed.
* </p>
*
- * @param p a {@code PooledObject} wrapping the instance to be destroyed
+ * @param p A {@code PooledObject} wrapping the instance to be destroyed
* @throws E should be avoided as it may be swallowed by
* the pool implementation.
*
@@ -108,7 +108,7 @@ public interface PooledObjectFactory<T, E extends
Exception> {
* Destroys an instance no longer needed by the pool, using the provided
* DestroyMode.
*
- * @param p a {@code PooledObject} wrapping the instance to be destroyed
+ * @param p A {@code PooledObject} wrapping the instance to be destroyed
* @param destroyMode DestroyMode providing context to the factory
* @throws E should be avoided as it may be swallowed by
* the pool implementation.
@@ -136,7 +136,7 @@ public interface PooledObjectFactory<T, E extends
Exception> {
/**
* Uninitializes an instance to be returned to the idle object pool.
*
- * @param p a {@code PooledObject} wrapping the instance to be passivated
+ * @param p A {@code PooledObject} wrapping the instance to be passivated
* @throws E if there is a problem passivating {@code obj},
* this exception may be swallowed by the pool.
*
@@ -147,7 +147,7 @@ public interface PooledObjectFactory<T, E extends
Exception> {
/**
* Ensures that the instance is safe to be returned by the pool.
*
- * @param p a {@code PooledObject} wrapping the instance to be validated
+ * @param p A {@code PooledObject} wrapping the instance to be validated
* @return {@code false} if {@code obj} is not valid and should
* be dropped from the pool, {@code true} otherwise.
*/
diff --git a/src/main/java/org/apache/commons/pool3/impl/AbandonedConfig.java
b/src/main/java/org/apache/commons/pool3/impl/AbandonedConfig.java
index e5e92fc2..65578cdb 100644
--- a/src/main/java/org/apache/commons/pool3/impl/AbandonedConfig.java
+++ b/src/main/java/org/apache/commons/pool3/impl/AbandonedConfig.java
@@ -41,7 +41,7 @@ public class AbandonedConfig {
/**
* Creates a new instance with values from the given instance.
*
- * @param abandonedConfig the source, may be null.
+ * @param abandonedConfig The source, may be null.
* @return A new instance or null if the input is null.
* @since 2.11.0
*/
@@ -103,7 +103,7 @@ public class AbandonedConfig {
/**
* Creates a new instance with values from the given instance.
*
- * @param abandonedConfig the source.
+ * @param abandonedConfig The source.
*/
@SuppressWarnings("resource")
private AbandonedConfig(final AbandonedConfig abandonedConfig) {
diff --git
a/src/main/java/org/apache/commons/pool3/impl/BaseGenericObjectPool.java
b/src/main/java/org/apache/commons/pool3/impl/BaseGenericObjectPool.java
index 082b6577..27c920ec 100644
--- a/src/main/java/org/apache/commons/pool3/impl/BaseGenericObjectPool.java
+++ b/src/main/java/org/apache/commons/pool3/impl/BaseGenericObjectPool.java
@@ -185,7 +185,7 @@ public abstract class BaseGenericObjectPool<T, E extends
Exception> extends Base
/**
* Sets the scheduled future.
*
- * @param scheduledFuture the scheduled future.
+ * @param scheduledFuture The scheduled future.
*/
void setScheduledFuture(final ScheduledFuture<?> scheduledFuture) {
this.scheduledFuture = scheduledFuture;
@@ -473,7 +473,7 @@ public abstract class BaseGenericObjectPool<T, E extends
Exception> extends Base
/**
* Casts the given throwable to {@code E}.
*
- * @param throwable the throwable.
+ * @param throwable The throwable.
* @return The input.
* @since 2.12.0
*/
@@ -1256,7 +1256,7 @@ public abstract class BaseGenericObjectPool<T, E extends
Exception> extends Base
/**
* Sets the abandoned object removal configuration.
*
- * @param abandonedConfig the new configuration to use. This is used by
value.
+ * @param abandonedConfig The new configuration to use. This is used by
value.
* @see AbandonedConfig
* @since 2.11.0
*/
@@ -1419,7 +1419,7 @@ public abstract class BaseGenericObjectPool<T, E extends
Exception> extends Base
* Sets the timeout that will be used when waiting for the Evictor to
shutdown if this pool is closed and it is the
* only pool still using the value for the Evictor.
*
- * @param evictorShutdownTimeout the timeout in milliseconds that will be
used while waiting for the Evictor
+ * @param evictorShutdownTimeout The timeout in milliseconds that will be
used while waiting for the Evictor
* to shut down.
* @since 2.10.0
*/
@@ -1465,7 +1465,7 @@ public abstract class BaseGenericObjectPool<T, E extends
Exception> extends Base
* {@link #getBlockWhenExhausted} is true. When less than 0, the
* {@code borrowObject()} method may block indefinitely.
*
- * @param maxWaitDuration the maximum duration
+ * @param maxWaitDuration The maximum duration
* {@code borrowObject()} will block or negative
* for indefinitely.
*
@@ -1807,7 +1807,7 @@ public abstract class BaseGenericObjectPool<T, E extends
Exception> extends Base
/**
* Updates statistics after an object is returned to the pool.
*
- * @param activeTime the amount of time (in milliseconds) that the
returning
+ * @param activeTime The amount of time (in milliseconds) that the
returning
* object was checked out
*/
final void updateStatsReturn(final Duration activeTime) {
diff --git a/src/main/java/org/apache/commons/pool3/impl/CallStack.java
b/src/main/java/org/apache/commons/pool3/impl/CallStack.java
index 7c63558c..518d80aa 100644
--- a/src/main/java/org/apache/commons/pool3/impl/CallStack.java
+++ b/src/main/java/org/apache/commons/pool3/impl/CallStack.java
@@ -47,7 +47,7 @@ public interface CallStack {
* Prints the current stack trace if available to a PrintWriter. The
format is undefined and is primarily useful
* for debugging issues with {@link PooledObject} usage in user code.
*
- * @param writer a PrintWriter to write the current stack trace to if
available
+ * @param writer A PrintWriter to write the current stack trace to if
available
* @return true if a stack trace was available to print or false if
nothing was printed
*/
boolean printStackTrace(PrintWriter writer);
diff --git
a/src/main/java/org/apache/commons/pool3/impl/DefaultPooledObject.java
b/src/main/java/org/apache/commons/pool3/impl/DefaultPooledObject.java
index 1b17abd1..bddbac25 100644
--- a/src/main/java/org/apache/commons/pool3/impl/DefaultPooledObject.java
+++ b/src/main/java/org/apache/commons/pool3/impl/DefaultPooledObject.java
@@ -256,7 +256,7 @@ public class DefaultPooledObject<T> implements
PooledObject<T> {
* only include caller class information rather than method names, line
numbers,
* and other normal metadata available in a full stack trace.
*
- * @param requireFullStackTrace the new configuration setting for
abandoned object
+ * @param requireFullStackTrace The new configuration setting for
abandoned object
* logging
* @since 2.5
*/
diff --git a/src/main/java/org/apache/commons/pool3/impl/EvictionTimer.java
b/src/main/java/org/apache/commons/pool3/impl/EvictionTimer.java
index 61cfcc6e..c4c8adf2 100644
--- a/src/main/java/org/apache/commons/pool3/impl/EvictionTimer.java
+++ b/src/main/java/org/apache/commons/pool3/impl/EvictionTimer.java
@@ -108,7 +108,7 @@ final class EvictionTimer {
/**
* Constructs a new instance to track the given reference.
*
- * @param ref the reference to track.
+ * @param ref The reference to track.
*/
private WeakRunner(final WeakReference<R> ref) {
this.ref = ref;
diff --git
a/src/main/java/org/apache/commons/pool3/impl/GenericKeyedObjectPool.java
b/src/main/java/org/apache/commons/pool3/impl/GenericKeyedObjectPool.java
index ca346633..fc4d6da6 100644
--- a/src/main/java/org/apache/commons/pool3/impl/GenericKeyedObjectPool.java
+++ b/src/main/java/org/apache/commons/pool3/impl/GenericKeyedObjectPool.java
@@ -247,7 +247,7 @@ public class GenericKeyedObjectPool<K, T, E extends
Exception> extends BaseGener
* Constructs a new {@code GenericKeyedObjectPool} using defaults from
* {@link GenericKeyedObjectPoolConfig}.
*
- * @param factory the factory to be used to create entries
+ * @param factory The factory to be used to create entries
*/
public GenericKeyedObjectPool(final KeyedPooledObjectFactory<K, T, E>
factory) {
this(factory, new GenericKeyedObjectPoolConfig<>());
@@ -257,7 +257,7 @@ public class GenericKeyedObjectPool<K, T, E extends
Exception> extends BaseGener
* Constructs a new {@code GenericKeyedObjectPool} using a specific
* configuration.
*
- * @param factory the factory to be used to create entries
+ * @param factory The factory to be used to create entries
* @param config The configuration to use for this pool instance. The
* configuration is used by value. Subsequent changes to
* the configuration object will not be reflected in the
@@ -332,7 +332,7 @@ public class GenericKeyedObjectPool<K, T, E extends
Exception> extends BaseGener
* a {@code NullPointerException} is thrown.
* </p>
*
- * @param key the key a new instance should be added to
+ * @param key The key a new instance should be added to
* @throws E when {@link KeyedPooledObjectFactory#makeObject}
* fails.
*/
@@ -591,7 +591,7 @@ public class GenericKeyedObjectPool<K, T, E extends
Exception> extends BaseGener
* instances to the most loaded keyed pools. To avoid triggering
* possible object creation, use {@link #clear(Object, boolean)}.
*
- * @param key the key to clear
+ * @param key The key to clear
*/
@Override
public void clear(final K key) {
@@ -609,7 +609,7 @@ public class GenericKeyedObjectPool<K, T, E extends
Exception> extends BaseGener
* by this operation, adding instances to the most loaded keyed pools.
* </p>
*
- * @param key the key to clear
+ * @param key The key to clear
* @param reuseCapacity whether or not to reuse freed capacity
* @since 2.12.0
*/
@@ -1600,7 +1600,7 @@ public class GenericKeyedObjectPool<K, T, E extends
Exception> extends BaseGener
/**
* Sets the configuration.
*
- * @param conf the new configuration to use. This is used by value.
+ * @param conf The new configuration to use. This is used by value.
* @see GenericKeyedObjectPoolConfig
*/
public void setConfig(final GenericKeyedObjectPoolConfig<T> conf) {
@@ -1621,7 +1621,7 @@ public class GenericKeyedObjectPool<K, T, E extends
Exception> extends BaseGener
* maxIdlePerKey for heavily loaded system will vary but the default is a
* good starting point.
*
- * @param maxIdlePerKey the maximum number of "idle" instances that can be
+ * @param maxIdlePerKey The maximum number of "idle" instances that can be
* held in a given keyed sub-pool. Use a negative
value
* for no limit
*
@@ -1636,7 +1636,7 @@ public class GenericKeyedObjectPool<K, T, E extends
Exception> extends BaseGener
* (checked out or idle), per key. When the limit is reached, the sub-pool
* is said to be exhausted. A negative value indicates no limit.
*
- * @param maxTotalPerKey the limit on the number of active instances per
key
+ * @param maxTotalPerKey The limit on the number of active instances per
key
* @see #getMaxTotalPerKey
*/
public void setMaxTotalPerKey(final int maxTotalPerKey) {
diff --git a/src/main/java/org/apache/commons/pool3/impl/GenericObjectPool.java
b/src/main/java/org/apache/commons/pool3/impl/GenericObjectPool.java
index 43038fbe..48db5a9b 100644
--- a/src/main/java/org/apache/commons/pool3/impl/GenericObjectPool.java
+++ b/src/main/java/org/apache/commons/pool3/impl/GenericObjectPool.java
@@ -634,7 +634,7 @@ public class GenericObjectPool<T, E extends Exception>
extends BaseGenericObject
* is thrown.
* </p>
*
- * @param idleCount the number of idle instances desired
+ * @param idleCount The number of idle instances desired
* @param always true means create instances even if the pool has no
threads waiting
* @throws E if the factory's makeObject throws
*/
@@ -1114,7 +1114,7 @@ public class GenericObjectPool<T, E extends Exception>
extends BaseGenericObject
/**
* Sets the base pool configuration.
*
- * @param conf the new configuration to use. This is used by value.
+ * @param conf The new configuration to use. This is used by value.
* @see GenericObjectPoolConfig
*/
public void setConfig(final GenericObjectPoolConfig<T> conf) {
diff --git
a/src/main/java/org/apache/commons/pool3/impl/InterruptibleReentrantLock.java
b/src/main/java/org/apache/commons/pool3/impl/InterruptibleReentrantLock.java
index c964bc70..8b5410a0 100644
---
a/src/main/java/org/apache/commons/pool3/impl/InterruptibleReentrantLock.java
+++
b/src/main/java/org/apache/commons/pool3/impl/InterruptibleReentrantLock.java
@@ -46,7 +46,7 @@ final class InterruptibleReentrantLock extends ReentrantLock {
/**
* Interrupts the threads that are waiting on a specific condition.
*
- * @param condition the condition on which the threads are waiting.
+ * @param condition The condition on which the threads are waiting.
*/
void interruptWaiters(final Condition condition) {
getWaitingThreads(condition).forEach(Thread::interrupt);
diff --git
a/src/main/java/org/apache/commons/pool3/impl/LinkedBlockingDeque.java
b/src/main/java/org/apache/commons/pool3/impl/LinkedBlockingDeque.java
index 27482686..abe1da80 100644
--- a/src/main/java/org/apache/commons/pool3/impl/LinkedBlockingDeque.java
+++ b/src/main/java/org/apache/commons/pool3/impl/LinkedBlockingDeque.java
@@ -347,7 +347,7 @@ final class LinkedBlockingDeque<E> extends AbstractQueue<E>
* the given collection, added in traversal order of the
* collection's iterator.
*
- * @param c the collection of elements to initially contain
+ * @param c The collection of elements to initially contain
* @throws NullPointerException if the specified collection or any
* of its elements are null
*/
@@ -369,7 +369,7 @@ final class LinkedBlockingDeque<E> extends AbstractQueue<E>
/**
* Creates a {@code LinkedBlockingDeque} with the given (fixed) capacity.
*
- * @param capacity the capacity of this deque
+ * @param capacity The capacity of this deque
* @throws IllegalArgumentException if {@code capacity} is less than 1
*/
LinkedBlockingDeque(final int capacity) {
@@ -380,7 +380,7 @@ final class LinkedBlockingDeque<E> extends AbstractQueue<E>
* Creates a {@code LinkedBlockingDeque} with the given (fixed) capacity
* and fairness policy.
*
- * @param capacity the capacity of this deque
+ * @param capacity The capacity of this deque
* @param fairness true means threads waiting on the deque should be served
* as if waiting in a FIFO request queue
* @throws IllegalArgumentException if {@code capacity} is less than 1
@@ -1086,7 +1086,7 @@ final class LinkedBlockingDeque<E> extends
AbstractQueue<E>
/**
* Reconstitutes this deque from a stream (that is, deserialize it).
*
- * @param s the stream
+ * @param s The stream
*/
private void readObject(final ObjectInputStream s) throws IOException,
ClassNotFoundException {
s.defaultReadObject();
@@ -1493,7 +1493,7 @@ final class LinkedBlockingDeque<E> extends
AbstractQueue<E>
*
* @serialData The capacity (int), followed by elements (each an
* {@code Object}) in the proper order, followed by a null
- * @param s the stream
+ * @param s The stream
* @throws IOException if I/O errors occur while writing to the
underlying {@code OutputStream}
*/
private void writeObject(final java.io.ObjectOutputStream s) throws
IOException {
diff --git a/src/main/java/org/apache/commons/pool3/impl/PoolImplUtils.java
b/src/main/java/org/apache/commons/pool3/impl/PoolImplUtils.java
index a326b590..b2c27120 100644
--- a/src/main/java/org/apache/commons/pool3/impl/PoolImplUtils.java
+++ b/src/main/java/org/apache/commons/pool3/impl/PoolImplUtils.java
@@ -132,7 +132,7 @@ final class PoolImplUtils {
* definition of the class
*
* @param clazz defining class
- * @param argType the type argument of interest
+ * @param argType The type argument of interest
* @return An instance of {@link Class} representing the type used by the
type parameter or an instance of
* {@link Integer} representing the index for the type in the
definition of the defining class
*/
@@ -157,7 +157,7 @@ final class PoolImplUtils {
* Returns the greater of two {@code Instant} values. That is, the result
is the argument closer to the value of
* {@link Instant#MAX}. If the arguments have the same value, the result
is that same value.
*
- * @param a an argument.
+ * @param a An argument.
* @param b another argument.
* @return The larger of {@code a} and {@code b}.
*/
@@ -169,7 +169,7 @@ final class PoolImplUtils {
* Returns the smaller of two {@code Instant} values. That is, the result
is the argument closer to the value of
* {@link Instant#MIN}. If the arguments have the same value, the result
is that same value.
*
- * @param a an argument.
+ * @param a An argument.
* @param b another argument.
* @return The smaller of {@code a} and {@code b}.
*/
@@ -219,8 +219,8 @@ final class PoolImplUtils {
/**
* Converts am amount and TimeUnit into a Duration.
*
- * @param amount the amount of the duration, measured in terms of the
unit, positive or negative
- * @param timeUnit the unit that the duration is measured in, must have an
exact duration, not null
+ * @param amount The amount of the duration, measured in terms of the
unit, positive or negative
+ * @param timeUnit The unit that the duration is measured in, must have an
exact duration, not null
* @return A Duration.
*/
static Duration toDuration(final long amount, final TimeUnit timeUnit) {
diff --git
a/src/main/java/org/apache/commons/pool3/impl/ResilientPooledObjectFactory.java
b/src/main/java/org/apache/commons/pool3/impl/ResilientPooledObjectFactory.java
index 2266f687..53f5ea0b 100644
---
a/src/main/java/org/apache/commons/pool3/impl/ResilientPooledObjectFactory.java
+++
b/src/main/java/org/apache/commons/pool3/impl/ResilientPooledObjectFactory.java
@@ -487,7 +487,7 @@ public class ResilientPooledObjectFactory<T, E extends
Exception> implements Poo
/**
* Sets the makeObject log size.
*
- * @param logSize the number of makeObject events to keep in the log
+ * @param logSize The number of makeObject events to keep in the log
*/
public void setLogSize(final int logSize) {
this.logSize = logSize;
@@ -496,7 +496,7 @@ public class ResilientPooledObjectFactory<T, E extends
Exception> implements Poo
/**
* Sets the underlying pool. For tests.
*
- * @param pool the underlying pool.
+ * @param pool The underlying pool.
*/
void setPool(final GenericObjectPool<T, E> pool) {
this.pool = pool;
diff --git a/src/main/java/org/apache/commons/pool3/proxy/CglibProxySource.java
b/src/main/java/org/apache/commons/pool3/proxy/CglibProxySource.java
index 9b703fa2..9de3cad9 100644
--- a/src/main/java/org/apache/commons/pool3/proxy/CglibProxySource.java
+++ b/src/main/java/org/apache/commons/pool3/proxy/CglibProxySource.java
@@ -58,7 +58,7 @@ public class CglibProxySource<T> extends
AbstractProxySource<T> {
/**
* Sets the superclass.
*
- * @param superclass the superclass.
+ * @param superclass The superclass.
* @return {@code this} instance.
*/
public Builder<T> setSuperclass(final Class<? extends T> superclass) {
diff --git a/src/main/java/org/apache/commons/pool3/proxy/JdkProxySource.java
b/src/main/java/org/apache/commons/pool3/proxy/JdkProxySource.java
index ddb9e7e9..15b35c82 100644
--- a/src/main/java/org/apache/commons/pool3/proxy/JdkProxySource.java
+++ b/src/main/java/org/apache/commons/pool3/proxy/JdkProxySource.java
@@ -56,7 +56,7 @@ public class JdkProxySource<T> extends AbstractProxySource<T>
{
/**
* Sets the class loader to define the proxy class.
*
- * @param classLoader the class loader to define the proxy class.
+ * @param classLoader The class loader to define the proxy class.
* @return {@code this} instance.
*/
public Builder<T> setClassLoader(final ClassLoader classLoader) {
@@ -67,7 +67,7 @@ public class JdkProxySource<T> extends AbstractProxySource<T>
{
/**
* Sets the list of interfaces for the proxy class.
*
- * @param interfaces the list of interfaces for the proxy class.
+ * @param interfaces The list of interfaces for the proxy class.
* @return {@code this} instance.
*/
public Builder<T> setInterfaces(final Class<?>... interfaces) {
diff --git
a/src/test/java/org/apache/commons/pool3/impl/AtomicIntegerFactory.java
b/src/test/java/org/apache/commons/pool3/impl/AtomicIntegerFactory.java
index d9dd5b78..82f5592f 100644
--- a/src/test/java/org/apache/commons/pool3/impl/AtomicIntegerFactory.java
+++ b/src/test/java/org/apache/commons/pool3/impl/AtomicIntegerFactory.java
@@ -61,35 +61,35 @@ public class AtomicIntegerFactory
}
/**
- * @param activateLatency the activateLatency to set
+ * @param activateLatency The activateLatency to set
*/
public void setActivateLatency(final long activateLatency) {
this.activateLatency = activateLatency;
}
/**
- * @param createLatency the createLatency to set
+ * @param createLatency The createLatency to set
*/
public void setCreateLatency(final long createLatency) {
this.createLatency = createLatency;
}
/**
- * @param destroyLatency the destroyLatency to set
+ * @param destroyLatency The destroyLatency to set
*/
public void setDestroyLatency(final long destroyLatency) {
this.destroyLatency = destroyLatency;
}
/**
- * @param passivateLatency the passivateLatency to set
+ * @param passivateLatency The passivateLatency to set
*/
public void setPassivateLatency(final long passivateLatency) {
this.passivateLatency = passivateLatency;
}
/**
- * @param validateLatency the validateLatency to set
+ * @param validateLatency The validateLatency to set
*/
public void setValidateLatency(final long validateLatency) {
this.validateLatency = validateLatency;
