Author: markt Date: Mon Apr 30 09:27:53 2012 New Revision: 1332135 URL: http://svn.apache.org/viewvc?rev=1332135&view=rev Log: Pull up testOnBorrow and testOnReturn
Modified: commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/BaseGenericObjectPool.java commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/GenericKeyedObjectPool.java commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/GenericObjectPool.java Modified: commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/BaseGenericObjectPool.java URL: http://svn.apache.org/viewvc/commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/BaseGenericObjectPool.java?rev=1332135&r1=1332134&r2=1332135&view=diff ============================================================================== --- commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/BaseGenericObjectPool.java (original) +++ commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/BaseGenericObjectPool.java Mon Apr 30 09:27:53 2012 @@ -58,6 +58,10 @@ public abstract class BaseGenericObjectP GenericObjectPoolConfig.DEFAULT_BLOCK_WHEN_EXHAUSTED; private volatile long maxWaitMillis = GenericKeyedObjectPoolConfig.DEFAULT_MAX_WAIT_MILLIS; + private volatile boolean testOnBorrow = + GenericObjectPoolConfig.DEFAULT_TEST_ON_BORROW; + private volatile boolean testOnReturn = + GenericObjectPoolConfig.DEFAULT_TEST_ON_RETURN; // Internal (primarily state) attributes @@ -186,8 +190,68 @@ public abstract class BaseGenericObjectP this.maxWaitMillis = maxWaitMillis; } + /** + * Returns whether objects borrowed from the pool will be validated before + * being returned from the <code>borrowObject()</code> method. Validation is + * performed by the factory associated with the pool. If the object fails to + * validate, it will be dropped from the pool and destroyed, and a new + * attempt will be made to borrow an object from the pool. + * + * @return <code>true</code> if objects are validated before being returned + * from the <code>borrowObject()</code> method + * @see #setTestOnBorrow + */ + public boolean getTestOnBorrow() { + return testOnBorrow; + } + + /** + * Sets whether objects borrowed from the pool will be validated before + * being returned from the <code>borrowObject()</code> method. Validation is + * performed by the factory associated with the pool. If the object fails to + * validate, it will be dropped from the pool and destroyed, and a new + * attempt will be made to borrow an object from the pool. + * + * @param testOnBorrow <code>true</code> if objects should be validated + * before being returned from the + * <code>borrowObject()</code> method + * @see #getTestOnBorrow + */ + public void setTestOnBorrow(boolean testOnBorrow) { + this.testOnBorrow = testOnBorrow; + } /** + * Returns whether objects borrowed from the pool will be validated when + * they are returned to the pool via the <code>returnObject()</code> method. + * Validation is performed by the factory associated with the pool. If the + * object fails to it will be destroyed rather then returned the pool. + * + * @return <code>true</code> if objects are validated on being returned to + * the pool via the <code>returnObject()</code> method + * @see #setTestOnReturn + */ + public boolean getTestOnReturn() { + return testOnReturn; + } + + /** + * Sets whether objects borrowed from the pool will be validated when + * they are returned to the pool via the <code>returnObject()</code> method. + * Validation is performed by the factory associated with the pool. If the + * object fails to it will be destroyed rather then returned the pool. + * + * @param testOnReturn <code>true</code> if objects are validated on being + * returned to the pool via the + * <code>returnObject()</code> method + * @see #getTestOnReturn + */ + public void setTestOnReturn(boolean testOnReturn) { + this.testOnReturn = testOnReturn; + } + + + /** * Closes the pool, destroys the remaining idle objects and, if registered * in JMX, deregisters it. */ Modified: commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/GenericKeyedObjectPool.java URL: http://svn.apache.org/viewvc/commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/GenericKeyedObjectPool.java?rev=1332135&r1=1332134&r2=1332135&view=diff ============================================================================== --- commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/GenericKeyedObjectPool.java (original) +++ commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/GenericKeyedObjectPool.java Mon Apr 30 09:27:53 2012 @@ -366,64 +366,6 @@ public class GenericKeyedObjectPool<K,T> } /** - * When <code>true</code>, objects will be - * {@link org.apache.commons.pool2.PoolableObjectFactory#validateObject validated} - * before being returned by the {@link #borrowObject} - * method. If the object fails to validate, - * it will be dropped from the pool, and we will attempt - * to borrow another. - * - * @return <code>true</code> if objects are validated before being borrowed. - * @see #setTestOnBorrow - */ - @Override - public boolean getTestOnBorrow() { - return testOnBorrow; - } - - /** - * When <code>true</code>, objects will be - * {@link org.apache.commons.pool2.PoolableObjectFactory#validateObject validated} - * before being returned by the {@link #borrowObject} - * method. If the object fails to validate, - * it will be dropped from the pool, and we will attempt - * to borrow another. - * - * @param testOnBorrow whether object should be validated before being returned by borrowObject. - * @see #getTestOnBorrow - */ - public void setTestOnBorrow(boolean testOnBorrow) { - this.testOnBorrow = testOnBorrow; - } - - /** - * When <code>true</code>, objects will be - * {@link org.apache.commons.pool2.PoolableObjectFactory#validateObject validated} - * before being returned to the pool within the - * {@link #returnObject}. - * - * @return <code>true</code> when objects will be validated before being returned. - * @see #setTestOnReturn - */ - @Override - public boolean getTestOnReturn() { - return testOnReturn; - } - - /** - * When <code>true</code>, objects will be - * {@link org.apache.commons.pool2.PoolableObjectFactory#validateObject validated} - * before being returned to the pool within the - * {@link #returnObject}. - * - * @param testOnReturn <code>true</code> so objects will be validated before being returned. - * @see #getTestOnReturn - */ - public void setTestOnReturn(boolean testOnReturn) { - this.testOnReturn = testOnReturn; - } - - /** * Returns the number of milliseconds to sleep between runs of the * idle object evictor thread. * When non-positive, no idle object evictor thread will be @@ -2011,32 +1953,6 @@ public class GenericKeyedObjectPool<K,T> /** * When <code>true</code>, objects will be * {@link org.apache.commons.pool2.PoolableObjectFactory#validateObject validated} - * before being returned by the {@link #borrowObject} - * method. If the object fails to validate, - * it will be dropped from the pool, and we will attempt - * to borrow another. - * - * @see #setTestOnBorrow - * @see #getTestOnBorrow - */ - private volatile boolean testOnBorrow = - GenericKeyedObjectPoolConfig.DEFAULT_TEST_ON_BORROW; - - /** - * When <code>true</code>, objects will be - * {@link org.apache.commons.pool2.PoolableObjectFactory#validateObject validated} - * before being returned to the pool within the - * {@link #returnObject}. - * - * @see #getTestOnReturn - * @see #setTestOnReturn - */ - private volatile boolean testOnReturn = - GenericKeyedObjectPoolConfig.DEFAULT_TEST_ON_RETURN; - - /** - * When <code>true</code>, objects will be - * {@link org.apache.commons.pool2.PoolableObjectFactory#validateObject validated} * by the idle object evictor (if any). If an object * fails to validate, it will be dropped from the pool. * Modified: commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/GenericObjectPool.java URL: http://svn.apache.org/viewvc/commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/GenericObjectPool.java?rev=1332135&r1=1332134&r2=1332135&view=diff ============================================================================== --- commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/GenericObjectPool.java (original) +++ commons/proper/pool/trunk/src/main/java/org/apache/commons/pool2/impl/GenericObjectPool.java Mon Apr 30 09:27:53 2012 @@ -303,65 +303,6 @@ public class GenericObjectPool<T> extend } /** - * When <tt>true</tt>, objects will be - * {@link PoolableObjectFactory#validateObject validated} before being - * returned by the {@link #borrowObject} method. If the object fails to - * validate, it will be dropped from the pool, and we will attempt to borrow - * another. - * - * @return <code>true</code> if objects are validated before being borrowed. - * @see #setTestOnBorrow - */ - @Override - public boolean getTestOnBorrow() { - return testOnBorrow; - } - - /** - * When <tt>true</tt>, objects will be - * {@link PoolableObjectFactory#validateObject validated} before being - * returned by the {@link #borrowObject} method. If the object fails to - * validate, it will be dropped from the pool, and we will attempt to borrow - * another. - * - * @param testOnBorrow - * <code>true</code> if objects should be validated before being - * borrowed. - * @see #getTestOnBorrow - */ - public void setTestOnBorrow(boolean testOnBorrow) { - this.testOnBorrow = testOnBorrow; - } - - /** - * When <tt>true</tt>, objects will be - * {@link PoolableObjectFactory#validateObject validated} before being - * returned to the pool within the {@link #returnObject}. - * - * @return <code>true</code> when objects will be validated after returned - * to {@link #returnObject}. - * @see #setTestOnReturn - */ - @Override - public boolean getTestOnReturn() { - return testOnReturn; - } - - /** - * When <tt>true</tt>, objects will be - * {@link PoolableObjectFactory#validateObject validated} before being - * returned to the pool within the {@link #returnObject}. - * - * @param testOnReturn - * <code>true</code> so objects will be validated after returned - * to {@link #returnObject}. - * @see #getTestOnReturn - */ - public void setTestOnReturn(boolean testOnReturn) { - this.testOnReturn = testOnReturn; - } - - /** * Returns the number of milliseconds to sleep between runs of the idle * object evictor thread. When non-positive, no idle object evictor thread * will be run. @@ -1348,30 +1289,6 @@ public class GenericObjectPool<T> extend /** * When <tt>true</tt>, objects will be - * {@link PoolableObjectFactory#validateObject validated} before being - * returned by the {@link #borrowObject} method. If the object fails to - * validate, it will be dropped from the pool, and we will attempt to borrow - * another. - * - * @see #setTestOnBorrow - * @see #getTestOnBorrow - */ - private volatile boolean testOnBorrow = - GenericObjectPoolConfig.DEFAULT_TEST_ON_BORROW; - - /** - * When <tt>true</tt>, objects will be - * {@link PoolableObjectFactory#validateObject validated} before being - * returned to the pool within the {@link #returnObject}. - * - * @see #getTestOnReturn - * @see #setTestOnReturn - */ - private volatile boolean testOnReturn = - GenericObjectPoolConfig.DEFAULT_TEST_ON_RETURN; - - /** - * When <tt>true</tt>, objects will be * {@link PoolableObjectFactory#validateObject validated} by the idle object * evictor (if any). If an object fails to validate, it will be dropped from * the pool.