apache-common-pool2（配置参数详解，以及资源回收，从池中获取资源，将资源返还给池

 

maxTotal  容许建立资源的最大数量，默认值 -1，-1 表明无数量限制（int类型）

blockWhenExhausted 默认值 true ，当资源耗尽时，是否阻塞等待获取资源

maxWaitMillis 获取资源时的等待时间，单位毫秒。当 blockWhenExhausted 配置为 true 时，此值有效。 -1 表明无时间限制，一直阻塞直到有可用的资源。（long类型）

testOnBorrow  默认值 false ，当设置为true时，调用  factory.validateObject() 方法

testOnCreate   默认值 false，当设置为true时，调用  factory.validateObject() 方法

（备注：若是 testOnBorrow 或者 testOnCreate 中有一个 配置 为 true 时，就调用  factory.validateObject() ）

lifo  资源的存取数据结构，默认值 true，true 资源按照栈结构存取，false 资源按照队列结构存取

fairness 当从池中获取资源或者将资源还回池中时 是否使用  java.util.concurrent.locks.ReentrantLock.ReentrantLock 的公平锁机制。 默认值 false， true 使用公平锁，false 不使用公平锁，

timeBetweenEvictionRunsMillis  回收资源线程的执行周期，单位毫秒。默认值 -1 ，-1 表示不启用线程回收资源。（long类型）

evictionPolicyClassName 资源回收策略，  默认值 org.apache.commons.pool2.impl.DefaultEvictionPolicy（String类型）

minEvictableIdleTimeMillis 资源最小空闲时间，  默认值 1800000，单位 毫秒，（long类型 ）

softMinEvictableIdleTimeMillis 软资源最小空闲时间， 默认值 -1 ，单位 毫秒，（long类型 ）

（备注，这个两个参数，在资源回收策略中，会使用到）

maxIdle  最大空闲资源数，默认值 8 （int类型）

minIdle  最小空闲资源数，默认值 0  （int类型 ）

testWhileIdle  默认值 false； 设置为 true 时，当回收策略返回false时，则 调用 factory.activateObject()和factory.validateObject()

testOnReturn 默认值 false； 设置为 true 时，当将资源返还个资源池时候，验证资源的有效性，调用 factory.validateObject()方法，若是无效，则调用 factory.destroyObject()方法

numTestsPerEvictionRun  资源回收线程执行一次回收操做，回收资源的数量。默认值 3， （int类型）。

备注：

当 设置为0时，不回收资源。

设置为 小于0时，回收资源的个数为  (int)Math.ceil( 池中空闲资源个数 / Math.abs(numTestsPerEvictionRun) );

设置为 大于0时，回收资源的个数为  Math.min( numTestsPerEvictionRun,池中空闲的资源个数 );

从池中获取资源的逻辑

1：

     若是 blockWhenExhausted 配置的 为 false，从资源池中获取资源，若是获取不到，则判断当前池中的对象数量是否超过了 maxTotal 设置的数量，若是没有超过，

则经过调用factory.makeObject() 建立对象，并将对象放入池中，执行第2步 。若是超过了，则返回 null，逻辑到此结束。

     若是 blockWhenExhausted 配置的 为 true ，从资源池中获取资源，若是获取不到，则判断当前池中的对象数量是否超过了 maxTotal 设置的数量，若是没有超过，

则经过调用factory.makeObject() 建立对象，并将对象放入池中，执行第2步 。若是超过了，则阻塞等待，若是 MaxWaitMillis 配置的为 -1 则 阻塞等待，直到有可用的资源为止。

若是 maxWaitMillis 配置为 1000 则 阻塞等待 1000毫秒，若是有可用资源，执行第2步，若是没有则返回 null，逻辑到此结束。

2：将资源的状态 修改成 已分配，执行 第 3 步

3：调用 factory.activateObject() 方法，执行 第 4步

4：若是 testOnBorrow 或者 testOnCreate 中有一个 配置 为 true 时，则调用  factory.validateObject() 方法

5：以上步骤都完成了，返回 资源对象

将资源返还给池的逻辑

1：检查配置参数 testOnReturn，若是 为 true，调用 factory.validateObject()方法，验证资源对象的有效性，验证结果为 true，则调用 factory.destroyObject()方法，逻辑到此结束。

     验证结果为 false，则执行第 2 步。

2：调用 factory.passivateObject()方法，而后执行 第 3 步

3：将资源的状态 修改成 未分配，执行第 4 步

4：进行判断 （ 资源池是否关闭 || （maxIdle > -1 ) &&   ( maxIdle <= 资源池空闲资源个数) ）

     若是 判断为 true，则调用 factory.destroyObject()方法，逻辑到此结束。

     若是 判断为 false，则 将资源返还给资源池，逻辑到此结束。

     

Apache_common_pool 启动一个线程执行释放资源的工做（使用 java.util.Timer 实现）

从池中回收资源逻辑（回收资源的意思是，将资源从池中删除掉，例如，若是是TCP连接，则须要将连接断开，并从池中删除掉。）

1：根据 evictionPolicyClassName 配置的参数建立回收策略，

默认回收策略源码

import org.apache.commons.pool2.PooledObject;

public class DefaultEvictionPolicy<T>

  implements EvictionPolicy<T>

{

  public boolean evict(EvictionConfig config, PooledObject<T> underTest, int idleCount)

  {

    if (((config.getIdleSoftEvictTime() < underTest.getIdleTimeMillis()) && (config.getMinIdle() < idleCount)) || (config.getIdleEvictTime() < underTest.getIdleTimeMillis()))

    {

      return true;

    }

    return false;

  }

}

if条件判断与

(softMinEvictableIdleTimeMillis < 资源的空闲时间 && Math.min(maxIdle,minIdle) < 目前池中空闲的资源数) ||

minEvictableIdleTimeMillis < 资源的空闲时间

等价

2：根据配置的参数 numTestsPerEvictionRun 计算，要回收的资源数量（具体的计算规则，请参照源码）

3：根据回收策略判断，资源是否须要回收。若是 是 则将资源从池中删除，并调用factory.destroyObject()方法。

若是 否 则根据配置的 testWhileIdle 参数，判断 是否执行 factory.activateObject()和factory.validateObject() 方法。