Package org.springframework.aop.target
Class AbstractPoolingTargetSource
- java.lang.Object
- org.springframework.aop.target.AbstractBeanFactoryBasedTargetSource
- org.springframework.aop.target.AbstractPrototypeBasedTargetSource
- org.springframework.aop.target.AbstractPoolingTargetSource
- All Implemented Interfaces:
Serializable,PoolingConfig,TargetClassAware,TargetSource,Aware,BeanFactoryAware,DisposableBean
- Direct Known Subclasses:
CommonsPool2TargetSource,CommonsPoolTargetSource
public abstract class AbstractPoolingTargetSource extends AbstractPrototypeBasedTargetSource implements PoolingConfig, DisposableBean
Abstract base class for poolingTargetSourceimplementations which maintain a pool of target instances, acquiring and releasing a target object from the pool for each method invocation. This abstract base class is independent of concrete pooling technology; see the subclassCommonsPool2TargetSourcefor a concrete example.Subclasses must implement the
getTarget()andreleaseTarget(java.lang.Object)methods based on their chosen object pool. TheAbstractPrototypeBasedTargetSource.newPrototypeInstance()method inherited fromAbstractPrototypeBasedTargetSourcecan be used to create objects in order to put them into the pool.Subclasses must also implement some of the monitoring methods from the
PoolingConfiginterface. ThegetPoolingConfigMixin()method makes these stats available on proxied objects through an IntroductionAdvisor.This class implements the
DisposableBeaninterface in order to force subclasses to implement aDisposableBean.destroy()method, closing down their object pool.- Author:
- Rod Johnson, Juergen Hoeller
- See Also:
getTarget(),releaseTarget(java.lang.Object),DisposableBean.destroy(), Serialized Form
Field Summary
Fields inherited from class org.springframework.aop.target.AbstractBeanFactoryBasedTargetSource
logger
Constructor Summary
Constructors Constructor Description AbstractPoolingTargetSource()
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description protected abstract voidcreatePool()Create the pool.intgetMaxSize()Return the maximum size of the pool.DefaultIntroductionAdvisorgetPoolingConfigMixin()Return an IntroductionAdvisor that providing a mixin exposing statistics about the pool maintained by this object.abstract ObjectgetTarget()Acquire an object from the pool.abstract voidreleaseTarget(Object target)Return the given object to the pool.voidsetBeanFactory(BeanFactory beanFactory)Set the owning BeanFactory.voidsetMaxSize(int maxSize)Set the maximum size of the pool.Methods inherited from class org.springframework.aop.target.AbstractPrototypeBasedTargetSource
destroyPrototypeInstance, newPrototypeInstance, writeReplace
Methods inherited from class org.springframework.aop.target.AbstractBeanFactoryBasedTargetSource
copyFrom, equals, getBeanFactory, getTargetBeanName, getTargetClass, hashCode, isStatic, setTargetBeanName, setTargetClass, toString
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
Methods inherited from interface org.springframework.beans.factory.DisposableBean
destroy
Methods inherited from interface org.springframework.aop.target.PoolingConfig
getActiveCount, getIdleCount
Constructor Detail
AbstractPoolingTargetSource
public AbstractPoolingTargetSource()
Method Detail
setMaxSize
public void setMaxSize(int maxSize)
Set the maximum size of the pool. Default is -1, indicating no size limit.
getMaxSize
public int getMaxSize()
Return the maximum size of the pool.- Specified by:
getMaxSizein interfacePoolingConfig
setBeanFactory
public final void setBeanFactory(BeanFactory beanFactory) throws BeansException
Description copied from class:AbstractBeanFactoryBasedTargetSourceSet the owning BeanFactory. We need to save a reference so that we can use thegetBeanmethod on every invocation.- Specified by:
setBeanFactoryin interfaceBeanFactoryAware- Overrides:
setBeanFactoryin classAbstractPrototypeBasedTargetSource- Parameters:
beanFactory- owning BeanFactory (nevernull). The bean can immediately call methods on the factory.- Throws:
BeansException- in case of initialization errors- See Also:
BeanInitializationException
createPool
protected abstract void createPool() throws Exception
Create the pool.- Throws:
Exception- to avoid placing constraints on pooling APIs
getTarget
public abstract Object getTarget() throws Exception
Acquire an object from the pool.- Specified by:
getTargetin interfaceTargetSource- Returns:
- an object from the pool
- Throws:
Exception- we may need to deal with checked exceptions from pool APIs, so we're forgiving with our exception signature
releaseTarget
public abstract void releaseTarget(Object target) throws Exception
Return the given object to the pool.- Specified by:
releaseTargetin interfaceTargetSource- Overrides:
releaseTargetin classAbstractBeanFactoryBasedTargetSource- Parameters:
target- object that must have been acquired from the pool via a call togetTarget()- Throws:
Exception- to allow pooling APIs to throw exception- See Also:
getTarget()
getPoolingConfigMixin
public DefaultIntroductionAdvisor getPoolingConfigMixin()
Return an IntroductionAdvisor that providing a mixin exposing statistics about the pool maintained by this object.