jedis api

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

使用說明：

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

代碼說明：

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

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

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

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

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

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

whenExhaustedAction：表示當pool中的jedis實例都被allocated完時，pool要采取的操作；默認有三種。
WHEN_EXHAUSTED_FAIL --> 表示無jedis實例時，直接拋出NoSuchElementException；
WHEN_EXHAUSTED_BLOCK --> 則表示阻塞住，或者達到maxWait時拋出JedisConnectionException；
WHEN_EXHAUSTED_GROW --> 則表示新建一個jedis實例，也就說設置的maxActive無用；

maxWait：表示當borrow一個jedis實例時，最大的等待時間，如果超過等待時間，則直接拋出JedisConnectionException；

testOnBorrow：在borrow一個jedis實例時，是否提前進行alidate操作；如果為true，則得到的jedis實例均是可用的；

testOnReturn：在return給pool時，是否提前進行validate操作；

testWhileIdle：如果為true，表示有一個idle object evitor線程對idle object進行掃描，如果validate失敗，此object會被從pool中drop掉；這一項只有在timeBetweenEvictionRunsMillis大于0時才有意義；

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

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

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

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

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

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