This is an automated email from the ASF dual-hosted git repository.
garydgregory pushed a commit to branch POOL_2_X
in repository https://gitbox.apache.org/repos/asf/commons-pool.git
The following commit(s) were added to refs/heads/POOL_2_X by this push:
new 43edb76e Javadoc
43edb76e is described below
commit 43edb76e48efe3d5f2339f366e77cb4dbbd11c04
Author: Gary Gregory <[email protected]>
AuthorDate: Sat Jul 11 08:57:11 2026 -0400
Javadoc
---
.../org/apache/commons/pool2/KeyedObjectPool.java | 8 +++---
.../java/org/apache/commons/pool2/ObjectPool.java | 4 +--
.../java/org/apache/commons/pool2/PoolUtils.java | 8 +++---
.../org/apache/commons/pool2/PooledObject.java | 6 ++--
.../java/org/apache/commons/pool2/TrackedUse.java | 4 +--
.../apache/commons/pool2/impl/AbandonedConfig.java | 4 +--
.../commons/pool2/impl/BaseGenericObjectPool.java | 32 +++++++++++-----------
.../commons/pool2/impl/DefaultPooledObject.java | 6 ++--
.../pool2/impl/DefaultPooledObjectInfo.java | 2 +-
.../apache/commons/pool2/impl/EvictionTimer.java | 4 +--
.../commons/pool2/impl/GenericKeyedObjectPool.java | 6 ++--
.../commons/pool2/impl/GenericObjectPool.java | 4 +--
.../commons/pool2/impl/LinkedBlockingDeque.java | 24 ++++++++--------
.../apache/commons/pool2/impl/PoolImplUtils.java | 8 +++---
.../pool2/impl/SoftReferenceObjectPool.java | 4 +--
.../commons/pool2/proxy/BaseProxyHandler.java | 4 +--
.../apache/commons/pool2/proxy/ProxySource.java | 2 +-
.../commons/pool2/AbstractTestKeyedObjectPool.java | 4 +--
.../commons/pool2/AbstractTestObjectPool.java | 2 +-
.../apache/commons/pool2/TestBaseObjectPool.java | 2 +-
.../org/apache/commons/pool2/WaiterFactory.java | 2 +-
21 files changed, 70 insertions(+), 70 deletions(-)
diff --git a/src/main/java/org/apache/commons/pool2/KeyedObjectPool.java
b/src/main/java/org/apache/commons/pool2/KeyedObjectPool.java
index 604a731e..01e1690b 100644
--- a/src/main/java/org/apache/commons/pool2/KeyedObjectPool.java
+++ b/src/main/java/org/apache/commons/pool2/KeyedObjectPool.java
@@ -226,7 +226,7 @@ public interface KeyedObjectPool<K, V> extends Closeable {
* not yet returned. Returns a negative value if this information is not
* available.
*
- * @return the total number of instances currently borrowed from this pool
but
+ * @return The total number of instances currently borrowed from this pool
but
* not yet returned.
*/
int getNumActive();
@@ -237,7 +237,7 @@ public interface KeyedObjectPool<K, V> extends Closeable {
* Returns a negative value if this information is not available.
*
* @param key the key to query
- * @return the number of instances currently borrowed from but not yet
+ * @return The number of instances currently borrowed from but not yet
* returned to the pool corresponding to the given {@code key}.
*/
int getNumActive(K key);
@@ -246,7 +246,7 @@ public interface KeyedObjectPool<K, V> extends Closeable {
* Gets the total number of instances currently idle in this pool.
* Returns a negative value if this information is not available.
*
- * @return the total number of instances currently idle in this pool.
+ * @return The total number of instances currently idle in this pool.
*/
int getNumIdle();
@@ -256,7 +256,7 @@ public interface KeyedObjectPool<K, V> extends Closeable {
* this information is not available.
*
* @param key the key to query
- * @return the number of instances corresponding to the given
+ * @return The number of instances corresponding to the given
* {@code key} currently idle in this pool.
*/
int getNumIdle(K key);
diff --git a/src/main/java/org/apache/commons/pool2/ObjectPool.java
b/src/main/java/org/apache/commons/pool2/ObjectPool.java
index 3404472d..93d0f5d6 100644
--- a/src/main/java/org/apache/commons/pool2/ObjectPool.java
+++ b/src/main/java/org/apache/commons/pool2/ObjectPool.java
@@ -150,7 +150,7 @@ public interface ObjectPool<T> extends Closeable {
* Gets the number of instances currently borrowed from this pool. Returns
* a negative value if this information is not available.
*
- * @return the number of instances currently borrowed from this pool.
+ * @return The number of instances currently borrowed from this pool.
*/
int getNumActive();
@@ -160,7 +160,7 @@ public interface ObjectPool<T> extends Closeable {
* {@link #borrowObject borrowed} without creating any new instances.
* Returns a negative value if this information is not available.
*
- * @return the number of instances currently idle in this pool.
+ * @return The number of instances currently idle in this pool.
*/
int getNumIdle();
diff --git a/src/main/java/org/apache/commons/pool2/PoolUtils.java
b/src/main/java/org/apache/commons/pool2/PoolUtils.java
index 40d6196e..156467cb 100644
--- a/src/main/java/org/apache/commons/pool2/PoolUtils.java
+++ b/src/main/java/org/apache/commons/pool2/PoolUtils.java
@@ -222,7 +222,7 @@ public final class PoolUtils {
/**
* Gets the underlying pool
*
- * @return the keyed pool that this ErodingKeyedObjectPool wraps
+ * @return The keyed pool that this ErodingKeyedObjectPool wraps
*/
protected KeyedObjectPool<K, V> getKeyedPool() {
return keyedPool;
@@ -1384,7 +1384,7 @@ public final class PoolUtils {
* keyedPool, see {@link Timer#schedule(TimerTask, long, long)}.
* @param <K> The type of the pool key
* @param <V> The type of pool entries
- * @return the {@link TimerTask} that will periodically check the pools
idle
+ * @return The {@link TimerTask} that will periodically check the pools
idle
* object count.
* @throws IllegalArgumentException
* when {@code keyedPool}, {@code key} is {@code null} or
@@ -1424,7 +1424,7 @@ public final class PoolUtils {
* the frequency in milliseconds to check the number of idle
objects in a pool,
* see {@link Timer#schedule(TimerTask, long, long)}.
* @param <T> The type of objects in the pool
- * @return the {@link TimerTask} that will periodically check the pools
idle
+ * @return The {@link TimerTask} that will periodically check the pools
idle
* object count.
* @throws IllegalArgumentException
* when {@code pool} is {@code null} or when {@code minIdle} is
@@ -1642,7 +1642,7 @@ public final class PoolUtils {
/**
* Gets the {@code Timer} for checking keyedPool's idle count.
*
- * @return the {@link Timer} for checking keyedPool's idle count.
+ * @return The {@link Timer} for checking keyedPool's idle count.
*/
private static Timer getMinIdleTimer() {
return TimerHolder.MIN_IDLE_TIMER;
diff --git a/src/main/java/org/apache/commons/pool2/PooledObject.java
b/src/main/java/org/apache/commons/pool2/PooledObject.java
index 5d301107..52d1aa0f 100644
--- a/src/main/java/org/apache/commons/pool2/PooledObject.java
+++ b/src/main/java/org/apache/commons/pool2/PooledObject.java
@@ -38,7 +38,7 @@ public interface PooledObject<T> extends
Comparable<PooledObject<T>> {
*
* @param <T> The type of object in the pool.
* @param pooledObject the PooledObject to unwrap, may be null.
- * @return the wrapped object or null.
+ * @return The wrapped object or null.
* @since 2.13.0
*/
static <T> T getObject(final PooledObject<T> pooledObject) {
@@ -270,7 +270,7 @@ public interface PooledObject<T> extends
Comparable<PooledObject<T>> {
* {@link TrackedUse}, what is returned is the maximum of {@link
TrackedUse#getLastUsedInstant()} and
* {@link #getLastBorrowTime()}; otherwise this method gives the same
value as {@link #getLastBorrowTime()}.
*
- * @return the last time this object was used
+ * @return The last time this object was used
* @since 2.11.0
*/
default Instant getLastUsedInstant() {
@@ -284,7 +284,7 @@ public interface PooledObject<T> extends
Comparable<PooledObject<T>> {
* {@link #getLastBorrowTime()}; otherwise this method gives the same
* value as {@link #getLastBorrowTime()}.
*
- * @return the last time this object was used.
+ * @return The last time this object was used.
* @deprecated Use {@link #getLastUsedInstant()} which offers the best
precision.
*/
@Deprecated
diff --git a/src/main/java/org/apache/commons/pool2/TrackedUse.java
b/src/main/java/org/apache/commons/pool2/TrackedUse.java
index 99eb0e26..9702df20 100644
--- a/src/main/java/org/apache/commons/pool2/TrackedUse.java
+++ b/src/main/java/org/apache/commons/pool2/TrackedUse.java
@@ -30,7 +30,7 @@ public interface TrackedUse {
/**
* Gets the last time this object was used in milliseconds.
*
- * @return the last time this object was used in milliseconds.
+ * @return The last time this object was used in milliseconds.
* @deprecated Use {@link #getLastUsedInstant()} which offers the best
precision.
*/
@Deprecated
@@ -43,7 +43,7 @@ public interface TrackedUse {
* of microseconds, depending on the OS, Hardware, and JVM implementation.
* </p>
*
- * @return the last Instant this object was used.
+ * @return The last Instant this object was used.
* @since 2.11.0
*/
default Instant getLastUsedInstant() {
diff --git a/src/main/java/org/apache/commons/pool2/impl/AbandonedConfig.java
b/src/main/java/org/apache/commons/pool2/impl/AbandonedConfig.java
index f667bf8b..90ab46ed 100644
--- a/src/main/java/org/apache/commons/pool2/impl/AbandonedConfig.java
+++ b/src/main/java/org/apache/commons/pool2/impl/AbandonedConfig.java
@@ -186,7 +186,7 @@ public class AbandonedConfig {
*
* <p>The default value is 300 seconds.</p>
*
- * @return the abandoned object timeout in seconds.
+ * @return The abandoned object timeout in seconds.
* @deprecated Use {@link #getRemoveAbandonedTimeoutDuration()}.
*/
@Deprecated
@@ -203,7 +203,7 @@ public class AbandonedConfig {
*
* <p>The default value is 300 seconds.</p>
*
- * @return the abandoned object timeout.
+ * @return The abandoned object timeout.
* @since 2.10.0
*/
public Duration getRemoveAbandonedTimeoutDuration() {
diff --git
a/src/main/java/org/apache/commons/pool2/impl/BaseGenericObjectPool.java
b/src/main/java/org/apache/commons/pool2/impl/BaseGenericObjectPool.java
index d807bfb7..0f412a7e 100644
--- a/src/main/java/org/apache/commons/pool2/impl/BaseGenericObjectPool.java
+++ b/src/main/java/org/apache/commons/pool2/impl/BaseGenericObjectPool.java
@@ -88,7 +88,7 @@ public abstract class BaseGenericObjectPool<T> extends
BaseObject implements Aut
/**
* Gets the idle object deque referenced by this iterator.
*
- * @return the idle object deque
+ * @return The idle object deque
*/
public Deque<PooledObject<T>> getIdleObjects() {
return idleObjects;
@@ -238,7 +238,7 @@ public abstract class BaseGenericObjectPool<T> extends
BaseObject implements Aut
}
/**
- * @return the wrapped object
+ * @return The wrapped object
*/
T getObject() {
return object;
@@ -302,7 +302,7 @@ public abstract class BaseGenericObjectPool<T> extends
BaseObject implements Aut
/**
* Gets the mean of the cached values.
*
- * @return the mean of the cache, truncated to long
+ * @return The mean of the cache, truncated to long
*/
public long getMean() {
double result = 0;
@@ -320,7 +320,7 @@ public abstract class BaseGenericObjectPool<T> extends
BaseObject implements Aut
/**
* Gets the mean Duration of the cached values.
*
- * @return the mean Duration of the cache, truncated to long
milliseconds of a Duration.
+ * @return The mean Duration of the cache, truncated to long
milliseconds of a Duration.
*/
Duration getMeanDuration() {
return Duration.ofMillis(getMean());
@@ -329,7 +329,7 @@ public abstract class BaseGenericObjectPool<T> extends
BaseObject implements Aut
/**
* Gets the current values as a List.
*
- * @return the current values as a List.
+ * @return The current values as a List.
*/
synchronized List<AtomicLong> getValues() {
return Arrays.stream(values, 0,
index).collect(Collectors.toList());
@@ -502,7 +502,7 @@ public abstract class BaseGenericObjectPool<T> extends
BaseObject implements Aut
* Returns the duration since the given start time.
*
* @param startInstant the start time
- * @return the duration since the given start time
+ * @return The duration since the given start time
*/
final Duration durationSince(final Instant startInstant) {
return Duration.between(startInstant, Instant.now());
@@ -546,7 +546,7 @@ public abstract class BaseGenericObjectPool<T> extends
BaseObject implements Aut
* Gets the total number of objects successfully borrowed from this pool
over the
* lifetime of the pool.
*
- * @return the borrowed object count
+ * @return The borrowed object count
*/
public final long getBorrowedCount() {
return borrowedCount.get();
@@ -570,7 +570,7 @@ public abstract class BaseGenericObjectPool<T> extends
BaseObject implements Aut
* Gets the total number of objects created for this pool over the
lifetime of
* the pool.
*
- * @return the created object count
+ * @return The created object count
*/
public final long getCreatedCount() {
return createdCount.get();
@@ -604,7 +604,7 @@ public abstract class BaseGenericObjectPool<T> extends
BaseObject implements Aut
* Gets the total number of objects destroyed by the evictor associated
with this
* pool over the lifetime of the pool.
*
- * @return the evictor destroyed object count
+ * @return The evictor destroyed object count
*/
public final long getDestroyedByEvictorCount() {
return destroyedByEvictorCount.get();
@@ -614,7 +614,7 @@ public abstract class BaseGenericObjectPool<T> extends
BaseObject implements Aut
* Gets the total number of objects destroyed by this pool over the
lifetime of
* the pool.
*
- * @return the destroyed object count
+ * @return The destroyed object count
*/
public final long getDestroyedCount() {
return destroyedCount.get();
@@ -636,7 +636,7 @@ public abstract class BaseGenericObjectPool<T> extends
BaseObject implements Aut
/**
* Gets the {@link EvictionPolicy} defined for this pool.
*
- * @return the eviction policy
+ * @return The eviction policy
* @since 2.4
* @since 2.6.0 Changed access from protected to public.
*/
@@ -713,7 +713,7 @@ public abstract class BaseGenericObjectPool<T> extends
BaseObject implements Aut
* platform MBean server or {@code null} if the pool has not been
* registered.
*
- * @return the JMX name
+ * @return The JMX name
*/
public final ObjectName getJmxName() {
return objectName;
@@ -776,7 +776,7 @@ public abstract class BaseGenericObjectPool<T> extends
BaseObject implements Aut
* negative, there is no limit to the number of objects that can be
* managed by the pool at one time.
*
- * @return the cap on the total number of object instances managed by the
+ * @return The cap on the total number of object instances managed by the
* pool.
* @see #setMaxTotal
*/
@@ -791,7 +791,7 @@ public abstract class BaseGenericObjectPool<T> extends
BaseObject implements Aut
* {@link #getBlockWhenExhausted} is true. When less than 0, the
* {@code borrowObject()} method may block indefinitely.
*
- * @return the maximum number of milliseconds {@code borrowObject()}
+ * @return The maximum number of milliseconds {@code borrowObject()}
* will block.
*
* @see #setMaxWait
@@ -809,7 +809,7 @@ public abstract class BaseGenericObjectPool<T> extends
BaseObject implements Aut
* {@link #getBlockWhenExhausted} is true. When less than 0, the
* {@code borrowObject()} method may block indefinitely.
*
- * @return the maximum number of milliseconds {@code borrowObject()}
+ * @return The maximum number of milliseconds {@code borrowObject()}
* will block.
*
* @see #setMaxWait
@@ -1057,7 +1057,7 @@ public abstract class BaseGenericObjectPool<T> extends
BaseObject implements Aut
* the pool. This excludes attempts to return the same object multiple
* times.
*
- * @return the returned object count
+ * @return The returned object count
*/
public final long getReturnedCount() {
return returnedCount.get();
diff --git
a/src/main/java/org/apache/commons/pool2/impl/DefaultPooledObject.java
b/src/main/java/org/apache/commons/pool2/impl/DefaultPooledObject.java
index 9acb7d4f..7035a57e 100644
--- a/src/main/java/org/apache/commons/pool2/impl/DefaultPooledObject.java
+++ b/src/main/java/org/apache/commons/pool2/impl/DefaultPooledObject.java
@@ -207,7 +207,7 @@ public class DefaultPooledObject<T> implements
PooledObject<T> {
* {@link #getLastBorrowTime()}; otherwise this method gives the same
* value as {@link #getLastBorrowTime()}.
*
- * @return the last Instant this object was used.
+ * @return The last Instant this object was used.
*/
@Override
public Instant getLastUsedInstant() {
@@ -224,7 +224,7 @@ public class DefaultPooledObject<T> implements
PooledObject<T> {
* {@link #getLastBorrowTime()}; otherwise this method gives the same
* value as {@link #getLastBorrowTime()}.
*
- * @return the last time this object was used
+ * @return The last time this object was used
*/
@Override
public long getLastUsedTime() {
@@ -273,7 +273,7 @@ public class DefaultPooledObject<T> implements
PooledObject<T> {
/**
* Gets the current instant of the clock.
*
- * @return the current instant of the clock.
+ * @return The current instant of the clock.
*/
private Instant now() {
return systemClock.instant();
diff --git
a/src/main/java/org/apache/commons/pool2/impl/DefaultPooledObjectInfo.java
b/src/main/java/org/apache/commons/pool2/impl/DefaultPooledObjectInfo.java
index 4034148b..0aa235f2 100644
--- a/src/main/java/org/apache/commons/pool2/impl/DefaultPooledObjectInfo.java
+++ b/src/main/java/org/apache/commons/pool2/impl/DefaultPooledObjectInfo.java
@@ -108,7 +108,7 @@ public class DefaultPooledObjectInfo implements
DefaultPooledObjectInfoMBean {
* This can't be a traditional getter as that would expose the pooled
object via JMX.
* </p>
*
- * @return the pooled object for debugging, use at your own risk, changing
the state of this object may have unintended consequences for the pool.
+ * @return The pooled object for debugging, use at your own risk, changing
the state of this object may have unintended consequences for the pool.
* @since 2.14.0
*/
public PooledObject<?> pooledObject() {
diff --git a/src/main/java/org/apache/commons/pool2/impl/EvictionTimer.java
b/src/main/java/org/apache/commons/pool2/impl/EvictionTimer.java
index 96dd2655..0e9e3e90 100644
--- a/src/main/java/org/apache/commons/pool2/impl/EvictionTimer.java
+++ b/src/main/java/org/apache/commons/pool2/impl/EvictionTimer.java
@@ -177,7 +177,7 @@ final class EvictionTimer {
/**
* Gets the number of eviction tasks under management.
*
- * @return the number of eviction tasks under management.
+ * @return The number of eviction tasks under management.
*/
static synchronized int getNumTasks() {
return TASK_MAP.size();
@@ -186,7 +186,7 @@ final class EvictionTimer {
/**
* Gets the task map. Keys are weak references to tasks, values are
runners managed by executor.
*
- * @return the task map.
+ * @return The task map.
*/
static HashMap<WeakReference<BaseGenericObjectPool<?>.Evictor>,
WeakRunner<BaseGenericObjectPool<?>.Evictor>> getTaskMap() {
return TASK_MAP;
diff --git
a/src/main/java/org/apache/commons/pool2/impl/GenericKeyedObjectPool.java
b/src/main/java/org/apache/commons/pool2/impl/GenericKeyedObjectPool.java
index 8efa3a3b..e7061d1e 100644
--- a/src/main/java/org/apache/commons/pool2/impl/GenericKeyedObjectPool.java
+++ b/src/main/java/org/apache/commons/pool2/impl/GenericKeyedObjectPool.java
@@ -1203,7 +1203,7 @@ public class GenericKeyedObjectPool<K, T> extends
BaseGenericObjectPool<T>
* Gets a reference to the factory used to create, destroy and validate
* the objects used by this pool.
*
- * @return the factory
+ * @return The factory
*/
public KeyedPooledObjectFactory<K, T> getFactory() {
return factory;
@@ -1231,7 +1231,7 @@ public class GenericKeyedObjectPool<K, T> extends
BaseGenericObjectPool<T>
* maxIdlePerKey for heavily loaded system will vary but the default is a
* good starting point.
*
- * @return the maximum number of "idle" instances that can be held in a
+ * @return The maximum number of "idle" instances that can be held in a
* given keyed sub-pool or a negative value if there is no limit
*
* @see #setMaxIdlePerKey
@@ -1246,7 +1246,7 @@ public class GenericKeyedObjectPool<K, T> extends
BaseGenericObjectPool<T>
* (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.
*
- * @return the limit on the number of active instances per key
+ * @return The limit on the number of active instances per key
* @see #setMaxTotalPerKey
*/
@Override
diff --git a/src/main/java/org/apache/commons/pool2/impl/GenericObjectPool.java
b/src/main/java/org/apache/commons/pool2/impl/GenericObjectPool.java
index c6010506..ff9e6edf 100644
--- a/src/main/java/org/apache/commons/pool2/impl/GenericObjectPool.java
+++ b/src/main/java/org/apache/commons/pool2/impl/GenericObjectPool.java
@@ -773,7 +773,7 @@ public class GenericObjectPool<T> extends
BaseGenericObjectPool<T>
* Gets a reference to the factory used to create, destroy and validate
* the objects used by this pool.
*
- * @return the factory
+ * @return The factory
*/
public PooledObjectFactory<T> getFactory() {
return factory;
@@ -810,7 +810,7 @@ public class GenericObjectPool<T> extends
BaseGenericObjectPool<T>
* objects to rise above maxIdle. The best value for maxIdle for heavily
* loaded system will vary but the default is a good starting point.
*
- * @return the maximum number of "idle" instances that can be held in the
+ * @return The maximum number of "idle" instances that can be held in the
* pool or a negative value if there is no limit
* @see #setMaxIdle
*/
diff --git
a/src/main/java/org/apache/commons/pool2/impl/LinkedBlockingDeque.java
b/src/main/java/org/apache/commons/pool2/impl/LinkedBlockingDeque.java
index e982f5a6..1f5a0f9b 100644
--- a/src/main/java/org/apache/commons/pool2/impl/LinkedBlockingDeque.java
+++ b/src/main/java/org/apache/commons/pool2/impl/LinkedBlockingDeque.java
@@ -542,7 +542,7 @@ final class LinkedBlockingDeque<E> extends AbstractQueue<E>
*
* <p>This method is equivalent to {@link #getFirst() getFirst}.
*
- * @return the head of the queue represented by this deque
+ * @return The head of the queue represented by this deque
* @throws NoSuchElementException if this deque is empty
*/
@Override
@@ -883,7 +883,7 @@ final class LinkedBlockingDeque<E> extends AbstractQueue<E>
* <p>This method is equivalent to {@link #pollFirst(long, TimeUnit)}.
*
* @param timeout length of time to wait
- * @return the unlinked element
+ * @return The unlinked element
* @throws InterruptedException if the current thread is interrupted
*/
E poll(final Duration timeout) throws InterruptedException {
@@ -898,7 +898,7 @@ final class LinkedBlockingDeque<E> extends AbstractQueue<E>
*
* @param timeout length of time to wait
* @param unit units that timeout is expressed in
- * @return the unlinked element
+ * @return The unlinked element
* @throws InterruptedException if the current thread is interrupted
*/
@Override
@@ -921,7 +921,7 @@ final class LinkedBlockingDeque<E> extends AbstractQueue<E>
* to do so if the queue is empty.
*
* @param timeout length of time to wait
- * @return the unlinked element
+ * @return The unlinked element
* @throws InterruptedException if the current thread is interrupted
*/
E pollFirst(final Duration timeout) throws InterruptedException {
@@ -947,7 +947,7 @@ final class LinkedBlockingDeque<E> extends AbstractQueue<E>
*
* @param timeout length of time to wait
* @param unit units that timeout is expressed in
- * @return the unlinked element
+ * @return The unlinked element
* @throws InterruptedException if the current thread is interrupted
*/
@Override
@@ -970,7 +970,7 @@ final class LinkedBlockingDeque<E> extends AbstractQueue<E>
* to do so if the queue is empty.
*
* @param timeout length of time to wait
- * @return the unlinked element
+ * @return The unlinked element
* @throws InterruptedException if the current thread is interrupted
*/
E pollLast(final Duration timeout)
@@ -997,7 +997,7 @@ final class LinkedBlockingDeque<E> extends AbstractQueue<E>
*
* @param timeout length of time to wait
* @param unit units that timeout is expressed in
- * @return the unlinked element
+ * @return The unlinked element
* @throws InterruptedException if the current thread is interrupted
*/
@Override
@@ -1143,7 +1143,7 @@ final class LinkedBlockingDeque<E> extends
AbstractQueue<E>
* This method is equivalent to {@link #removeFirst() removeFirst}.
* </p>
*
- * @return the head of the queue represented by this deque
+ * @return The head of the queue represented by this deque
* @throws NoSuchElementException if this deque is empty
*/
@Override
@@ -1278,7 +1278,7 @@ final class LinkedBlockingDeque<E> extends
AbstractQueue<E>
/**
* Returns the number of elements in this deque.
*
- * @return the number of elements in this deque
+ * @return The number of elements in this deque
*/
@Override
public int size() {
@@ -1298,7 +1298,7 @@ final class LinkedBlockingDeque<E> extends
AbstractQueue<E>
* This method is equivalent to {@link #takeFirst()}.
* </p>
*
- * @return the unlinked element
+ * @return The unlinked element
* @throws InterruptedException if the current thread is interrupted
*/
@Override
@@ -1310,7 +1310,7 @@ final class LinkedBlockingDeque<E> extends
AbstractQueue<E>
* Unlinks the first element in the queue, waiting until there is an
element
* to unlink if the queue is empty.
*
- * @return the unlinked element
+ * @return The unlinked element
* @throws InterruptedException if the current thread is interrupted
*/
@Override
@@ -1331,7 +1331,7 @@ final class LinkedBlockingDeque<E> extends
AbstractQueue<E>
* Unlinks the last element in the queue, waiting until there is an element
* to unlink if the queue is empty.
*
- * @return the unlinked element
+ * @return The unlinked element
* @throws InterruptedException if the current thread is interrupted
*/
@Override
diff --git a/src/main/java/org/apache/commons/pool2/impl/PoolImplUtils.java
b/src/main/java/org/apache/commons/pool2/impl/PoolImplUtils.java
index a3442704..abbf60a1 100644
--- a/src/main/java/org/apache/commons/pool2/impl/PoolImplUtils.java
+++ b/src/main/java/org/apache/commons/pool2/impl/PoolImplUtils.java
@@ -38,7 +38,7 @@ final class PoolImplUtils {
* Identifies the concrete type of object that an object factory creates.
*
* @param factoryClass The factory to examine
- * @return the type of object the factory creates
+ * @return The type of object the factory creates
*/
@SuppressWarnings("rawtypes")
static Class<?> getFactoryType(final Class<? extends PooledObjectFactory>
factoryClass) {
@@ -111,7 +111,7 @@ final class PoolImplUtils {
* @param type The interface that defines a generic type.
* @param clazz The class that implements the interface with a concrete
type.
* @param <T> The interface type.
- * @return the matching parameterized type or null.
+ * @return The matching parameterized type or null.
*/
private static <T> ParameterizedType getParameterizedType(final Class<T>
type, final Class<? extends T> clazz) {
for (final Type iface : clazz.getGenericInterfaces()) {
@@ -159,7 +159,7 @@ final class PoolImplUtils {
*
* @param a an argument.
* @param b another argument.
- * @return the larger of {@code a} and {@code b}.
+ * @return The larger of {@code a} and {@code b}.
*/
static Instant max(final Instant a, final Instant b) {
return a.compareTo(b) > 0 ? a : b;
@@ -171,7 +171,7 @@ final class PoolImplUtils {
*
* @param a an argument.
* @param b another argument.
- * @return the smaller of {@code a} and {@code b}.
+ * @return The smaller of {@code a} and {@code b}.
*/
static Instant min(final Instant a, final Instant b) {
return a.compareTo(b) < 0 ? a : b;
diff --git
a/src/main/java/org/apache/commons/pool2/impl/SoftReferenceObjectPool.java
b/src/main/java/org/apache/commons/pool2/impl/SoftReferenceObjectPool.java
index 1ae3adba..452ccdc6 100644
--- a/src/main/java/org/apache/commons/pool2/impl/SoftReferenceObjectPool.java
+++ b/src/main/java/org/apache/commons/pool2/impl/SoftReferenceObjectPool.java
@@ -296,7 +296,7 @@ public class SoftReferenceObjectPool<T> extends
BaseObjectPool<T> {
* Gets the {@link PooledObjectFactory} used by this pool to create and
* manage object instances.
*
- * @return the factory
+ * @return The factory
*/
public synchronized PooledObjectFactory<T> getFactory() {
return factory;
@@ -305,7 +305,7 @@ public class SoftReferenceObjectPool<T> extends
BaseObjectPool<T> {
/**
* Gets the number of instances currently borrowed from this pool.
*
- * @return the number of instances currently borrowed from this pool
+ * @return The number of instances currently borrowed from this pool
*/
@Override
public synchronized int getNumActive() {
diff --git a/src/main/java/org/apache/commons/pool2/proxy/BaseProxyHandler.java
b/src/main/java/org/apache/commons/pool2/proxy/BaseProxyHandler.java
index a7a488f0..acf97b48 100644
--- a/src/main/java/org/apache/commons/pool2/proxy/BaseProxyHandler.java
+++ b/src/main/java/org/apache/commons/pool2/proxy/BaseProxyHandler.java
@@ -50,7 +50,7 @@ class BaseProxyHandler<T> {
* the pool. Further use of the wrapper should result in an
* {@link IllegalStateException}.
*
- * @return the object that this proxy was wrapping
+ * @return The object that this proxy was wrapping
*/
T disableProxy() {
final T result = pooledObject;
@@ -78,7 +78,7 @@ class BaseProxyHandler<T> {
/**
* Gets the wrapped, pooled object.
*
- * @return the underlying pooled object
+ * @return The underlying pooled object
*/
T getPooledObject() {
return pooledObject;
diff --git a/src/main/java/org/apache/commons/pool2/proxy/ProxySource.java
b/src/main/java/org/apache/commons/pool2/proxy/ProxySource.java
index ef6b23bc..29af27ab 100644
--- a/src/main/java/org/apache/commons/pool2/proxy/ProxySource.java
+++ b/src/main/java/org/apache/commons/pool2/proxy/ProxySource.java
@@ -35,7 +35,7 @@ interface ProxySource<T> {
* be provided with usage tracking information for
this
* wrapped object
*
- * @return the new proxy object
+ * @return The new proxy object
*/
T createProxy(T pooledObject, UsageTracking<T> usageTracking);
diff --git
a/src/test/java/org/apache/commons/pool2/AbstractTestKeyedObjectPool.java
b/src/test/java/org/apache/commons/pool2/AbstractTestKeyedObjectPool.java
index c2762dc5..abe2a837 100644
--- a/src/test/java/org/apache/commons/pool2/AbstractTestKeyedObjectPool.java
+++ b/src/test/java/org/apache/commons/pool2/AbstractTestKeyedObjectPool.java
@@ -194,7 +194,7 @@ public abstract class AbstractTestKeyedObjectPool {
*
* @param key Key for the object to be obtained
* @param n index of the object to be obtained
- * @return the requested object
+ * @return The requested object
*/
protected abstract Object getNthObject(Object key, int n);
@@ -211,7 +211,7 @@ public abstract class AbstractTestKeyedObjectPool {
*
* @param <E> The exception type.
* @param minCapacity Minimum capacity of the pool to create
- * @return the newly created keyed object pool
+ * @return The newly created keyed object pool
*/
protected abstract <E extends Exception> KeyedObjectPool<Object, Object>
makeEmptyPool(int minCapacity);
diff --git a/src/test/java/org/apache/commons/pool2/AbstractTestObjectPool.java
b/src/test/java/org/apache/commons/pool2/AbstractTestObjectPool.java
index 1dd228b5..06cafd83 100644
--- a/src/test/java/org/apache/commons/pool2/AbstractTestObjectPool.java
+++ b/src/test/java/org/apache/commons/pool2/AbstractTestObjectPool.java
@@ -63,7 +63,7 @@ public abstract class AbstractTestObjectPool {
*
* @param <E> The exception type throws by the pool
* @param factory The factory to be used by the object pool
- * @return the newly created empty pool
+ * @return The newly created empty pool
* @throws UnsupportedOperationException if the pool being tested does not
* follow pool contracts.
*/
diff --git a/src/test/java/org/apache/commons/pool2/TestBaseObjectPool.java
b/src/test/java/org/apache/commons/pool2/TestBaseObjectPool.java
index 277b5351..ad2c57bf 100644
--- a/src/test/java/org/apache/commons/pool2/TestBaseObjectPool.java
+++ b/src/test/java/org/apache/commons/pool2/TestBaseObjectPool.java
@@ -47,7 +47,7 @@ public class TestBaseObjectPool extends
AbstractTestObjectPool {
/**
* @param n Ignored by this implemented. Used by sub-classes.
- * @return the Nth object (zero indexed)
+ * @return The Nth object (zero indexed)
*/
protected Object getNthObject(final int n) {
if (this.getClass() != TestBaseObjectPool.class) {
diff --git a/src/test/java/org/apache/commons/pool2/WaiterFactory.java
b/src/test/java/org/apache/commons/pool2/WaiterFactory.java
index eab1c516..2ccef057 100644
--- a/src/test/java/org/apache/commons/pool2/WaiterFactory.java
+++ b/src/test/java/org/apache/commons/pool2/WaiterFactory.java
@@ -133,7 +133,7 @@ public class WaiterFactory<K> implements
PooledObjectFactory<Waiter>, KeyedPoole
}
/**
- * @return the maxActive
+ * @return The maxActive
*/
public synchronized long getMaxActive() {
return maxActive;
