Jedis对Redis五大类型操作简单介绍

本篇主要阐述Jedis对redis的五大类型的操作：字符串、列表、散列、集合、有序集合。

JedisUtil

这里的测试用例采用junit4进行运行，准备代码如下：

private static final String ipAddr = "10.10.195.112";
private static final int port = 6379;
private static Jedis jedis= null;

@BeforeClass
public static void init()
{
    jedis = JedisUtil.getInstance().getJedis(ipAddr, port);
}

@AfterClass
public static void close()
{
    JedisUtil.getInstance().closeJedis(jedis,ipAddr, port);
}

其中JedisUtil是对jedis做的简单封装，代码如下：

import org.apache.log4j.Logger;

import java.util.HashMap; 
import java.util.Map;

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

public class JedisUtil 
{ 
private Logger logger = Logger.getLogger(this.getClass().getName());

private JedisUtil(){}

private static class RedisUtilHolder{
    private static final JedisUtil instance = new JedisUtil();
}

public static JedisUtil getInstance(){
    return RedisUtilHolder.instance;
}

private static Map<String,JedisPool> maps = new HashMap<String,JedisPool>();

private static JedisPool getPool(String ip, int port){
    String key = ip+":"+port;
    JedisPool pool = null;
    if(!maps.containsKey(key))
    {
        JedisPoolConfig config = new JedisPoolConfig();
        config.setMaxActive(RedisConfig.MAX_ACTIVE);
        config.setMaxIdle(RedisConfig.MAX_IDLE);
        config.setMaxWait(RedisConfig.MAX_WAIT);
        config.setTestOnBorrow(true);
        config.setTestOnReturn(true);

        pool = new JedisPool(config,ip,port,RedisConfig.TIMEOUT);
        maps.put(key, pool);
    }
    else
    {
        pool = maps.get(key);
    }
    return pool;        
}

public Jedis getJedis(String ip, int port)
{
    Jedis jedis = null;
    int count = 0;
    do
    {
        try
        {
            jedis = getPool(ip,port).getResource();
        }
        catch (Exception e)
        {
            logger.error("get redis master1 failed!",e);
            getPool(ip,port).returnBrokenResource(jedis);
        }
    }
    while(jedis == null && count<RedisConfig.RETRY_NUM);
    return jedis;
}

public void closeJedis(Jedis jedis, String ip, int port){
    if(jedis != null)
    {
        getPool(ip,port).returnResource(jedis);
    }
}

}

public class RedisConfig 
{ 
//可用连接实例的最大数目，默认值为8； 
//如果赋值为-1，则表示不限制；如果pool已经分配了maxActive个jedis实例，则此时pool的状态为exhausted(耗尽)。 
public static int MAX_ACTIVE = 1024;

//控制一个pool最多有多少个状态为idle(空闲的)的jedis实例，默认值也是8。
public static int MAX_IDLE = 200;

//等待可用连接的最大时间，单位毫秒，默认值为-1，表示永不超时。如果超过等待时间，则直接抛出JedisConnectionException；
public static int MAX_WAIT = 10000;

public static int TIMEOUT = 10000;

public static int RETRY_NUM = 5;

}

扫描二维码关注公众号，回复： 6175453 查看本文章

键操作

@Test public void testKey() throws InterruptedException
{
    System.out.println("清空数据："+jedis.flushDB());
    System.out.println("判断某个键是否存在："+jedis.exists("username"));
    System.out.println("新增<'username','zzh'>的键值对："+jedis.set("username", "zzh"));
    System.out.println(jedis.exists("name"));
    System.out.println("新增<'password','password'>的键值对："+jedis.set("password", "password"));
    System.out.print("系统中所有的键如下：");
    Set<String> keys = jedis.keys("*");
    System.out.println(keys);
    System.out.println("删除键password:"+jedis.del("password"));
    System.out.println("判断键password是否存在："+jedis.exists("password"));
    System.out.println("设置键username的过期时间为5s:"+jedis.expire("username", 5));
    TimeUnit.SECONDS.sleep(2);
    System.out.println("查看键username的剩余生存时间："+jedis.ttl("username"));
    System.out.println("移除键username的生存时间："+jedis.persist("username"));
    System.out.println("查看键username的剩余生存时间："+jedis.ttl("username"));
    System.out.println("查看键username所存储的值的类型："+jedis.type("username"));
}

输出结果：

清空数据：OK 
判断某个键是否存在：false 
新增<’username’,’zzh’>的键值对：OK 
false 
新增<’password’,’password’>的键值对：OK 
系统中所有的键如下：[username, password] 
删除键password:1 
判断键password是否存在：false 
设置键username的过期时间为5s:1 
查看键username的剩余生存时间：3 
移除键username的生存时间：1 
查看键username的剩余生存时间：-1 
查看键username所存储的值的类型：string

字符串操作

在Redis里面，字符串可以存储三种类型的值：

字节串(byte string) 
整数 
浮点数 
字节串

