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

你可能感兴趣的:(Redis)