一、 XXXObjectPoolFactory
这些类用来生成相应的XXXObjectPool,比如GenericKeyedObjectPoolFactory:这个类用来生成一个新的GenericKeyedObjectPool对象。它实际的作用只是保存创建一个GenericKeyedObjectPool对象所需要的配置参数。如果使用默认的配置参数生成一个GenericKeyedObjectPool对象,那么可以调用GenericKeyedObjectPoolFactory(KeyedPoolableObjectFactory factory, GenericKeyedObjectPool.Config config),其中Config类里保存所有的缺省配置参数。
二、GenericKeyedObjectPool
通过_poolMap来管理相应的对象链,key作为寻找不同对象链的线索。也就是说,一个GenericKeyedObjectPool中可以管理多个不同key的对象集合,每个集合通过_activeMap用来保存各个不同的Key当前的活动对象的数量(闲置对象的数量可以直接通过相应的CursorableLinkedList的size来获取),可以通过getNumActive(Object key)和getNumIdle(Object key)方法获取这
两个值。这个对象集合通过CursorableLinkedList来管理。
这个类里的_maxIdle和_maxActive属性是针对单个key对应的CursorableLinkedList而言的最大值,而_maxTotal属性则是对所有的key表示的对象集合的总和的最大值。_totalActive+_totalIdle用来和_maxTotal的值进行对比,它们可以通过getNumActive()和getNumIdle()获取。_poolList存放的值与 _poolMap 中的key值一样,注意这个对象不是没有用处的,因为CursorableLinkedList是一个允许多个线程同步迭代的类。
1、几个内置的static类型的变量:
WHEN_EXHAUSTED_FAIL 这个属性表明当对象池已经用尽时(比如说池中的对象数目已经达到了最大值),borrowObject方法应该立刻抛出NoSuchElementException异常。
WHEN_EXHAUSTED_BLOCK 这个属性表明当对象池已经用尽时(比如说池中的对象数目已经达到了最大值),borrowObject方法应该等待,直到对象池中有一个对象可以让它返回,或者达到了最大等待时间(DEFAULT_MAX_WAIT)。
WHEN_EXHAUSTED_GROW 这个属性表明即使在对象池已经用尽时(比如说池中的对象数目已经达到了最大值),borrowObject方法应该仍旧返回一个对象。
DEFAULT_WHEN_EXHAUSTED_ACTION 这个属性表明当对象池用尽的时候(比如说池中的对象数目已经达到了最大值)应该采取上面的那种策略。
DEFAULT_MAX_IDLE 和 DEFAULT_MAX_ACTIVE分别指定了在池中对大的空闲和活动对象的数目。DEFAULT_MAX_TOTAL表明对象池允许存在的最大对象数量。
2、CursorableLinkedList
它实际是一个双向列表,与LinkedList的区别是:它允许多个线程执行迭代。它的实现思路是:在每次生成一个Cursor时:CursorableLinkedList.Cursor cursor(int i),都会吧这个新生成的Cursor对象包装到一个 WeakReference 中:_cursors.add( new WeakReference(cur) );在不需要的的时候需要调用Cursor. close()方法取消注册。而Cursor实际是一个以内嵌类的方式的实现了ListIterator接口的类。WeakReference 不会增加被其包装的类的引用次数,换句话说,它不会影响JVM的垃圾收集。
3、borrowObject(Object key)
这个方法用来从相应的key表示的对象集合中取出一个对象。如果对应的对象集合不存在,会创建一个这样的集合。如果集合当前没有闲置的对象可以返回,并且当前的active < _maxActive && totalActive + _totalIdle < _maxTotal,那么通过KeyedPoolableObjectFactory创建一个新的对象;否则就根据_whenExhaustedAction的设定执行相应的操作。要注意每次都会执行_factory.activateObject(key,pair.value)方法初始化这个对象。在返回这个对象之前,如果设定了_testOnBorrow标志则调用_factory.validateObject(Object key, Object obj)方法,如果不符合要求会抛出NoSuchElementException异常,否则返回这个对象。
4、returnObject(Object key, Object obj)
这个方法用来把一个对象返回给key表示的对象集合,这个方法的执行过程与borrowObject(Object key)方法相似。它会根据_testOnReturn标志执行_factory.validateObject(Object key, Object obj)方法检查返回的对象是否合格。要注意每次都会执行 _factory.passivateObject(key, obj)方法“消除”这个对象。
5、过期类的回收:
Evictor 为一个内嵌类,实现自Runnable接口。它每过_timeBetweenEvictionRunsMillis毫秒会调用一次evict()方法,在后台收集垃圾寿命超过_minEvictableIdleTimeMillis毫秒的对象。每当我们创建一个GenericKeyedObjectPool对象的时候,这个类会被自动创建,并且被启动。evict() 方法很简单,它首先创建一个_evictionKeyCursor = _poolList.cursor()对象,然后根据key遍历每一个对象集合。
查找到过期的就会删除。
三、SoftReferenceObjectPool
通过SoftReference进行对象的保存,这个SoftReference的好处是你不需要自己进行收集,它会在JVM的内存用尽时被自动回收。这种对象池的特色是:
a、可以保存任意多个对象,不会有容量已满的情况发生。
b、在对象池已空的时候,调用它的borrowObject方法,会自动返回新创建的实例。
c、可以在初始化同时,在池内预先创建一定量的对象。
d、当内存不足的时候,池中的对象可以被Java虚拟机回收。
四、StackObjectPool 和 StackKeyedObjectPool
通过一个Stack对对象进行管理,要注意这个Stack是继承自Vector对象的。因此虽然线程安全,但是效率较低。这种对象池的特色是:
a、可以为对象池指定一个初始的参考大小(当空间不够时会自动增长)。
b、在对象池已空的时候,调用它的borrowObject方法,会自动返回新创建的实例。
c、可以为对象池指定一个可保存的对象数目的上限。达到这个上限之后,再向池里送回的对象会被自动送去回收。
五、PoolableObjectFactory
Pool组件利用PoolableObjectFactory来照看被池化的对象。ObjectPool的实例在需要处理被池化的对象的产生、激活、挂起、校验和销毁工作时,就会调用跟它关联在一起的PoolableObjectFactory实例的相应方法来操作。 用户需要自己实现这个接口。
这些类用来生成相应的XXXObjectPool,比如GenericKeyedObjectPoolFactory:这个类用来生成一个新的GenericKeyedObjectPool对象。它实际的作用只是保存创建一个GenericKeyedObjectPool对象所需要的配置参数。如果使用默认的配置参数生成一个GenericKeyedObjectPool对象,那么可以调用GenericKeyedObjectPoolFactory(KeyedPoolableObjectFactory factory, GenericKeyedObjectPool.Config config),其中Config类里保存所有的缺省配置参数。
二、GenericKeyedObjectPool
通过_poolMap来管理相应的对象链,key作为寻找不同对象链的线索。也就是说,一个GenericKeyedObjectPool中可以管理多个不同key的对象集合,每个集合通过_activeMap用来保存各个不同的Key当前的活动对象的数量(闲置对象的数量可以直接通过相应的CursorableLinkedList的size来获取),可以通过getNumActive(Object key)和getNumIdle(Object key)方法获取这
两个值。这个对象集合通过CursorableLinkedList来管理。
这个类里的_maxIdle和_maxActive属性是针对单个key对应的CursorableLinkedList而言的最大值,而_maxTotal属性则是对所有的key表示的对象集合的总和的最大值。_totalActive+_totalIdle用来和_maxTotal的值进行对比,它们可以通过getNumActive()和getNumIdle()获取。_poolList存放的值与 _poolMap 中的key值一样,注意这个对象不是没有用处的,因为CursorableLinkedList是一个允许多个线程同步迭代的类。
1、几个内置的static类型的变量:
WHEN_EXHAUSTED_FAIL 这个属性表明当对象池已经用尽时(比如说池中的对象数目已经达到了最大值),borrowObject方法应该立刻抛出NoSuchElementException异常。
WHEN_EXHAUSTED_BLOCK 这个属性表明当对象池已经用尽时(比如说池中的对象数目已经达到了最大值),borrowObject方法应该等待,直到对象池中有一个对象可以让它返回,或者达到了最大等待时间(DEFAULT_MAX_WAIT)。
WHEN_EXHAUSTED_GROW 这个属性表明即使在对象池已经用尽时(比如说池中的对象数目已经达到了最大值),borrowObject方法应该仍旧返回一个对象。
DEFAULT_WHEN_EXHAUSTED_ACTION 这个属性表明当对象池用尽的时候(比如说池中的对象数目已经达到了最大值)应该采取上面的那种策略。
DEFAULT_MAX_IDLE 和 DEFAULT_MAX_ACTIVE分别指定了在池中对大的空闲和活动对象的数目。DEFAULT_MAX_TOTAL表明对象池允许存在的最大对象数量。
2、CursorableLinkedList
它实际是一个双向列表,与LinkedList的区别是:它允许多个线程执行迭代。它的实现思路是:在每次生成一个Cursor时:CursorableLinkedList.Cursor cursor(int i),都会吧这个新生成的Cursor对象包装到一个 WeakReference 中:_cursors.add( new WeakReference(cur) );在不需要的的时候需要调用Cursor. close()方法取消注册。而Cursor实际是一个以内嵌类的方式的实现了ListIterator接口的类。WeakReference 不会增加被其包装的类的引用次数,换句话说,它不会影响JVM的垃圾收集。
3、borrowObject(Object key)
这个方法用来从相应的key表示的对象集合中取出一个对象。如果对应的对象集合不存在,会创建一个这样的集合。如果集合当前没有闲置的对象可以返回,并且当前的active < _maxActive && totalActive + _totalIdle < _maxTotal,那么通过KeyedPoolableObjectFactory创建一个新的对象;否则就根据_whenExhaustedAction的设定执行相应的操作。要注意每次都会执行_factory.activateObject(key,pair.value)方法初始化这个对象。在返回这个对象之前,如果设定了_testOnBorrow标志则调用_factory.validateObject(Object key, Object obj)方法,如果不符合要求会抛出NoSuchElementException异常,否则返回这个对象。
4、returnObject(Object key, Object obj)
这个方法用来把一个对象返回给key表示的对象集合,这个方法的执行过程与borrowObject(Object key)方法相似。它会根据_testOnReturn标志执行_factory.validateObject(Object key, Object obj)方法检查返回的对象是否合格。要注意每次都会执行 _factory.passivateObject(key, obj)方法“消除”这个对象。
5、过期类的回收:
Evictor 为一个内嵌类,实现自Runnable接口。它每过_timeBetweenEvictionRunsMillis毫秒会调用一次evict()方法,在后台收集垃圾寿命超过_minEvictableIdleTimeMillis毫秒的对象。每当我们创建一个GenericKeyedObjectPool对象的时候,这个类会被自动创建,并且被启动。evict() 方法很简单,它首先创建一个_evictionKeyCursor = _poolList.cursor()对象,然后根据key遍历每一个对象集合。
查找到过期的就会删除。
三、SoftReferenceObjectPool
通过SoftReference进行对象的保存,这个SoftReference的好处是你不需要自己进行收集,它会在JVM的内存用尽时被自动回收。这种对象池的特色是:
a、可以保存任意多个对象,不会有容量已满的情况发生。
b、在对象池已空的时候,调用它的borrowObject方法,会自动返回新创建的实例。
c、可以在初始化同时,在池内预先创建一定量的对象。
d、当内存不足的时候,池中的对象可以被Java虚拟机回收。
四、StackObjectPool 和 StackKeyedObjectPool
通过一个Stack对对象进行管理,要注意这个Stack是继承自Vector对象的。因此虽然线程安全,但是效率较低。这种对象池的特色是:
a、可以为对象池指定一个初始的参考大小(当空间不够时会自动增长)。
b、在对象池已空的时候,调用它的borrowObject方法,会自动返回新创建的实例。
c、可以为对象池指定一个可保存的对象数目的上限。达到这个上限之后,再向池里送回的对象会被自动送去回收。
五、PoolableObjectFactory
Pool组件利用PoolableObjectFactory来照看被池化的对象。ObjectPool的实例在需要处理被池化的对象的产生、激活、挂起、校验和销毁工作时,就会调用跟它关联在一起的PoolableObjectFactory实例的相应方法来操作。 用户需要自己实现这个接口。