所需jar:jedis-2.1.0.jar和commons-pool-1.5.4.jar
Jedis操作步驟如下:
1->獲取Jedis實例需要從JedisPool中獲取;
2->用完Jedis實例需要返還給JedisPool;
3->如果Jedis在使用過程中出錯,則也需要還給JedisPool;
代碼如下:
package com.ljq.utils;import redis.clients.jedis.Jedis;import redis.clients.jedis.JedisPool;import redis.clients.jedis.JedisPoolConfig;/** * Redis操作接口 * * @author * @version 1.0 2013-6-14 上午08:54:14 */public class RedisAPI { private static JedisPool pool = null; /** * 構建redis連接池 * * @param ip * @param port * @return JedisPool */ public static JedisPool getPool() { if (pool == null) { JedisPoolConfig config = new JedisPoolConfig(); //控制一個pool可分配多少個jedis實例,通過pool.getResource()來獲取; //如果賦值爲-1,則表示不限制;如果pool已經分配了maxActive個jedis實例,則此時pool的狀態爲exhausted(耗盡)。 config.setMaxActive(500); //控制一個pool最多有多少個狀態爲idle(空閒的)的jedis實例。 config.setMaxIdle(5); //表示當borrow(引入)一個jedis實例時,最大的等待時間,如果超過等待時間,則直接拋出JedisConnectionException; config.setMaxWait(1000 * 100); //在borrow一個jedis實例時,是否提前進行validate操作;如果爲true,則得到的jedis實例均是可用的; config.setTestOnBorrow(true); pool = new JedisPool(config, "192.168.2.191", 8888); } return pool; } /** * 返還到連接池 * * @param pool * @param redis */ public static void returnResource(JedisPool pool, Jedis redis) { if (redis != null) { pool.returnResource(redis); } } /** * 獲取數據 * * @param key * @return */ public static String get(String key){ String value = null; JedisPool pool = null; Jedis jedis = null; try { pool = getPool(); jedis = pool.getResource(); value = jedis.get(key); } catch (Exception e) { //釋放redis對象 pool.returnBrokenResource(jedis); e.printStackTrace(); } finally { //返還到連接池 returnResource(pool, jedis); } return value; } }
代碼說明:
a、獲取jedis實例時,實際上可能有兩類錯誤。
一類是pool.getReource(),得不到可用的jedis實例;
另一類是jedis.set/get時出錯也會拋出異常;
爲了實現區分,所以根據instance是否爲null來實現,如果爲空就證明instance根本就沒初始化,也就不用return給pool;如果instance不爲null,則證明是需要返還給pool的;
b、在instance出錯時,必須調用returnBrokenResource返還給pool,否則下次通過getResource得到的instance的緩衝區可能還存在數據,出現問題!
-------------------------------------------------
JedisPool的配置參數很大程度上依賴於實際應用需求、軟硬件能力。以前沒用過commons-pool,所以這次花了一整天專門看這些參數的含義。。。JedisPool的配置參數大部分是由JedisPoolConfig的對應項來賦值的。
maxActive:控制一個pool可分配多少個jedis實例,通過pool.getResource()來獲取;如果賦值爲-1,則表示不限制;如果pool已經分配了maxActive個jedis實例,則此時pool的狀態爲exhausted。
maxIdle:控制一個pool最多有多少個狀態爲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的毫秒數;
numTestsPerEvictionRun:表示idle object evitor每次掃描的最多的對象數;
minEvictableIdleTimeMillis:表示一個對象至少停留在idle狀態的最短時間,然後才能被idle object evitor掃描並驅逐;這一項只有在timeBetweenEvictionRunsMillis大於0時纔有意義;
softMinEvictableIdleTimeMillis:在minEvictableIdleTimeMillis基礎上,加入了至少minIdle個對象已經在pool裏面了。如果爲-1,evicted不會根據idle time驅逐任何對象。如果minEvictableIdleTimeMillis>0,則此項設置無意義,且只有在timeBetweenEvictionRunsMillis大於0時纔有意義;
lifo:borrowObject返回對象時,是採用DEFAULT_LIFO(last in first out,即類似cache的最頻繁使用隊列),如果爲False,則表示FIFO隊列;
其中JedisPoolConfig對一些參數的默認設置如下:
testWhileIdle=true
minEvictableIdleTimeMills=60000
timeBetweenEvictionRunsMillis=30000
numTestsPerEvictionRun=-1