@Test public void testString() throws InterruptedException
{
    jedis.flushDB();
    System.out.println("===========增加数据===========");
    System.out.println(jedis.set("key1","value1"));
    System.out.println(jedis.set("key2","value2"));
    System.out.println(jedis.set("key3", "value3"));
    System.out.println("删除键key2:"+jedis.del("key2"));
    System.out.println("获取键key2:"+jedis.get("key2"));
    System.out.println("修改key1:"+jedis.set("key1", "value1Changed"));
    System.out.println("获取key1的值："+jedis.get("key1"));
    System.out.println("在key3后面加入值："+jedis.append("key3", "End"));
    System.out.println("key3的值："+jedis.get("key3"));
    System.out.println("增加多个键值对："+jedis.mset("key01","value01","key02","value02","key03","value03"));
    System.out.println("获取多个键值对："+jedis.mget("key01","key02","key03"));
    System.out.println("获取多个键值对："+jedis.mget("key01","key02","key03","key04"));
    System.out.println("删除多个键值对："+jedis.del(new String[]{"key01","key02"}));
    System.out.println("获取多个键值对："+jedis.mget("key01","key02","key03"));

    jedis.flushDB();
    System.out.println("===========新增键值对防止覆盖原先值==============");
    System.out.println(jedis.setnx("key1", "value1"));
    System.out.println(jedis.setnx("key2", "value2"));
    System.out.println(jedis.setnx("key2", "value2-new"));
    System.out.println(jedis.get("key1"));
    System.out.println(jedis.get("key2"));

    System.out.println("===========新增键值对并设置有效时间=============");
    System.out.println(jedis.setex("key3", 2, "value3"));
    System.out.println(jedis.get("key3"));
    TimeUnit.SECONDS.sleep(3);
    System.out.println(jedis.get("key3"));

    System.out.println("===========获取原值，更新为新值==========");//GETSET is an atomic set this value and return the old value command.
    System.out.println(jedis.getSet("key2", "key2GetSet"));
    System.out.println(jedis.get("key2"));

    System.out.println("获得key2的值的字串："+jedis.getrange("key2", 2, 4));
}

输出结果：

===========增加数据=========== 
OK 
OK 
OK 
删除键key2:1 
获取键key2:null 
修改key1:OK 
获取key1的值：value1Changed 
在key3后面加入值：9 
key3的值：value3End 
增加多个键值对：OK 
获取多个键值对：[value01, value02, value03] 
获取多个键值对：[value01, value02, value03, null] 
删除多个键值对：2 
获取多个键值对：[null, null, value03] 
===========新增键值对防止覆盖原先值============== 
1 
1 
0 
value1 
value2 
===========新增键值对并设置有效时间============= 
OK 
value3 
null 
===========获取原值，更新为新值========== 
value2 
key2GetSet 
获得key2的值的字串：y2G

memcached和redis同样有append的操作，但是memcached有prepend的操作，redis中并没有。

整数和浮点数

@Test public void testNumber()
{
    jedis.flushDB();
    jedis.set("key1", "1");
    jedis.set("key2", "2");
    jedis.set("key3", "2.3");
    System.out.println("key1的值："+jedis.get("key1"));
    System.out.println("key2的值："+jedis.get("key2"));
    System.out.println("key1的值加1："+jedis.incr("key1"));
    System.out.println("获取key1的值："+jedis.get("key1"));
    System.out.println("key2的值减1："+jedis.decr("key2"));
    System.out.println("获取key2的值："+jedis.get("key2"));
    System.out.println("将key1的值加上整数5："+jedis.incrBy("key1", 5));
    System.out.println("获取key1的值："+jedis.get("key1"));
    System.out.println("将key2的值减去整数5："+jedis.decrBy("key2", 5));
    System.out.println("获取key2的值："+jedis.get("key2"));
}

输出结果：

key1的值：1 
key2的值：2 
key1的值加1：2 
获取key1的值：2 
key2的值减1：1 
获取key2的值：1 
将key1的值加上整数5：7 
获取key1的值：7 
将key2的值减去整数5：-4 
获取key2的值：-4

在redis2.6或以上版本中有这个命令：incrbyfloat，即将键存储的值加上浮点数amount，jedis-2.1.0中不支持这一操作。 
列表

@Test public void testList() 
{ 
jedis.flushDB(); 
System.out.println(“===========添加一个list===========”); 
jedis.lpush(“collections”, “ArrayList”, “Vector”, “Stack”, “HashMap”, “WeakHashMap”, “LinkedHashMap”); 
jedis.lpush(“collections”, “HashSet”); 
jedis.lpush(“collections”, “TreeSet”); 
jedis.lpush(“collections”, “TreeMap”); 
System.out.println(“collections的内容：”+jedis.lrange(“collections”, 0, -1));//-1代表倒数第一个元素，-2代表倒数第二个元素 
System.out.println(“collections区间0-3的元素：”+jedis.lrange(“collections”,0,3)); 
System.out.println(“===============================”); 
// 删除列表指定的值 ，第二个参数为删除的个数（有重复时），后add进去的值先被删，类似于出栈 
System.out.println(“删除指定元素个数：”+jedis.lrem(“collections”, 2, “HashMap”)); 
System.out.println(“collections的内容：”+jedis.lrange(“collections”, 0, -1)); 
System.out.println(“删除下表0-3区间之外的元素：”+jedis.ltrim(“collections”, 0, 3)); 
System.out.println(“collections的内容：”+jedis.lrange(“collections”, 0, -1)); 
System.out.println(“collections列表出栈（左端）：”+jedis.lpop(“collections”)); 
System.out.println(“collections的内容：”+jedis.lrange(“collections”, 0, -1)); 
System.out.println(“collections添加元素，从列表右端，与lpush相对应：”+jedis.rpush(“collections”, “EnumMap”)); 
System.out.println(“collections的内容：”+jedis.lrange(“collections”, 0, -1)); 
System.out.println(“collections列表出栈（右端）：”+jedis.rpop(“collections”)); 
System.out.println(“collections的内容：”+jedis.lrange(“collections”, 0, -1)); 
System.out.println(“修改collections指定下标1的内容：”+jedis.lset(“collections”, 1, “LinkedArrayList”)); 
System.out.println(“collections的内容：”+jedis.lrange(“collections”, 0, -1)); 
System.out.println(“===============================”); 
System.out.println(“collections的长度：”+jedis.llen(“collections”)); 
System.out.println(“获取collections下标为2的元素：”+jedis.lindex(“collections”, 2)); 
System.out.println(“===============================”); 
jedis.lpush(“sortedList”, “3”,”6”,”2”,”0”,”7”,”4”); 
System.out.println(“sortedList排序前：”+jedis.lrange(“sortedList”, 0, -1)); 
System.out.println(jedis.sort(“sortedList”)); 
System.out.println(“sortedList排序后：”+jedis.lrange(“sortedList”, 0, -1)); 
} 
输出结果：

