JedisCluster API 整理

windows版redis啟動服務器命令：redis-server redis.windows.conf

 圖表來自菜鳥教程：

 列表的操作命令

序號	命令及描述
1	BLPOP key1 [key2 ] timeout 移出並獲取列表的第一個元素， 如果列表沒有元素會阻塞列表直到等待超時或發現可彈出元素為止。
2	BRPOP key1 [key2 ] timeout 移出並獲取列表的最后一個元素， 如果列表沒有元素會阻塞列表直到等待超時或發現可彈出元素為止。
3	BRPOPLPUSH source destination timeout 從列表中彈出一個值，將彈出的元素插入到另外一個列表中並返回它； 如果列表沒有元素會阻塞列表直到等待超時或發現可彈出元素為止。
4	LINDEX key index 通過索引獲取列表中的元素
5	LINSERT key BEFORE|AFTER pivot value 在列表的元素前或者后插入元素
6	LLEN key 獲取列表長度
7	LPOP key 移出並獲取列表的第一個元素
8	LPUSH key value1 [value2] 將一個或多個值插入到列表頭部
9	LPUSHX key value 將一個值插入到已存在的列表頭部
10	LRANGE key start stop 獲取列表指定范圍內的元素
11	LREM key count value 移除列表元素
12	LSET key index value 通過索引設置列表元素的值
13	LTRIM key start stop 對一個列表進行修剪(trim)，就是說，讓列表只保留指定區間內的元素，不在指定區間之內的元素都將被刪除。
14	RPOP key 移除列表的最后一個元素，返回值為移除的元素。
15	RPOPLPUSH source destination 移除列表的最后一個元素，並將該元素添加到另一個列表並返回
16	RPUSH key value1 [value2] 在列表中添加一個或多個值
17	RPUSHX key value 為已存在的列表添加值

 

前提：下面的jedis變量為JedisCluster(redis.clients.jedis.JedisCluster)

1、測試key:value數據

    /**
     * 測試key:value數據
     * 集群中flushDB、keys廢棄
     */
    @Test
    public void testKey() throws InterruptedException {
        //System.out.println("清空數據："+jedis.flushDB());
        System.out.println("判斷某個鍵是否存在："+jedis.exists("username"));
        System.out.println("新增<'username','wukong'>的鍵值對："+jedis.set("username", "xiaohai"));
        System.out.println("是否存在:"+jedis.exists("username"));
        System.out.println("新增<'password','password'>的鍵值對："+jedis.set("password", "123456"));
        //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的過期時間為10s:"+jedis.expire("username", 10));
        TimeUnit.SECONDS.sleep(2); // 線程睡眠2秒System.out.println("查看鍵username的剩余生存時間："+jedis.ttl("username"));
        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"));
    }

 2、字符串操作

    /***
     * 字符串操作
     * memcached和redis同樣有append的操作，但是memcached有prepend的操作，redis中並沒有。
     * 集群中flushDB、keys、del(多個值)、mset(多個值)廢棄
     * @throws InterruptedException
     */
    @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"));
        //命令的時候才會去連接連接，集群中連接是對一個節點連接，不能判斷多個key經過crc16算法所對應的槽在一個節點上，不支持多key獲取、刪除
        //System.out.println("增加多個鍵值對："+jedis.mset("key01","value01","key02","value02"));
        //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)); // 相當截取字符串的第二個位置-第四個位置的字符串
    }

 3、整數和浮點數

 
    /***
     * 整數和浮點數
     */
    @Test
    public void testNumber() {
        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"));
        System.out.println("key3的值："+jedis.get("key3"));
        // 這里會報錯，因為key3不是整數不能做計算:redis.clients.jedis.exceptions.JedisDataException: ERR value is not an integer or out of range
        // System.out.println("key2的值減1："+jedis.decr("key3"));
    }

 4、列表

 
    /***
     * 列表
     */
    @Test
    public void testList() {
        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)); // 前面4個值
        System.out.println("===============================");
        // 刪除列表指定的值 ，第二個參數為刪除的個數（有重復時），從最左邊開始刪起，類似於出棧
        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));
    }

 5、set集合

    /***
     * set集合
     */
    @Test
    public void testSet() {
        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")); // 返回0，集合中已經存在
        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("e5是否在eleSet中："+jedis.sismember("eleSet", "e5"));
 
        // 集群下並存會報錯：redis.clients.jedis.exceptions.JedisClusterException: No way to dispatch this command to Redis Cluster because keys have different slots.
        // Redis集群，從key1集合與key2集合並存、交集、差集，兩個鍵經過crc16算法可能有不同的槽。
        /*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"));*/
        jedis.del("eleSet");
        jedis.del("eleSet1");
        jedis.del("eleSet2");
        jedis.del("eleSet3");
    }

 6、hash散列

 
    /***
     * 散列
     */
    @Test
    public void testHash() {
        Map<String,String> map = new HashMap<String,String>();
        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"));
    }

 7、zset有序集合

    /**
     * 有序集合
     */
    @Test
    public void testSortedSet() {
        Map<String,Double> map = new HashMap<String,Double>();
        map.put("key2",1.2);
        map.put("key3",4.0);
        map.put("key4",5.0);
        map.put("key5",0.2);
        // 將一個或多個 member 元素及其 score 值加入到有序集 key 當中，如果某個 member 已經是有序集的成員，那么更新這個 member 的 score 值
        // score 值可以是整數值或雙精度浮點數
        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));
    }

8、排序

    /**
     * 排序
     */
    @Test
    public void testSort() {
        jedis.lpush("collections", "ArrayList", "Vector", "Stack", "HashMap", "WeakHashMap", "LinkedHashMap");
        System.out.println("collections的內容："+jedis.lrange("collections", 0, -1));
        SortingParams sortingParameters = new SortingParams();
        // 當數據集中保存的是字符串值時，你可以用 ALPHA,默認是升序
        System.out.println("alpha排序方式：" + 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();
        // 符號 "->" 用於分割哈希表的鍵名(key name)和索引域(hash field)，格式為 "key->field"
        sortingParameters.get("user:*->name");
        sortingParameters.get("user:*->add");
        System.out.println(jedis.sort("userlist",sortingParameters));*/
    }
}