You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by ma...@apache.org on 2013/10/14 15:52:05 UTC
svn commit: r1531899 - in
/commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2: ./ impl/
proxy/
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);