apache-common-pool2使用以及(配置参数详解,以及资源回收,从池中获取资源,将资源返还给池)
apache-common-pool2使用以及(配置参数详解,以及资源回收,从池中获取资源,将资源返还给池)
weiliu007 发表于1年前
apache-common-pool2使用以及(配置参数详解,以及资源回收,从池中获取资源,将资源返还给池)
  • 发表于 1年前
  • 阅读 52
  • 收藏 0
  • 点赞 0
  • 评论 0

【腾讯云】新注册用户域名抢购1元起>>>   

使用方式参考http://www.blogways.net/blog/2014/01/15/apache-commons-pool.html

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() 方法。

  • 打赏
  • 点赞
  • 收藏
  • 分享
共有 人打赏支持
粉丝 14
博文 169
码字总数 84766
×
weiliu007
如果觉得我的文章对您有用,请随意打赏。您的支持将鼓励我继续创作!
* 金额(元)
¥1 ¥5 ¥10 ¥20 其他金额
打赏人
留言
* 支付类型
微信扫码支付
打赏金额:
已支付成功
打赏金额: