org.springframework.aop.target
Class CommonsPoolTargetSource

java.lang.Object
  org.springframework.aop.target.AbstractPrototypeBasedTargetSource
      org.springframework.aop.target.AbstractPoolingTargetSource
          org.springframework.aop.target.CommonsPoolTargetSource

All Implemented Interfaces:

BeanFactoryAware, DisposableBean, InitializingBean, org.apache.commons.pool.PoolableObjectFactory, PoolingConfig, java.io.Serializable, TargetSource

public class CommonsPoolTargetSource

extends AbstractPoolingTargetSource

implements org.apache.commons.pool.PoolableObjectFactory

Jakarta Commons pooling implementation extending AbstractPoolingTargetSource.

Author:

Rod Johnson

See Also:

Serialized Form

Field Summary

Fields inherited from class org.springframework.aop.target.AbstractPrototypeBasedTargetSource

logger

Constructor Summary

CommonsPoolTargetSource()

Method Summary

void	activateObject(java.lang.Object o)
protected org.apache.commons.pool.ObjectPool	createObjectPool() Subclasses can override this if they want to return a different Commons pool to GenericObject pool.
protected void	createPool(BeanFactory beanFactory) Create the pool.
void	destroy() Invoked by a BeanFactory on destruction of a singleton.
void	destroyObject(java.lang.Object o)
int	getActive() Deprecated. in favor of getActiveCount
int	getActiveCount() Return the number of active objects in the pool.
int	getFree() Deprecated. in favor of getIdleCount
int	getIdleCount() Return the number of idle objects in the pool.
java.lang.Object	getTarget() Acquire an object from the pool.
java.lang.Object	makeObject()
void	passivateObject(java.lang.Object o)
void	releaseTarget(java.lang.Object target) Return the given object to the pool.
boolean	validateObject(java.lang.Object o)

Methods inherited from class org.springframework.aop.target.AbstractPoolingTargetSource

getMaxSize, getPoolingConfigMixin, setBeanFactory, setMaxSize

Methods inherited from class org.springframework.aop.target.AbstractPrototypeBasedTargetSource

afterPropertiesSet, getTargetBeanName, getTargetClass, isStatic, newPrototypeInstance, setTargetBeanName, writeReplace

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CommonsPoolTargetSource

public CommonsPoolTargetSource()

Method Detail

createPool

protected final void createPool(BeanFactory beanFactory)

Description copied from class: AbstractPoolingTargetSource

Create the pool.

Specified by:

createPool in class AbstractPoolingTargetSource

Parameters:

beanFactory - owning BeanFactory, in case we need collaborators from it (normally our own properties are sufficient)

createObjectPool

protected org.apache.commons.pool.ObjectPool createObjectPool()

Subclasses can override this if they want to return a different Commons pool to GenericObject pool. They should apply properties to the pool here.

Returns:

an empty Commons pool

getTarget

public java.lang.Object getTarget()
                           throws java.lang.Exception

Description copied from class: AbstractPoolingTargetSource

Acquire an object from the pool.

Specified by:

getTarget in interface TargetSource

Specified by:

getTarget in class AbstractPoolingTargetSource

Returns:

an object from the pool

Throws:

java.lang.Exception - we may need to deal with checked exceptions from pool APIs, so we're forgiving with our exception signature

releaseTarget

public void releaseTarget(java.lang.Object target)
                   throws java.lang.Exception

Description copied from class: AbstractPoolingTargetSource

Return the given object to the pool.

Specified by:

releaseTarget in interface TargetSource

Specified by:

releaseTarget in class AbstractPoolingTargetSource

Parameters:

target - object that must have been acquired from the pool via a call to getTarget()

Throws:

java.lang.Exception - to allow pooling APIs to throw exception

See Also:

AbstractPoolingTargetSource.getTarget()

getActiveCount

public int getActiveCount()
                   throws java.lang.UnsupportedOperationException

Description copied from interface: PoolingConfig

Return the number of active objects in the pool.

Specified by:

getActiveCount in interface PoolingConfig

Throws:

java.lang.UnsupportedOperationException - if not supported by the pool

getIdleCount

public int getIdleCount()
                 throws java.lang.UnsupportedOperationException

Description copied from interface: PoolingConfig

Return the number of idle objects in the pool.

Specified by:

getIdleCount in interface PoolingConfig

Throws:

java.lang.UnsupportedOperationException - if not supported by the pool

getActive

public int getActive()

Deprecated. in favor of getActiveCount

Specified by:

getActive in interface PoolingConfig

See Also:

getActiveCount()

getFree

public int getFree()

Deprecated. in favor of getIdleCount

Specified by:

getFree in interface PoolingConfig

See Also:

getIdleCount()

destroy

public void destroy()
             throws java.lang.Exception

Description copied from interface: DisposableBean

Invoked by a BeanFactory on destruction of a singleton.

Specified by:

destroy in interface DisposableBean

Throws:

java.lang.Exception - in case of shutdown errors. Exceptions will get logged but not rethrown to allow other beans to release their resources too.

makeObject

public java.lang.Object makeObject()

Specified by:

makeObject in interface org.apache.commons.pool.PoolableObjectFactory

destroyObject

public void destroyObject(java.lang.Object o)
                   throws java.lang.Exception

Specified by:

destroyObject in interface org.apache.commons.pool.PoolableObjectFactory

Throws:

java.lang.Exception

validateObject

public boolean validateObject(java.lang.Object o)

Specified by:

validateObject in interface org.apache.commons.pool.PoolableObjectFactory

activateObject

public void activateObject(java.lang.Object o)
                    throws java.lang.Exception

Specified by:

activateObject in interface org.apache.commons.pool.PoolableObjectFactory

Throws:

java.lang.Exception

passivateObject

public void passivateObject(java.lang.Object o)
                     throws java.lang.Exception

Specified by:

passivateObject in interface org.apache.commons.pool.PoolableObjectFactory

Throws:

java.lang.Exception