apache commons-pool的配置参数_JAVA_编程开发_程序员俱乐部

中国优秀的程序员网站程序员频道CXYCLUB技术地图
热搜:
更多>>
 
您所在的位置: 程序员俱乐部 > 编程开发 > JAVA > apache commons-pool的配置参数

apache commons-pool的配置参数

 2014/5/21 13:10:04  jybzjf  程序员俱乐部  我要评论(0)
  • 摘要:apachecommons-pool的配置参数writebyyinmingjun,引用请注明。最近在研究jedis,jedis的对象池是借助于apache的commons-pool实现的,发现关于commons-pool的文档真的很少,也许是大家都觉得commons-pool足够简单吧,不需要一个文档来描述。看了一下commons-pool的代码,写的真的很好,在java社区总是有这么一些人,在做无私的奉献,很佩服。在空闲之余,写一下commons-pool的配置说明
  • 标签:配置 Apache

class="title content-title">apache commons-pool的配置参数

write by yinmingjun,引用请注明。

?

最近在研究jedis,jedis的对象池是借助于apache的commons-pool实现的,发现关于commons-pool的文档真的很少,也许是大家都觉得commons-pool足够简单吧,不需要一个文档来描述。

?

看 了一下commons-pool的代码,写的真的很好,在java社区总是有这么一些人,在做无私的奉献,很佩服。在空闲之余,写一下commons- pool的配置说明,帮助那些只是希望简单理解或使用commons-pool的同学,知道如何配置commons-pool。

?

本文基于apache commons-pool-1.5.5。

?

对pool的配置一般是通过org.apache.commons.pool.impl.GenericObjectPool.Config来完成,这是个简单的数值对象,每个成员都预设了默认值,这里我们详细的介绍一下里面的各个成员的含义。

?

maxActive

控制池中对象的最大数量。

默认值是8,如果是负值表示没限制

?

maxIdle

控制池中空闲的对象的最大数量。

默认值是8,如果是负值表示没限制。

?

minIdle

控制池中空闲的对象的最小数量。

默认值是0

?

whenExhaustedAction

指定池中对象被消耗完以后的行为,有下面这些选择:

  • WHEN_EXHAUSTED_FAIL????????????????? 0

  • WHEN_EXHAUSTED_GROW???????????? 2

  • WHEN_EXHAUSTED_BLOCK???????????? 1

?

如果是WHEN_EXHAUSTED_FAIL,当池中对象达到上限以后,继续borrowObject会抛出NoSuchElementException异常

如果是WHEN_EXHAUSTED_GROW,当池中对象达到上限以后,会创建一个新对象,并返回它。

如果是WHEN_EXHAUSTED_BLOCK,当池中对象达到上限以后,会一直等待,直到有一个对象可用。这个行为还与maxWait有关,如果maxWait是正数,那么会等待maxWait的毫秒的时间,超时会抛出NoSuchElementException异常;如果maxWait为负值,会永久等待。

?

whenExhaustedAction 的默认值是WHEN_EXHAUSTED_BLOCKmaxWait的默认值是-1

?

maxWait

whenExhaustedAction 如果是WHEN_EXHAUSTED_BLOCK,指定等待的毫秒数。如果maxWait是正数,那么会等待maxWait的毫秒的时间,超时会抛出NoSuchElementException异常;如果maxWait为负值,会永久等待。

maxWait的默认值是-1

?

testOnBorrow

如果testOnBorrow被设置,pool会在borrowObject返回对象之前使用PoolableObjectFactoryvalidateObject来验证这个对象是否有效,要是对象没通过验证,这个对象会被丢弃,然后重新选择一个新的对象。

?

testOnBorrow的默认值是false

?

testOnReturn

如果testOnReturn被设置,pool会在returnObject的时候通过PoolableObjectFactoryvalidateObject方法验证对象,如果对象没通过验证,对象会被丢弃,不会被放到池中。

?

testOnReturn的默认值是false

?

testWhileIdle

指定idle对象是否应该使用PoolableObjectFactoryvalidateObject校验,如果校验失败,这个对象会从对象池中被清除。

这个设置仅在timeBetweenEvictionRunsMillis被设置成正值(>0)的时候才会生效。

testWhileIdle的默认值是false

?

timeBetweenEvictionRunsMillis

指定驱逐线程的休眠时间。如果这个值不是正数(>0),不会有驱逐线程运行。

timeBetweenEvictionRunsMillis的默认值是-1

?

numTestsPerEvictionRun

设置驱逐线程每次检测对象的数量。

这个设置仅在timeBetweenEvictionRunsMillis被设置成正值(>0)的时候才会生效。

numTestsPerEvictionRun的默认值是3

?

minEvictableIdleTimeMillis

指定最小的空闲驱逐的时间间隔(空闲超过指定的时间的对象,会被清除掉)。

这个设置仅在timeBetweenEvictionRunsMillis被设置成正值(>0)的时候才会生效。

minEvictableIdleTimeMillis默认值是30分钟。

?

softMinEvictableIdleTimeMillis

minEvictableIdleTimeMillis类似,也是指定最小的空闲驱逐的时间间隔(空闲超过指定的时间的对象,会被清除掉),不过会参考minIdle的值,只有idle对象的数量超过minIdle的值,对象才会被清除。

这个设置仅在timeBetweenEvictionRunsMillis被设置成正值(>0)的时候才会生效,并且这个配置能被minEvictableIdleTimeMillis配置取代(minEvictableIdleTimeMillis配置项的优先级更高)。

softMinEvictableIdleTimeMillis的默认值是-1

?

lifo

pool可以被配置成LIFO队列last-in-first-out)或FIFO队列(first-in-first-out),来指定空闲对象被使用的次序。

lifo的默认值是true

发表评论
用户名: 匿名