===========添加一个list=========== 
collections的内容：[TreeMap, TreeSet, HashSet, LinkedHashMap, WeakHashMap, HashMap, Stack, Vector, ArrayList]

collections区间0-3的元素：[TreeMap, TreeSet, HashSet, LinkedHashMap]

删除指定元素个数：1 
collections的内容：[TreeMap, TreeSet, HashSet, LinkedHashMap, WeakHashMap, Stack, Vector, ArrayList] 
删除下表0-3区间之外的元素：OK 
collections的内容：[TreeMap, TreeSet, HashSet, LinkedHashMap] 
collections列表出栈（左端）：TreeMap 
collections的内容：[TreeSet, HashSet, LinkedHashMap] 
collections添加元素，从列表右端，与lpush相对应：4 
collections的内容：[TreeSet, HashSet, LinkedHashMap, EnumMap] 
collections列表出栈（右端）：EnumMap 
collections的内容：[TreeSet, HashSet, LinkedHashMap] 
修改collections指定下标1的内容：OK

collections的内容：[TreeSet, LinkedArrayList, LinkedHashMap]

collections的长度：3

获取collections下标为2的元素：LinkedHashMap

sortedList排序前：[4, 7, 0, 2, 6, 3] 
[0, 2, 3, 4, 6, 7] 
sortedList排序后：[4, 7, 0, 2, 6, 3]

Redis中还有阻塞式的列表弹出命令以及在列表之间移动元素的命令：blpop, brpop, rpoplpush, brpoplpush等。 
集合（Set）

@Test public void testSet()
{
    jedis.flushDB();
    System.out.println("============向集合中添加元素============");
    System.out.println(jedis.sadd("eleSet", "e1","e2","e4","e3","e0","e8","e7","e5"));
    System.out.println(jedis.sadd("eleSet", "e6"));
    System.out.println(jedis.sadd("eleSet", "e6"));
    System.out.println("eleSet的所有元素为："+jedis.smembers("eleSet"));
    System.out.println("删除一个元素e0："+jedis.srem("eleSet", "e0"));
    System.out.println("eleSet的所有元素为："+jedis.smembers("eleSet"));
    System.out.println("删除两个元素e7和e6："+jedis.srem("eleSet", "e7","e6"));
    System.out.println("eleSet的所有元素为："+jedis.smembers("eleSet"));
    System.out.println("随机的移除集合中的一个元素："+jedis.spop("eleSet"));
    System.out.println("随机的移除集合中的一个元素："+jedis.spop("eleSet"));
    System.out.println("eleSet的所有元素为："+jedis.smembers("eleSet"));
    System.out.println("eleSet中包含元素的个数："+jedis.scard("eleSet"));
    System.out.println("e3是否在eleSet中："+jedis.sismember("eleSet", "e3"));
    System.out.println("e1是否在eleSet中："+jedis.sismember("eleSet", "e1"));
    System.out.println("e1是否在eleSet中："+jedis.sismember("eleSet", "e5"));
    System.out.println("=================================");
    System.out.println(jedis.sadd("eleSet1", "e1","e2","e4","e3","e0","e8","e7","e5"));
    System.out.println(jedis.sadd("eleSet2", "e1","e2","e4","e3","e0","e8"));
    System.out.println("将eleSet1中删除e1并存入eleSet3中："+jedis.smove("eleSet1", "eleSet3", "e1"));
    System.out.println("将eleSet1中删除e2并存入eleSet3中："+jedis.smove("eleSet1", "eleSet3", "e2"));
    System.out.println("eleSet1中的元素："+jedis.smembers("eleSet1"));
    System.out.println("eleSet3中的元素："+jedis.smembers("eleSet3"));
    System.out.println("============集合运算=================");
    System.out.println("eleSet1中的元素："+jedis.smembers("eleSet1"));
    System.out.println("eleSet2中的元素："+jedis.smembers("eleSet2"));
    System.out.println("eleSet1和eleSet2的交集:"+jedis.sinter("eleSet1","eleSet2"));
    System.out.println("eleSet1和eleSet2的并集:"+jedis.sunion("eleSet1","eleSet2"));
    System.out.println("eleSet1和eleSet2的差集:"+jedis.sdiff("eleSet1","eleSet2"));//eleSet1中有，eleSet2中没有
}

输出结果：

============向集合中添加元素============ 
8 
1 
0 
eleSet的所有元素为：[e3, e4, e1, e2, e0, e8, e7, e6, e5] 
删除一个元素e0：1 
eleSet的所有元素为：[e3, e4, e1, e2, e8, e7, e6, e5] 
删除两个元素e7和e6：2 
eleSet的所有元素为：[e3, e4, e1, e2, e8, e5] 
随机的移除集合中的一个元素：e5 
随机的移除集合中的一个元素：e2 
eleSet的所有元素为：[e3, e4, e1, e8] 
eleSet中包含元素的个数：4 
e3是否在eleSet中：true 
e1是否在eleSet中：true

