Redis客户端Jedis（一）-优快云博客

Redis官方并未提供windows版本，我们可以在github上下载windows版，https://github.com/MSOpenTech/redis/releases

下面是redis.windows.conf

#是否作为守护进程运行
daemonize no
#Redis 默认监听端口
port 6479
#客户端闲置多少秒后，断开连接
timeout 300
#日志显示级别
loglevel verbose
#指定日志输出的文件名，也可指定到标准输出端口
logfile redis.log
#设置数据库的数量，默认最大是16,默认连接的数据库是0，可以通过select N 来连接不同的数据库
databases 32
#Dump持久化策略
#当有一条Keys 数据被改变是，900 秒刷新到disk 一次
#save 900 1
#当有10 条Keys 数据被改变时，300 秒刷新到disk 一次
save 300 100
#当有1w 条keys 数据被改变时，60 秒刷新到disk 一次
save 6000 10000
#当dump     .rdb 数据库的时候是否压缩数据对象
rdbcompression yes
#dump 持久化数据保存的文件名
dbfilename dump.rdb
###########    Replication #####################
#Redis的主从配置,配置slaveof则实例作为从服务器
#slaveof 192.168.0.105 6379
#主服务器连接密码
# masterauth <master-password>
############## 安全性 ###########
#设置连接密码
requirepass admin
############### LIMITS ##############
#最大客户端连接数
# maxclients 128
#最大内存使用率
# maxmemory <bytes>
########## APPEND ONLY MODE #########
#是否开启日志功能
appendonly no
# AOF持久化策略
#appendfsync always
#appendfsync everysec
#appendfsync no
################ VIRTUAL MEMORY ###########
#是否开启VM 功能
#vm-enabled no
# vm-enabled yes
#vm-swap-file logs/redis.swap
#vm-max-memory 0
#vm-page-size 32
#vm-pages 134217728
#vm-max-threads 4

Jedis是Redis的Java客户端，提供了java对于redis的常用操作。

<dependency>
    <groupId>redis.clients</groupId>
    <artifactId>jedis</artifactId>
    <version>2.8.0</version>
</dependency>

import redis.clients.jedis.Jedis;

import java.util.*;

/**
 * Created by shenhongxi on 2016/1/21.
 */
public class RedisTest {

    public static void main(String[] args) {
        Jedis jedis = new Jedis("127.0.0.1", 6479);
        jedis.auth("admin"); // password
        String key = "t";
        jedis.set(key, "javared");
        System.out.println(jedis.get(key));
        jedis.append(key, "&wely");
        System.out.println(jedis.get(key));
        jedis.del(key);
        System.out.println(jedis.get(key));

        Jedis jedis2 = new Jedis("127.0.0.1", 6379);
        jedis2.auth("admin");
        jedis2.set(key, "wely.com");
        System.out.println(jedis2.get(key));

        // 批量插入
        jedis.mset("name", "hongxi", "age", "23", "qq", "1037256085");
        jedis.incr("age");
        System.out.println(jedis.get("name") + "_" + jedis.get("age") + "_" + jedis.get("qq"));

        // map
        Map<String, String> user = new HashMap<String, String>();
        user.put("name", "hongxi");
        user.put("age", "23");
        user.put("qq", "1037256085");
        String hmKey = "user";
        jedis.hmset(hmKey, user);
        List<String> list = jedis.hmget(hmKey, "name", "age", "qq");
        System.out.println(list);
        jedis.hdel(hmKey, "name");
        list = jedis.hmget(hmKey, "name", "age", "qq");
        System.out.println(list);
        System.out.println(jedis.hlen(hmKey));
        System.out.println(jedis.exists(hmKey));
        System.out.println(jedis.hkeys(hmKey));
        System.out.println(jedis.hvals(hmKey));
        Iterator<String> iter=jedis.hkeys("user").iterator();
        while (iter.hasNext()){
            String _key = iter.next();
            System.out.println(_key + ":" + jedis.hmget("user", _key));
        }

        // list
        String listKey = "Java Framework";
        jedis.del(listKey);
        System.out.println(jedis.lrange(listKey, 0, -1));
        jedis.lpush(listKey, "spring");
        jedis.lpush(listKey, "restEasy");
        jedis.lpush(listKey, "mybatis");
        System.out.println(jedis.lrange(listKey, 0, -1));
        jedis.del(listKey);
        jedis.rpush(listKey, "spring");
        jedis.rpush(listKey, "restEasy");
        jedis.rpush(listKey, "mybatis");
        System.out.println(jedis.lrange(listKey, 0, -1));

        // set
        String setKey = "lang";
        Long size = jedis.sadd(setKey, "hongxi", "wely", "norip");
        System.out.println(size);
        jedis.srem(setKey, "norip");
        Set<String> set = jedis.smembers(setKey);
        System.out.println(set);
        System.out.println(jedis.sismember(setKey, "hongxi"));
        System.out.println(jedis.srandmember(setKey));
        System.out.println(jedis.scard(setKey));

        // 排序
        jedis.del("a");
        jedis.rpush("a", "1");
        jedis.lpush("a","6");
        jedis.lpush("a", "3");
        jedis.lpush("a", "9");
        System.out.println(jedis.lrange("a", 0, -1)); // [9, 3, 6, 1]
        System.out.println(jedis.sort("a")); // [1, 3, 6, 9]
        System.out.println(jedis.lrange("a",0,-1)); // [9, 3, 6, 1]
    }
}

Redis连接池

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

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

import redis.clients.jedis.Jedis;
import redis.clients.jedis.JedisPool;
import redis.clients.jedis.JedisPoolConfig;

public class RedisUtils {
    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