9.Redis的Java客户端Jedis

Redis的Java客户端Jedis

　　Jedis所需jar包   commons-pool-1.6.jar　　jedis-2.1.0.jar

1.Jedis常用操作（jedis中的api 和 我们在 linux中使用的命令差不多）

　　a）测试连通性

public static void main(String[] args) {
        //连接虚拟机中的 redis 服务（如果是在linux 本机中，即为192.168.89.128）
        //注意：连接之前需要关闭linux防火墙
        Jedis jedis = new Jedis("192.168.89.128",6379);
        
        //查看服务是否运行，打出pong表示OK
        System.out.println(jedis.ping());
}

　　b）1+5  （一个Key  五大数据类型）

//测试 对 key 和 五大数据类型的 操作API
public class TestAPI {
    public static void main(String[] args) {
        
        //jedis中的api 和 我们在 linux中使用的命令差不多
        Jedis jedis = new Jedis("192.168.89.128",6379);
        
        jedis.set("k1", "v1");  //set命令
        jedis.set("k2", "v2");
        jedis.set("k3", "v3");
        
        System.out.println(jedis.get("k3"));//get命令
        
        
        Set<String> keysSet = jedis.keys("*");   //类似于 keys *
        Iterator<String> iterator = keysSet.iterator();
        while(iterator.hasNext()) {
            String key = iterator.next();
            System.out.println(key);
        }
        
        System.out.println("k1 键是否存在 :" + jedis.exists("k1"));  
        System.out.println("k1 键 剩余生存时间:" + jedis.ttl("k1"));    
        
        
    }
    
    @Test
    public void testString() {
        Jedis jedis = new Jedis("192.168.89.128",6379);
        //jedis.append("k1", "v1v1");
        //System.out.println("append后k1的值：" + jedis.get("k1"));
        
        System.out.println("k1 的value的长度：" + jedis.strlen("k1"));
        
        System.out.println("按指定下标取值：" + jedis.getrange("k1", 0, -1));
        //如果不存在 则赋值
        jedis.setnx("k1", "v1");
    }
    
    @Test
    public void testList() {
        Jedis jedis = new Jedis("192.168.89.128",6379);
        jedis.lpush("list1", "1","2","3","4","5");   //List 类型的数据的创建,按照入栈顺序放入 这个双向链表
        jedis.lset("list1", 0, "100");                 //将 list1 的 第一个 元素 设置为100
        System.out.println("list1:" + jedis.lrange("list1", 0, -1));
        System.out.println("lpop:" + jedis.lpop("list1"));     //弹出
    }
    
    @Test
    public void testSet() {
        Jedis jedis = new Jedis("192.168.89.128",6379);
        jedis.sadd("set1", "1","2","3","4","5","9");
        jedis.sadd("set2", "1","2","3","4","5","6");
        System.out.println(jedis.smembers("set1"));
        System.out.println(jedis.smembers("set2"));
        //差集  在第一个set里面而不在后面任何一个set里面的项
        System.out.println(jedis.sdiff("set1","set2"));
    }
    
    @Test
    public void testHash() {
        Jedis jedis = new Jedis("192.168.89.128",6379);
        jedis.hset("user1", "name", "xzk");
        jedis.hset("user1", "age", "22");
        
        Map<String,String> map = new HashMap<String, String>();
        
        //可以一次性为某个键 赋值多个 KV 键值对
        map.put("name", "xzk2");
        map.put("age", "23");
        jedis.hmset("user2", map);   //直接存放一个map
        
        System.out.println(jedis.hget("user1", "age"));
        
        //可以一次性取出多个 KV键值对
        List<String> results = jedis.hmget("user2", "name","age");
        System.out.println(results);
    }
    
    @Test
    public void testZSet() {
        Jedis jedis = new Jedis("192.168.89.128",6379);
        /*jedis.zadd("zset01",60,"v1");
        jedis.zadd("zset1",70,"v2");
        jedis.zadd("zset1",80,"v3");
        jedis.zadd("zset1",90,"v4");*/ 
        
        Map<Double, String> scoreMembers = new HashMap<Double, String>();
        scoreMembers.put(60d, "v1");    //key 为 score 
        scoreMembers.put(70d, "v2");
        scoreMembers.put(80d, "v3");
        scoreMembers.put(90d, "v4");
        jedis.zadd("zset1", scoreMembers );
        
        Set<String> resultSet = jedis.zrange("zset1", 0, -1);
        System.out.println(resultSet);
    }
}

　　c）事务提交