e1是否在eleSet中：false

8 
6 
将eleSet1中删除e1并存入eleSet3中：1 
将eleSet1中删除e2并存入eleSet3中：1 
eleSet1中的元素：[e3, e4, e0, e8, e7, e5] 
eleSet3中的元素：[e1, e2] 
============集合运算================= 
eleSet1中的元素：[e3, e4, e0, e8, e7, e5] 
eleSet2中的元素：[e3, e4, e1, e2, e0, e8] 
eleSet1和eleSet2的交集:[e3, e4, e0, e8] 
eleSet1和eleSet2的并集:[e3, e4, e1, e2, e0, e8, e7, e5] 
eleSet1和eleSet2的差集:[e7, e5]

关于Set还有一些其他命令：srandmember, sdiffstore, sinterstore, sunionstore等。 
散列

@Test public void testHash()
{
    jedis.flushDB();
    Map<String,String> map = new HashMap<>();
    map.put("key1","value1");
    map.put("key2","value2");
    map.put("key3","value3");
    map.put("key4","value4");
    jedis.hmset("hash",map);
    jedis.hset("hash", "key5", "value5");
    System.out.println("散列hash的所有键值对为："+jedis.hgetAll("hash"));//return Map<String,String>
    System.out.println("散列hash的所有键为："+jedis.hkeys("hash"));//return Set<String>
    System.out.println("散列hash的所有值为："+jedis.hvals("hash"));//return List<String>
    System.out.println("将key6保存的值加上一个整数，如果key6不存在则添加key6："+jedis.hincrBy("hash", "key6", 6));
    System.out.println("散列hash的所有键值对为："+jedis.hgetAll("hash"));
    System.out.println("将key6保存的值加上一个整数，如果key6不存在则添加key6："+jedis.hincrBy("hash", "key6", 3));
    System.out.println("散列hash的所有键值对为："+jedis.hgetAll("hash"));
    System.out.println("删除一个或者多个键值对："+jedis.hdel("hash", "key2"));
    System.out.println("散列hash的所有键值对为："+jedis.hgetAll("hash"));
    System.out.println("散列hash中键值对的个数："+jedis.hlen("hash"));
    System.out.println("判断hash中是否存在key2："+jedis.hexists("hash","key2"));
    System.out.println("判断hash中是否存在key3："+jedis.hexists("hash","key3"));
    System.out.println("获取hash中的值："+jedis.hmget("hash","key3"));
    System.out.println("获取hash中的值："+jedis.hmget("hash","key3","key4"));
}

输出结果：

散列hash的所有键值对为：{key4=value4, key3=value3, key5=value5, key2=value2, key1=value1} 
散列hash的所有键为：[key4, key3, key5, key2, key1] 
散列hash的所有值为：[value4, value3, value1, value2, value5] 
将key6保存的值加上一个整数，如果key6不存在则添加key6：6 
散列hash的所有键值对为：{key4=value4, key3=value3, key6=6, key5=value5, key2=value2, key1=value1} 
将key6保存的值加上一个整数，如果key6不存在则添加key6：9 
散列hash的所有键值对为：{key4=value4, key3=value3, key6=9, key5=value5, key2=value2, key1=value1} 
删除一个或者多个键值对：1 
散列hash的所有键值对为：{key4=value4, key3=value3, key6=9, key5=value5, key1=value1} 
散列hash中键值对的个数：5 
判断hash中是否存在key2：false 
判断hash中是否存在key3：true 
获取hash中的值：[value3] 
获取hash中的值：[value3, value4]

有序集合

@Test public void testSortedSet()
{
    jedis.flushDB();
    Map<Double,String> map = new HashMap<>();
    map.put(1.2,"key2");
    map.put(4.0, "key3");
    map.put(5.0,"key4");
    map.put(0.2,"key5");
    System.out.println(jedis.zadd("zset", 3,"key1"));
    System.out.println(jedis.zadd("zset",map));
    System.out.println("zset中的所有元素："+jedis.zrange("zset", 0, -1));
    System.out.println("zset中的所有元素："+jedis.zrangeWithScores("zset", 0, -1));
    System.out.println("zset中的所有元素："+jedis.zrangeByScore("zset", 0,100));
    System.out.println("zset中的所有元素："+jedis.zrangeByScoreWithScores("zset", 0,100));
    System.out.println("zset中key2的分值："+jedis.zscore("zset", "key2"));
    System.out.println("zset中key2的排名："+jedis.zrank("zset", "key2"));
    System.out.println("删除zset中的元素key3："+jedis.zrem("zset", "key3"));
    System.out.println("zset中的所有元素："+jedis.zrange("zset", 0, -1));
    System.out.println("zset中元素的个数："+jedis.zcard("zset"));
    System.out.println("zset中分值在1-4之间的元素的个数："+jedis.zcount("zset", 1, 4));
    System.out.println("key2的分值加上5："+jedis.zincrby("zset", 5, "key2"));
    System.out.println("key3的分值加上4："+jedis.zincrby("zset", 4, "key3"));
    System.out.println("zset中的所有元素："+jedis.zrange("zset", 0, -1));
}

输出结果：

1 
4 
zset中的所有元素：[key5, key2, key1, key3, key4] 
zset中的所有元素：[[[107, 101, 121, 53],0.2], [[107, 101, 121, 50],1.2], [[107, 101, 121, 49],3.0], [[107, 101, 121, 51],4.0], [[107, 101, 121, 52],5.0]] 
zset中的所有元素：[key5, key2, key1, key3, key4] 
zset中的所有元素：[[[107, 101, 121, 53],0.2], [[107, 101, 121, 50],1.2], [[107, 101, 121, 49],3.0], [[107, 101, 121, 51],4.0], [[107, 101, 121, 52],5.0]] 
zset中key2的分值：1.2 
zset中key2的排名：1 
删除zset中的元素key3：1 
zset中的所有元素：[key5, key2, key1, key4] 
zset中元素的个数：4 
zset中分值在1-4之间的元素的个数：2 
key2的分值加上5：6.2 
key3的分值加上4：4.0 
zset中的所有元素：[key5, key1, key3, key4, key2]

有序集合还有诸如zinterstore, zunionstore, zremrangebyscore, zremrangebyrank, zrevrank, zrevrange, zrangebyscore等命令。 
排序sort

@Test public void testSort()
{
    jedis.flushDB();
    jedis.lpush("collections", "ArrayList", "Vector", "Stack", "HashMap", "WeakHashMap", "LinkedHashMap");
    System.out.println("collections的内容："+jedis.lrange("collections", 0, -1));
    SortingParams sortingParameters = new SortingParams();
    System.out.println(jedis.sort("collections",sortingParameters.alpha()));
    System.out.println("===============================");
    jedis.lpush("sortedList", "3","6","2","0","7","4");
    System.out.println("sortedList排序前："+jedis.lrange("sortedList", 0, -1));
    System.out.println("升序："+jedis.sort("sortedList", sortingParameters.asc()));
    System.out.println("升序："+jedis.sort("sortedList", sortingParameters.desc()));
    System.out.println("===============================");
    jedis.lpush("userlist", "33");  
    jedis.lpush("userlist", "22");  
    jedis.lpush("userlist", "55");  
    jedis.lpush("userlist", "11");  
    jedis.hset("user:66", "name", "66");  
    jedis.hset("user:55", "name", "55");  
    jedis.hset("user:33", "name", "33");  
    jedis.hset("user:22", "name", "79");  
    jedis.hset("user:11", "name", "24");  
    jedis.hset("user:11", "add", "beijing");  
    jedis.hset("user:22", "add", "shanghai");  
    jedis.hset("user:33", "add", "guangzhou");  
    jedis.hset("user:55", "add", "chongqing");  
    jedis.hset("user:66", "add", "xi'an");  
    sortingParameters = new SortingParams();
    sortingParameters.get("user:*->name");  
    sortingParameters.get("user:*->add"); 
    System.out.println(jedis.sort("userlist",sortingParameters));
}

输出结果：

collections的内容：[LinkedHashMap, WeakHashMap, HashMap, Stack, Vector, ArrayList]

[ArrayList, HashMap, LinkedHashMap, Stack, Vector, WeakHashMap]

sortedList排序前：[4, 7, 0, 2, 6, 3] 
升序：[0, 2, 3, 4, 6, 7]

升序：[7, 6, 4, 3, 2, 0]

[24, beijing, 79, shanghai, 33, guangzhou, 55, chongqing]

转自 https://blog.csdn.net/lixiaoxiong55/article/details/51276223

jedis常用API

一、Redis Client介绍

1.1、简介

Jedis Client是Redis官网推荐的一个面向java客户端，库文件实现了对各类API进行封装调用。

Jedis源码工程地址：https://github.com/xetorthio/jedis

1.2、使用

Redis Client最好选用与服务端对应的版本，本例中使用Redis 2.8.19客户端使用jedis -2.6.3，Maven工程添加如下引用即可。

   <dependency>

         <groupId>redis.clients</groupId>

         <artifactId>jedis</artifactId>

         <version>2.6.3</version>

         <type>jar</type>

         <scope>compile</scope>

   </dependency>

1.3、注意事项

Redis Client拥有众多对接版本，本项目目前使用Jedis为官方推荐Java对接客户端，是基于其对Redis良好的版本支持和API对接，另外编码中尽量避免使用废弃接口。

Redis目前正在新版过渡期，3.0版本暂未稳定，但是由于3.0版本提供了最新的集群功能，可能在日后稳定版发布以后升级到3.0，目前使用的Jedis支持3.0的目前版本API。

二、Redis Client常用API

2.1、环境要求

语言：Java

JDK：1.7

Redis : 2.8.19（稳定版）

2.2、系统使用

2.2.1、建立连接

• 普通连接

Jedis jedis = new Jedis("localhost");

       jedis.set("foo", "bar");

       String value = jedis.get("foo");

       System.out.println(value);

• 设置连接池配置

该方法用于得到redis连接池连接使用的连接池配置，该连接池配置也可以通过spring注入的方式来进行相对应的配置，连接池采用的是平时比较常用的org.apache.commons.pool2.impl.GenericObjectPoolConfig来进行的连接池管理

配置文件如下

#redis服务器ip #   

    redis.ip=172.30.5.117 

   

    #redis服务器端口号# 

    redis.port=6379 

     

    ###jedis##pool##config### 

    #jedis的最大分配对象# 

    jedis.pool.maxActive=1024 

   

    #jedis最大保存idel状态对象数 # 

    jedis.pool.maxIdle=200 

   

    #jedis池没有对象返回时，最大等待时间 # 

    jedis.pool.maxWait=1000 

   

    #jedis调用borrowObject方法时，是否进行有效检查# 

    jedis.pool.testOnBorrow=true 

   

    #jedis调用returnObject方法时，是否进行有效检查 # 

    jedis.pool.testOnReturn=true

