struts源代码阅读（Commons－Pool包）

一、 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遍历每一个对象集合。
查找到过期的就会删除。

三、[url=http://www.bt285.cn]SoftReferenceObjectPool
[/url] 通过SoftReference进行对象的保存，这个SoftReference的好处是你不需要自己进行收集，它会在JVM的内存用尽时被自动回收。这种对象池的特色是：
a、可以保存任意多个对象，不会有容量已满的情况发生。

b、在对象池已空的时候，调用它的borrowObject方法，会自动返回新创建的实例。

c、可以在初始化同时，在池内预先创建一定量的对象。

d、当内存不足的时候，池中的对象可以被Java虚拟机回收。

四、StackObjectPool 和 StackKeyedObjectPool
通过一个Stack对对象进行管理，要注意这个Stack是继承自Vector对象的。因此虽然线程安全，但是效率较低。这种对象池的特色是：
a、可以为对象池指定一个初始的参考大小（当空间不够时会自动增长）。

b、在对象池已空的时候，调用它的borrowObject方法，会自动返回新创建的实例。

c、可以为对象池指定一个可保存的对象数目的上限。达到这个上限之后，再向池里送回的对象会被自动送去回收。

五、PoolableObjectFactory
Pool组件利用PoolableObjectFactory来照看被池化的对象。ObjectPool的实例在需要处理被池化的对象的产生、激活、挂起、校验和销毁工作时，就会调用跟它关联在一起的PoolableObjectFactory实例的相应方法来操作。 用户需要自己实现这个接口。

呵呵.N年前的东西,从MSN space 转过来了.