//关于 jedis 事务的 
public class TestTX {
    public static void main(String[] args) throws InterruptedException {
        boolean retValue = transMethod();
        System.out.println("main retValue-------: " + retValue);
    }
    
    
    /**
       * 通俗点讲，watch命令就是标记一个键，如果标记了一个键， 
       * 在提交事务前如果该键被别人修改过，那事务就会失败，这种情况通常可以在程序中
       * 重新再尝试一次。
       * 
       * 首先标记了键balance，然后检查  键balance是否发生了修改，修改了取消标记，
       * 没有被修改的话，就启动事务进行更新操作，
       * 如果在此期间键balance被其它人修改， 那在提交事务（执行exec）时就会报错，（但是事务失败后，只是不执行事务而已啊，这里不会报错啊） 
       * 程序中通常可以捕获这类错误再重新执行一次，直到成功。
     * @throws InterruptedException 
       */
    private static boolean transMethod() throws InterruptedException {
        int balance = 100;// 可用余额
        int debt = 0;// 欠额
        int amtToSubtract = 10;// 实刷额
        
        Jedis jedis = new Jedis("192.168.89.128", 6379);
        jedis.set("balance", ""+ balance);
        jedis.set("debt", "" + debt);
        
        //监听balance，如果在此期间键balance被其它人修改， 则提交的事务 不会被执行（不会报错）
        jedis.watch("balance");
        
        //模拟故障，在等待的时间要去修改下 balance 这个 key的值
        Thread.sleep(8000);
        
        //虽然不会报错，但是可以找到这类错误，让其再重新执行一次，直到成功。
        //检查  键balance 是否被他人修改，如果修改了，则取消标记，返回错误
        if(balance != Integer.parseInt(jedis.get("balance"))) {
            jedis.unwatch();
            return false;
        }
        
        //事务的执行
        Transaction transaction = jedis.multi();
        transaction.decrBy("balance", amtToSubtract);
        transaction.incrBy("debt", amtToSubtract);
        //transaction.discard();    取消某个事务的执行  
        transaction.exec();
        
        //从redis 中拿回 新的balance 和 debt
        balance = Integer.parseInt(jedis.get("balance"));
        debt = Integer.parseInt(jedis.get("debt"));
        
        System.out.println("事务执行后，balance = " + balance + "   debt = " + debt);
        return true;
    }
}

2.JedisPool

　　获取Jedis实例需要从JedisPool中获取

　　用完Jedis实例需要返回给JedisPool

　　如果Jedis在使用过程中出错，则也需要还给JedisPool

　　

public class TestJedisPool {
    public static void main(String[] args) {
        //通过单例模式创建 redis 连接池
        JedisPool jedisPool = JedisPoolUtil.getJedisPool();
        Jedis jedis = null;
        
        //通过拿到连接
        try{
            jedis = jedisPool.getResource();
            System.out.println(jedis.get("k1"));
        } catch(Exception e) {
            e.printStackTrace();
        }finally {
            //最后将创建的 jedis 连接放回 池中
            JedisPoolUtil.releaseJedis(jedisPool, jedis);
        }
        
        
    }
}

　　JedisPool配置总结

public class JedisPoolUtil {
    //被volatile 修饰的/*变量*/不会被本地线程缓存，对该变量的操作都是直接操作共享内存的
    // JUC 里面也用到了 volatile 来保证 内存可见性
    private static volatile JedisPool jedisPool = null;

    public static JedisPool getJedisPool() {
        if (null == jedisPool) {
            synchronized (JedisPoolUtil.class) {
                if (null == jedisPool) {
                    // 创建连接池的配置文件，JedisPool的配置参数大部分是由这个配置文件决定的
                    JedisPoolConfig poolConfig = new JedisPoolConfig();
                    // 控制一个pool最多有多少个jedis实例
                    poolConfig.setMaxActive(1000);
                    // 控制一个pool最多有多少个状态为idle的jedis实例（最大空闲连接数）（要有这么多空闲的连接，不然不给创建）
                    poolConfig.setMaxIdle(32);
                    // 创建实例的最大等待时间（因为是上了锁的，所以可能会等待）
                    poolConfig.setMaxWait(100 * 1000);
                    // 在获取连接时 检查有效性，一般为false
                    poolConfig.setTestOnBorrow(true);

                    // 这个连接池 从 6379 这个端口获取连接
                    jedisPool = new JedisPool(poolConfig, "192.168.89.128",
                            6379);
                }
            }
        }
        return jedisPool;
    }

    // 将 jedis 释放回 jedisPool
    public static void releaseJedis(JedisPool jedisPool, Jedis jedis) {
        if (jedis != null) {
            jedisPool.returnResourceObject(jedis);
        }
    }
}

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：获得一个jedis实例的时候是否检查连接可用性（ping()）；如果为true，则得到的jedis实例均是可用的；


testOnReturn：return 一个jedis实例给pool时，是否检查连接可用性（ping()）；


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