连接池配置实例化代码（也可通过spring注入进行配置）：

   /**

    * 获取化连接池配置

    * @return JedisPoolConfig

    * */

   private JedisPoolConfig getPoolConfig(){

      if(config == null){

         config = new JedisPoolConfig();

         //最大连接数

config.setMaxTotal(Integer.valueOf(getResourceBundle().getString("redis.pool.maxTotal")));

         //最大空闲连接数

config.setMaxIdle(Integer.valueOf(getResourceBundle().getString("redis.pool.maxIdle")));

         //获取连接时的最大等待毫秒数(如果设置为阻塞时BlockWhenExhausted),如果超时就抛异常, 小于零:阻塞不确定的时间,  默认-1

config.setMaxWaitMillis(Long.valueOf(getResourceBundle().getString("redis.pool.maxWaitMillis")));

         //在获取连接的时候检查有效性, 默认false

config.setTestOnBorrow(Boolean.valueOf(getResourceBundle().getString("redis.pool.testOnBorrow")));

         //在获取返回结果的时候检查有效性, 默认false

config.setTestOnReturn(Boolean.valueOf(getResourceBundle().getString("redis.pool.testOnReturn")));

      }

      return config;

   }

• 普通连接池连接

  这里展示的是普通的连接池方式链接redis的方案，跟普通的数据库连接池的操作方式类似；

/**

        * 初始化JedisPool

        * */

   private void initJedisPool(){

      if(pool == null){

         //获取服务器IP地址

         String ipStr = getResourceBundle().getString("redis.ip");

         //获取服务器端口

         int portStr = Integer.valueOf(getResourceBundle()

.getString("redis.port"));

         //初始化连接池

         pool = new JedisPool(getPoolConfig(), ipStr,portStr);

      }

   } 

• Sentinel连接池连接

该连接池用于应对Redis的Sentinel的主从切换机制，能够正确在服务器宕机导致服务器切换时得到正确的服务器连接，当服务器采用该部署策略的时候推荐使用该连接池进行操作；

   private void initJedisSentinelPool(){

      if(sentinelpool == null){

         //监听器列表

         Set<String> sentinels = new HashSet<String>();

         //监听器1

         sentinels.add(new HostAndPort("192.168.50.236",

26379).toString());

         //监听器2

         sentinels.add(new HostAndPort("192.168.50.237",

26379).toString());

//实际使用的时候在properties里配置即可：redis.sentinel.hostandports

=192.168.50.236:26379,192.168.50.237:26379

getResourceBundle().getString("redis.sentinel.hostandports")

//mastername是服务器上的master的名字，在master服务器的sentinel.conf中配置:

                     //[sentinel monitor server-1M  192.168.50.236 6379 2]

                     //中间的server-1M即为这里的masterName

         String masterName = getResourceBundle()

.getString("redis.sentinel.masterName");

         //初始化连接池

         sentinelpool = new JedisSentinelPool(masterName,

sentinels, getPoolConfig());

      }

   }

• ShardedJedisPool连接池分片连接

   /**

        * 初始化ShardedJedisPool

        * Redis在容灾处理方面可以通过服务器端配置Master-Slave模式来实现。

        * 而在分布式集群方面目前只能通过客户端工具来实现一致性哈希分布存储，即key分片存储。

        * Redis可能会在3.0版本支持服务器端的分布存储

        * */

   private void initShardedJedisPool() {

      if (shardPool == null) {

         // 创建多个redis共享服务

         String redis1Ip = getResourceBundle().getString("redis1.ip");

         int redis1Port = Integer.valueOf(bundle.getString("redis.port"));

         JedisShardInfo jedisShardInfo1 = new JedisShardInfo(redis1Ip, redis1Port);

         String redis2Ip = getResourceBundle().getString("redis2.ip");

         int redis2Port = Integer.valueOf(bundle.getString("redis.port"));

         JedisShardInfo jedisShardInfo2 = new JedisShardInfo(redis2Ip, redis2Port);

         List<JedisShardInfo> serverlist = new LinkedList<JedisShardInfo>();

         serverlist.add(jedisShardInfo1);

         serverlist.add(jedisShardInfo2);

         // 初始化连接池

         shardPool = new ShardedJedisPool(getPoolConfig(),serverlist);

      }

   }

• 读写删除操作

// 从池中获取一个Jedis对象

      Jedis jedis = sentinelpool.getSentinelpoolResource();

      String keys = "name";

   // 删除key-value对象，如果key不存在则忽略此操作

      jedis.del(keys);

   // 存数据

      jedis.set(keys, "snowolf");

// 判断key是否存在，不存在返回false存在返回true

      jedis.exists(keys);

   // 取数据

      String value = jedis.get(keys);

   // 释放对象池（3.0将抛弃该方法）

      sentinelpool.returnSentinelpoolResource(jedis);

三、示例代码

1. 1.     String的简单追加

// 从池中获取一个Jedis对象

   JedisUtil.getInstance().STRINGS.append(key, value);

1. 2.     价格时间排序（前提是已经存储了价格，时间的SortSet）

//执行2级排序操作（）

String stPriceSet = “stPriceSet”;//stPriceSet价格的sortset列表名

