Author: markt Date: Mon Oct 14 13:52:05 2013 New Revision: 1531899 URL: http://svn.apache.org/r1531899 Log: Add missing @since 2.0 markers
Modified: commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/SwallowedExceptionListener.java commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/AbandonedConfig.java commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/DefaultPooledObjectInfo.java commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/DefaultPooledObjectInfoMBean.java commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/EvictionTimer.java commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/InterruptibleReentrantLock.java commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/LinkedBlockingDeque.java commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/PoolImplUtils.java commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/BaseProxyHandler.java commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/CglibProxyHandler.java commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/CglibProxySource.java commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/JdkProxyHandler.java commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/JdkProxySource.java commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/ProxiedKeyedObjectPool.java commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/ProxiedObjectPool.java commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/ProxySource.java Modified: commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/SwallowedExceptionListener.java URL: http://svn.apache.org/viewvc/commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/SwallowedExceptionListener.java?rev=1531899&r1=1531898&r2=1531899&view=diff ============================================================================== --- commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/SwallowedExceptionListener.java (original) +++ commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/SwallowedExceptionListener.java Mon Oct 14 13:52:05 2013 @@ -21,6 +21,8 @@ package org.apache.commons.pool2; * of this listener so the user may receive notification of when this happens. * The listener should not throw an exception when called but pools calling * listeners should protect themselves against exceptions anyway. + * + * @since 2.0 */ public interface SwallowedExceptionListener { Modified: commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/AbandonedConfig.java URL: http://svn.apache.org/viewvc/commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/AbandonedConfig.java?rev=1531899&r1=1531898&r2=1531899&view=diff ============================================================================== --- commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/AbandonedConfig.java (original) +++ commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/AbandonedConfig.java Mon Oct 14 13:52:05 2013 @@ -26,6 +26,8 @@ import org.apache.commons.pool2.UsageTra * Configuration settings for abandoned object removal. * * @version $Revision:$ + * + * @since 2.0 */ public class AbandonedConfig { Modified: commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/DefaultPooledObjectInfo.java URL: http://svn.apache.org/viewvc/commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/DefaultPooledObjectInfo.java?rev=1531899&r1=1531898&r2=1531899&view=diff ============================================================================== --- commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/DefaultPooledObjectInfo.java (original) +++ commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/DefaultPooledObjectInfo.java Mon Oct 14 13:52:05 2013 @@ -22,6 +22,9 @@ import java.text.SimpleDateFormat; import org.apache.commons.pool2.PooledObject; +/** + * @since 2.0 + */ public class DefaultPooledObjectInfo implements DefaultPooledObjectInfoMBean { private final PooledObject<?> pooledObject; Modified: commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/DefaultPooledObjectInfoMBean.java URL: http://svn.apache.org/viewvc/commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/DefaultPooledObjectInfoMBean.java?rev=1531899&r1=1531898&r2=1531899&view=diff ============================================================================== --- commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/DefaultPooledObjectInfoMBean.java (original) +++ commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/DefaultPooledObjectInfoMBean.java Mon Oct 14 13:52:05 2013 @@ -16,6 +16,9 @@ */ package org.apache.commons.pool2.impl; +/** + * @since 2.0 + */ public interface DefaultPooledObjectInfoMBean { long getCreateTime(); String getCreateTimeFormatted(); Modified: commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/EvictionTimer.java URL: http://svn.apache.org/viewvc/commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/EvictionTimer.java?rev=1531899&r1=1531898&r2=1531899&view=diff ============================================================================== --- commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/EvictionTimer.java (original) +++ commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/EvictionTimer.java Mon Oct 14 13:52:05 2013 @@ -33,12 +33,14 @@ import java.util.TimerTask; * The class declaration below should *not* be changed to public. * <p> * This class is intended to be thread-safe. + * + * @since 2.0 */ class EvictionTimer { - + /** Timer instance */ private static Timer _timer; //@GuardedBy("this") - + /** Static usage count tracker */ private static int _usageCount; //@GuardedBy("this") @@ -86,13 +88,13 @@ class EvictionTimer { _timer = null; } } - - /** + + /** * {@link PrivilegedAction} used to get the ContextClassLoader */ private static class PrivilegedGetTccl implements PrivilegedAction<ClassLoader> { - /** + /** * {@inheritDoc} */ @Override @@ -101,7 +103,7 @@ class EvictionTimer { } } - /** + /** * {@link PrivilegedAction} used to set the ContextClassLoader */ private static class PrivilegedSetTccl implements PrivilegedAction<Void> { @@ -117,7 +119,7 @@ class EvictionTimer { this.cl = cl; } - /** + /** * {@inheritDoc} */ @Override Modified: commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/InterruptibleReentrantLock.java URL: http://svn.apache.org/viewvc/commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/InterruptibleReentrantLock.java?rev=1531899&r1=1531898&r2=1531899&view=diff ============================================================================== --- commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/InterruptibleReentrantLock.java (original) +++ commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/InterruptibleReentrantLock.java Mon Oct 14 13:52:05 2013 @@ -26,6 +26,8 @@ import java.util.concurrent.locks.Reentr * class is intended for internal use only. * <p> * This class is intended to be thread-safe. + * + * @since 2.0 */ class InterruptibleReentrantLock extends ReentrantLock { @@ -33,7 +35,7 @@ class InterruptibleReentrantLock extends /** * Interrupt the threads that are waiting on a specific condition - * + * * @param condition the condition on which the threads are waiting. */ public void interruptWaiters(Condition condition) { Modified: commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/LinkedBlockingDeque.java URL: http://svn.apache.org/viewvc/commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/LinkedBlockingDeque.java?rev=1531899&r1=1531898&r2=1531899&view=diff ============================================================================== --- commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/LinkedBlockingDeque.java (original) +++ commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/LinkedBlockingDeque.java Mon Oct 14 13:52:05 2013 @@ -55,6 +55,8 @@ import java.util.concurrent.locks.Reentr * * Note: This was copied from Apache Harmony and modified to suit the needs of * Commons Pool. + * + * @since 2.0 */ class LinkedBlockingDeque<E> extends AbstractQueue<E> implements Deque<E>, Serializable { Modified: commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/PoolImplUtils.java URL: http://svn.apache.org/viewvc/commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/PoolImplUtils.java?rev=1531899&r1=1531898&r2=1531899&view=diff ============================================================================== --- commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/PoolImplUtils.java (original) +++ commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/PoolImplUtils.java Mon Oct 14 13:52:05 2013 @@ -24,6 +24,8 @@ import org.apache.commons.pool2.PooledOb /** * Implementation specific utilities. + * + * @since 2.0 */ public class PoolImplUtils { Modified: commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/BaseProxyHandler.java URL: http://svn.apache.org/viewvc/commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/BaseProxyHandler.java?rev=1531899&r1=1531898&r2=1531899&view=diff ============================================================================== --- commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/BaseProxyHandler.java (original) +++ commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/BaseProxyHandler.java Mon Oct 14 13:52:05 2013 @@ -20,6 +20,9 @@ import java.lang.reflect.Method; import org.apache.commons.pool2.UsageTracking; +/** + * @since 2.0 + */ class BaseProxyHandler<T> { private T pooledObject; Modified: commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/CglibProxyHandler.java URL: http://svn.apache.org/viewvc/commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/CglibProxyHandler.java?rev=1531899&r1=1531898&r2=1531899&view=diff ============================================================================== --- commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/CglibProxyHandler.java (original) +++ commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/CglibProxyHandler.java Mon Oct 14 13:52:05 2013 @@ -7,7 +7,9 @@ import org.apache.commons.pool2.UsageTra import net.sf.cglib.proxy.MethodInterceptor; import net.sf.cglib.proxy.MethodProxy; - +/** + * @since 2.0 + */ public class CglibProxyHandler<T> extends BaseProxyHandler<T> implements MethodInterceptor { Modified: commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/CglibProxySource.java URL: http://svn.apache.org/viewvc/commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/CglibProxySource.java?rev=1531899&r1=1531898&r2=1531899&view=diff ============================================================================== --- commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/CglibProxySource.java (original) +++ commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/CglibProxySource.java Mon Oct 14 13:52:05 2013 @@ -21,6 +21,9 @@ import net.sf.cglib.proxy.Factory; import org.apache.commons.pool2.UsageTracking; +/** + * @since 2.0 + */ public class CglibProxySource<T> implements ProxySource<T> { private final Class<? extends T> superclass; Modified: commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/JdkProxyHandler.java URL: http://svn.apache.org/viewvc/commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/JdkProxyHandler.java?rev=1531899&r1=1531898&r2=1531899&view=diff ============================================================================== --- commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/JdkProxyHandler.java (original) +++ commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/JdkProxyHandler.java Mon Oct 14 13:52:05 2013 @@ -21,6 +21,9 @@ import java.lang.reflect.Method; import org.apache.commons.pool2.UsageTracking; +/** + * @since 2.0 + */ class JdkProxyHandler<T> extends BaseProxyHandler<T> implements InvocationHandler { Modified: commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/JdkProxySource.java URL: http://svn.apache.org/viewvc/commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/JdkProxySource.java?rev=1531899&r1=1531898&r2=1531899&view=diff ============================================================================== --- commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/JdkProxySource.java (original) +++ commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/JdkProxySource.java Mon Oct 14 13:52:05 2013 @@ -20,6 +20,9 @@ import java.lang.reflect.Proxy; import org.apache.commons.pool2.UsageTracking; +/** + * @since 2.0 + */ class JdkProxySource<T> implements ProxySource<T> { private final ClassLoader classLoader; Modified: commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/ProxiedKeyedObjectPool.java URL: http://svn.apache.org/viewvc/commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/ProxiedKeyedObjectPool.java?rev=1531899&r1=1531898&r2=1531899&view=diff ============================================================================== --- commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/ProxiedKeyedObjectPool.java (original) +++ commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/ProxiedKeyedObjectPool.java Mon Oct 14 13:52:05 2013 @@ -21,6 +21,9 @@ import java.util.NoSuchElementException; import org.apache.commons.pool2.KeyedObjectPool; import org.apache.commons.pool2.UsageTracking; +/** + * @since 2.0 + */ public class ProxiedKeyedObjectPool<K,V> implements KeyedObjectPool<K,V> { private final KeyedObjectPool<K,V> pool; Modified: commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/ProxiedObjectPool.java URL: http://svn.apache.org/viewvc/commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/ProxiedObjectPool.java?rev=1531899&r1=1531898&r2=1531899&view=diff ============================================================================== --- commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/ProxiedObjectPool.java (original) +++ commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/ProxiedObjectPool.java Mon Oct 14 13:52:05 2013 @@ -21,6 +21,9 @@ import java.util.NoSuchElementException; import org.apache.commons.pool2.ObjectPool; import org.apache.commons.pool2.UsageTracking; +/** + * @since 2.0 + */ public class ProxiedObjectPool<T> implements ObjectPool<T> { private final ObjectPool<T> pool; Modified: commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/ProxySource.java URL: http://svn.apache.org/viewvc/commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/ProxySource.java?rev=1531899&r1=1531898&r2=1531899&view=diff ============================================================================== --- commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/ProxySource.java (original) +++ commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/proxy/ProxySource.java Mon Oct 14 13:52:05 2013 @@ -18,6 +18,9 @@ package org.apache.commons.pool2.proxy; import org.apache.commons.pool2.UsageTracking; +/** + * @since 2.0 + */ interface ProxySource<T> { T createProxy(T pooledObject, UsageTracking<T> usageTracking); T resolveProxy(T proxy);