jedis api

Jides是redis的java版本的客戶端實(shí)現(xiàn)，當(dāng)有大批量需要處理的時(shí)候，可以一次性完成。主要包括常用的列表(list)、集合(set)、有序集合(sorted set)、哈希表(hash)等數(shù)據(jù)結(jié)構(gòu)，以及其他特性支持。

使用說(shuō)明：

Jedis操作步驟如下：
1->獲取Jedis實(shí)例需要從JedisPool中獲��；
2->用完Jedis實(shí)例需要返還給JedisPool；
3->如果Jedis在使用過(guò)程中出錯(cuò)，則也需要還給JedisPool；

代碼說(shuō)明：

a、獲取jedis實(shí)例時(shí)，實(shí)際上可能有兩類錯(cuò)誤。
一類是pool.getReource()，得不到可用的jedis實(shí)例；
另一類是jedis.set/get時(shí)出錯(cuò)也會(huì)拋出異常；
為了實(shí)現(xiàn)區(qū)分，所以根據(jù)instance是否為null來(lái)實(shí)現(xiàn)，如果為空就證明instance根本就沒初始化，也就不用return給pool；如果instance不為null，則證明是需要返還給pool的；

b、在instance出錯(cuò)時(shí)，必須調(diào)用returnBrokenResource返還給pool，否則下次通過(guò)getResource得到的instance的緩沖區(qū)可能還存在數(shù)據(jù)，出現(xiàn)問(wèn)題！

-------------------------------------------------

JedisPool的配置參數(shù)很大程度上依賴于實(shí)際應(yīng)用需求、軟硬件能力。以前沒用過(guò)commons-pool，所以這次花了一整天專門看這些參數(shù)的含義。。。JedisPool的配置參數(shù)大部分是由JedisPoolConfig的對(duì)應(yīng)項(xiàng)來(lái)賦值的。

maxActive：控制一個(gè)pool可分配多少個(gè)jedis實(shí)例，通過(guò)pool.getResource()來(lái)獲取；如果賦值為-1，則表示不限制；如果pool已經(jīng)分配了maxActive個(gè)jedis實(shí)例，則此時(shí)pool的狀態(tài)為exhausted。

maxIdle：控制一個(gè)pool最多有多少個(gè)狀態(tài)為idle(空閑)的jedis實(shí)例；

whenExhaustedAction：表示當(dāng)pool中的jedis實(shí)例都被allocated完時(shí)，pool要采取的操作；默認(rèn)有三種。
WHEN_EXHAUSTED_FAIL --> 表示無(wú)jedis實(shí)例時(shí)，直接拋出NoSuchElementException；
WHEN_EXHAUSTED_BLOCK --> 則表示阻塞住，或者達(dá)到maxWait時(shí)拋出JedisConnectionException；
WHEN_EXHAUSTED_GROW --> 則表示新建一個(gè)jedis實(shí)例，也就說(shuō)設(shè)置的maxActive無(wú)用；

maxWait：表示當(dāng)borrow一個(gè)jedis實(shí)例時(shí)，最大的等待時(shí)間，如果超過(guò)等待時(shí)間，則直接拋出JedisConnectionException；

testOnBorrow：在borrow一個(gè)jedis實(shí)例時(shí)，是否提前進(jìn)行alidate操作；如果為true，則得到的jedis實(shí)例均是可用的；

testOnReturn：在return給pool時(shí)，是否提前進(jìn)行validate操作；

testWhileIdle：如果為true，表示有一個(gè)idle object evitor線程對(duì)idle object進(jìn)行掃描，如果validate失敗，此object會(huì)被從pool中drop掉；這一項(xiàng)只有在timeBetweenEvictionRunsMillis大于0時(shí)才有意義；

timeBetweenEvictionRunsMillis：表示idle object evitor兩次掃描之間要sleep的毫秒數(shù)；

numTestsPerEvictionRun：表示idle object evitor每次掃描的最多的對(duì)象數(shù)；

minEvictableIdleTimeMillis：表示一個(gè)對(duì)象至少停留在idle狀態(tài)的最短時(shí)間，然后才能被idle object evitor掃描并驅(qū)逐；這一項(xiàng)只有在timeBetweenEvictionRunsMillis大于0時(shí)才有意義；

softMinEvictableIdleTimeMillis：在minEvictableIdleTimeMillis基礎(chǔ)上，加入了至少minIdle個(gè)對(duì)象已經(jīng)在pool里面了。如果為-1，evicted不會(huì)根據(jù)idle time驅(qū)逐任何對(duì)象。如果minEvictableIdleTimeMillis>0，則此項(xiàng)設(shè)置無(wú)意義，且只有在timeBetweenEvictionRunsMillis大于0時(shí)才有意義；

lifo：borrowObject返回對(duì)象時(shí)，是采用DEFAULT_LIFO（last in first out，即類似cache的最頻繁使用隊(duì)列），如果為False，則表示FIFO隊(duì)列；

其中JedisPoolConfig對(duì)一些參數(shù)的默認(rèn)設(shè)置如下：
testWhileIdle=true
minEvictableIdleTimeMills=60000
timeBetweenEvictionRunsMillis=30000
numTestsPerEvictionRun=-1