String stTimeSet = “stTimeSet”; // stTimeSet时间的sortset列表名

   Set<Tuple> sumSet = JedisUtilEx.getInstance()

.getSortSetByPirceUpAndTimeDown(stPriceSet, stTimeSet);

//排序以后可以重复获取上次排序结果(缓存时间10分钟)

Set<Tuple> sumSet = JedisUtilEx.getInstance()

getLastPirceUpAndTimeDownSet();

1. 3.  价格时间排序（前提是已经存储了价格，时间的SortSet）

//执行2级排序操作

String stPriceSet = “stPriceSet”;//stPriceSet价格的sortset列表名

String stTimeSet = “stTimeSet”; // stTimeSet时间的sortset列表名

   Set<Tuple> sumSet = JedisUtilEx.getInstance()

. getSortSetByPirceDownAndTimeDown (stPriceSet, stTimeSet);

   //排序以后可以重复获取上次排序结果(缓存时间10分钟)

Set<Tuple> sumSet = JedisUtilEx.getInstance()

getLastPirceDownAndTimeDownSet ();

1. 4.     保存JavaBean到hash表中

// bean继承至RedisBean

JedisUtilEx.getInstance().setBeanToHash(bean);

1. 5.     从hash表中读取JavaBean

//uuid为业务制定的唯一标识符规则（相当于主键）

String uuid = “1”; //该ID是我们提前就知道的

//T继承至RedisBean;

JedisUtilEx.getInstance().getBeanFromHash (uuid,Class<T> cls);

1. 6.     将JavaBean列表装入hash中

//list中的bean继承至RedisBean

List<T> beanList = …;

JedisUtilEx.getInstance().setBeanListToHash(beanList);

//异步版本的存储列表到hash

JedisUtilEx.getInstance().setBeanListToHashSyn(beanList);

1. 7.     普通的操作流程示例

//获取jedis引用

Jedis jedis = JedisUtil.getInstance().getJedis();

//执行业务以及调用jedis提供的接口功能

…

jedis.hset(…);

…

//执行完成以后务必释放资源

JedisUtil.getInstance().returnJedis(jedis);

//若以后不会使用JEDIS，需要关闭所有链接池

   RedisConnetcion.destroyAllPools();

1. 8.     事务执行流程

//获取连接资源

   Jedis jd = JedisUtil.getInstance().getJedis();

//开启事务

Transaction ts = jd.multi();

//执行业务以及调用jedis提供的接口功能

…

jedis.hset(…);

…

//执行事务

   List<Object> list = ts.exec();

//释放资源

JedisUtil.getInstance().returnJedis(jd);

1. 9.     异步执行

//获取连接资源

   Jedis jedis = JedisUtil.getInstance().getJedis();

   //获取管道

Pipeline pipeline = jedis.pipelined();

//执行业务以及调用jedis提供的接口功能

…

jedis.hset(…);

…

//提交并释放管道

pipeline.syncAndReturnAll();

//释放资源

JedisUtil.getInstance().returnJedis(jedis);

1. 10.  如何获取Jedis命名规则的合成KEY

//获取类的唯一键值key,例如：User:1(User为class,1为uuid)其中user继承于Reidsbean

JedisUtilEx.getInstance().getBeanKey(user);

//另一种获取类的唯一键值key的方法

JedisUtilEx.getInstance().getBeanKey(String uuid,Class<T> cls);

//获取bean对应的KEY(对应列的唯一键值key)

JedisUtilEx.getInstance().getBeanKey(String uuid,Class<T> cls,String... fileds);

//获取bean对应的KEY(集群key)

JedisUtilEx.getInstance().getBeanKey(Class<T> cls,String... fileds);

四、jedis操作命令：

1.对value操作的命令

     exists(key)：确认一个key是否存在

     del(key)：删除一个key

     type(key)：返回值的类型

     keys(pattern)：返回满足给定pattern的所有key

     randomkey：随机返回key空间的一个key

     rename(oldname, newname)：将key由oldname重命名为newname，若newname存在则删除newname表示的key

     dbsize：返回当前数据库中key的数目

     expire：设定一个key的活动时间（s）

     ttl：获得一个key的活动时间

     select(index)：按索引查询

     move(key, dbindex)：将当前数据库中的key转移到有dbindex索引的数据库

     flushdb：删除当前选择数据库中的所有key

     flushall：删除所有数据库中的所有key

2.对String操作的命令

     set(key, value)：给数据库中名称为key的string赋予值value

     get(key)：返回数据库中名称为key的string的value

     getset(key, value)：给名称为key的string赋予上一次的value

     mget(key1, key2,…, key N)：返回库中多个string（它们的名称为key1，key2…）的value

     setnx(key, value)：如果不存在名称为key的string，则向库中添加string，名称为key，值为value

     setex(key, time, value)：向库中添加string（名称为key，值为value）同时，设定过期时间time

     mset(key1, value1, key2, value2,…key N, value N)：同时给多个string赋值，名称为key i的string赋值value i

     msetnx(key1, value1, key2, value2,…key N, value N)：如果所有名称为key i的string都不存在，则向库中添加string，名称key i赋值为value i

     incr(key)：名称为key的string增1操作

     incrby(key, integer)：名称为key的string增加integer

     decr(key)：名称为key的string减1操作

     decrby(key, integer)：名称为key的string减少integer

     append(key, value)：名称为key的string的值附加value

     substr(key, start, end)：返回名称为key的string的value的子串

