java Jedis连接池的使用

所需jar：jedis-2.1.0.jar和commons-pool-1.5.4.jar

Jedis操作步骤如下：
1->获取Jedis实例需要从JedisPool中获取；
2->用完Jedis实例需要返还给JedisPool；
3->如果Jedis在使用过程中出错，则也需要还给JedisPool；

[java]  view plain  copy

 print ?

1. package com.ljq.utils;  
2.   
3. import redis.clients.jedis.Jedis;  
4. import redis.clients.jedis.JedisPool;  
5. import redis.clients.jedis.JedisPoolConfig;  
6.   
7. /**    
8.  * Redis操作接口 
9.  * 
10.  * @author 林计钦 
11.  * @version 1.0 2013-6-14 上午08:54:14    
12.  */  
13. public class RedisAPI {  
14.     private static JedisPool pool = null;  
15.       
16.     /** 
17.      * 构建redis连接池 
18.      *  
19.      * @param ip 
20.      * @param port 
21.      * @return JedisPool 
22.      */  
23.     public static JedisPool getPool() {  
24.         if (pool == null) {  
25.             JedisPoolConfig config = new JedisPoolConfig();  
26.             //控制一个pool可分配多少个jedis实例，通过pool.getResource()来获取；  
27.             //如果赋值为-1，则表示不限制；如果pool已经分配了maxActive个jedis实例，则此时pool的状态为exhausted(耗尽)。  
28.             config.setMaxActive(500);  
29.             //控制一个pool最多有多少个状态为idle(空闲的)的jedis实例。  
30.             config.setMaxIdle(5);  
31.             //表示当borrow(引入)一个jedis实例时，最大的等待时间，如果超过等待时间，则直接抛出JedisConnectionException；  
32.             config.setMaxWait(1000 * 100);  
33.             //在borrow一个jedis实例时，是否提前进行validate操作；如果为true，则得到的jedis实例均是可用的；  
34.             config.setTestOnBorrow(true);  
35.             pool = new JedisPool(config, "192.168.2.191", 8888);  
36.         }  
37.         return pool;  
38.     }  
39.       
40.     /** 
41.      * 返还到连接池 
42.      *  
43.      * @param pool  
44.      * @param redis 
45.      */  
46.     public static void returnResource(JedisPool pool, Jedis redis) {  
47.         if (redis != null) {  
48.             pool.returnResource(redis);  
49.         }  
50.     }  
51.       
52.     /** 
53.      * 获取数据 
54.      *  
55.      * @param key 
56.      * @return 
57.      */  
58.     public static String get(String key){  
59.         String value = null;  
60.           
61.         JedisPool pool = null;  
62.         Jedis jedis = null;  
63.         try {  
64.             pool = getPool();  
65.             jedis = pool.getResource();  
66.             value = jedis.get(key);  
67.         } catch (Exception e) {  
68.             //释放redis对象  
69.             pool.returnBrokenResource(jedis);  
70.             e.printStackTrace();  
71.         } finally {  
72.             //返还到连接池  
73.             returnResource(pool, jedis);  
74.         }  
75.           
76.         return value;  
77.     }  
78. }  

代码说明：
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