3.对List操作的命令

     rpush(key, value)：在名称为key的list尾添加一个值为value的元素

     lpush(key, value)：在名称为key的list头添加一个值为value的 元素

     llen(key)：返回名称为key的list的长度

     lrange(key, start, end)：返回名称为key的list中start至end之间的元素（下标从0开始，下同）

     ltrim(key, start, end)：截取名称为key的list，保留start至end之间的元素

     lindex(key, index)：返回名称为key的list中index位置的元素

     lset(key, index, value)：给名称为key的list中index位置的元素赋值为value

     lrem(key, count, value)：删除count个名称为key的list中值为value的元素。count为0，删除所有值为value的元素，count>0      从头至尾删除count个值为value的元素，count<0从尾到头删除|count|个值为value的元素。

     lpop(key)：返回并删除名称为key的list中的首元素

     rpop(key)：返回并删除名称为key的list中的尾元素

     blpop(key1, key2,… key N, timeout)：lpop 命令的block版本。即当timeout为0时，若遇到名称为key i的list不存在或该list为空，则命令结束。如果 timeout>0，则遇到上述情况时，等待timeout秒，如果问题没有解决，则对key i+1开始的list执行pop操作。

     brpop(key1, key2,… key N, timeout)：rpop的block版本。参考上一命令。

     rpoplpush(srckey, dstkey)：返回并删除名称为srckey的list的尾元素，并将该元素添加到名称为dstkey的list的头部

4.对Set操作的命令

     sadd(key, member)：向名称为key的set中添加元素member

     srem(key, member) ：删除名称为key的set中的元素member

     spop(key) ：随机返回并删除名称为key的set中一个元素

     smove(srckey, dstkey, member) ：将member元素从名称为srckey的集合移到名称为dstkey的集合

     scard(key) ：返回名称为key的set的基数

     sismember(key, member) ：测试member是否是名称为key的set的元素

     sinter(key1, key2,…key N) ：求交集

     sinterstore(dstkey, key1, key2,…key N) ：求交集并将交集保存到dstkey的集合

     sunion(key1, key2,…key N) ：求并集

     sunionstore(dstkey, key1, key2,…key N) ：求并集并将并集保存到dstkey的集合

     sdiff(key1, key2,…key N) ：求差集

     sdiffstore(dstkey, key1, key2,…key N) ：求差集并将差集保存到dstkey的集合

     smembers(key) ：返回名称为key的set的所有元素

     srandmember(key) ：随机返回名称为key的set的一个元素

5.对zset（sorted set）操作的命令

     zadd(key, score, member)：向名称为key的zset中添加元素member，score用于排序。如果该元素已经存在，则根据score更新该元素的顺序。

     zrem(key, member) ：删除名称为key的zset中的元素member

     zincrby(key, increment, member) ：如果在名称为key的zset中已经存在元素member，则该元素的score增加increment；否则向集合中添加该元素，其score的值为increment

     zrank(key, member) ：返回名称为key的zset（元素已按score从小到大排序）中member元素的rank（即index，从0开始），若没有member元素，返回“nil”

     zrevrank(key, member) ：返回名称为key的zset（元素已按score从大到小排序）中member元素的rank（即index，从0开始），若没有member元素，返回“nil”

     zrange(key, start, end)：返回名称为key的zset（元素已按score从小到大排序）中的index从start到end的所有元素

     zrevrange(key, start, end)：返回名称为key的zset（元素已按score从大到小排序）中的index从start到end的所有元素

     zrangebyscore(key, min, max)：返回名称为key的zset中score >= min且score <= max的所有元素

     zcard(key)：返回名称为key的zset的基数

     zscore(key, element)：返回名称为key的zset中元素element的score

     zremrangebyrank(key, min, max)：删除名称为key的zset中rank >= min且rank <= max的所有元素

     zremrangebyscore(key, min, max) ：删除名称为key的zset中score >= min且score <= max的所有元素

     zunionstore / zinterstore(dstkeyN, key1,…,keyN, WEIGHTS w1,…wN, AGGREGATE SUM|MIN|MAX)：对N个zset求并集和交集，并将最后的集合保存在dstkeyN中。对于集合中每一个元素的score，在进行AGGREGATE运算前，都要乘以对于的WEIGHT参数。如果没有提供WEIGHT，默认为1。默认的AGGREGATE是SUM，即结果集合中元素的score是所有集合对应元素进行 SUM运算的值，而MIN和MAX是指，结果集合中元素的score是所有集合对应元素中最小值和最大值。

6.对Hash操作的命令

     hset(key, field, value)：向名称为key的hash中添加元素field<—>value

     hget(key, field)：返回名称为key的hash中field对应的value

     hmget(key, field1, …,field N)：返回名称为key的hash中field i对应的value

     hmset(key, field1, value1,…,field N, value N)：向名称为key的hash中添加元素field i<—>value i

     hincrby(key, field, integer)：将名称为key的hash中field的value增加integer

     hexists(key, field)：名称为key的hash中是否存在键为field的域

     hdel(key, field)：删除名称为key的hash中键为field的域

     hlen(key)：返回名称为key的hash中元素个数

     hkeys(key)：返回名称为key的hash中所有键

     hvals(key)：返回名称为key的hash中所有键对应的value

     hgetall(key)：返回名称为key的hash中所有的键（field）及其对应的value

五、Redis命名规则

由于Redis所有数据为键值对，即所有数据均只能通过键值（Key）来进行管理，故需

要规范命名规则，jedis客户端包装了有专门的命名规则生产函数，调用即可！代码参考实例代码：

http://www.cnblogs.com/3chi/p/7209457.html