Jedis操做Redis--List類型

/**
 * List（列表）
 * BLPOP,BRPOP,BRPOPLPUSH,LINDEX,LINSERT,LLEN,LPOP,LPUSH,LPUSHX,LRANGE,LREM,LSET,LTRIM, RPOP,RPOPLPUSH,RPUSH,RPUSHX
 */
public class ListTypeTest {
    private Jedis jedis;

    private static final String KEY = "list";

    private static final String VALUE = "layman";

    @Before
    public void setUp() {
        this.jedis = new Jedis(new JedisShardInfo("192.168.133.188", 6379));
    }

    /**
     * LPUSH key value [value ...]  將一個或多個值 value 插入到列表 key 的表頭
     * 若是有多個 value 值，那麼各個 value 值按從左到右的順序依次插入到表頭： 好比說，對空列表 mylist 執行命令 LPUSH mylist a b c ，列表的值將是 c b a ，
     * 這等同於原子性地執行 LPUSH mylist a 、 LPUSH mylist b 和 LPUSH mylist c 三個命令。
     * 若是 key 不存在，一個空列表會被建立並執行 LPUSH 操做。
     * <p/>
     * LPUSHX key value
     * 將值 value 插入到列表 key 的表頭，當且僅當 key 存在而且是一個列表。
     * 和 LPUSH 命令相反，當 key 不存在時， LPUSHX 命令什麼也不作。
     * <p/>
     * RPUSH key value [value ...] 將一個或多個值 value 插入到列表 key 的表尾(最右邊)。
     * <p/>
     * RPUSHX key value
     * 將值 value 插入到列表 key 的表尾，當且僅當 key 存在而且是一個列表。
     * 和 RPUSH 命令相反，當 key 不存在時， RPUSHX 命令什麼也不作。
     */
    @Test
    public void LPUSH() {
        jedis.lpush(KEY, VALUE, VALUE + "1");
        LRANGE();
    }

    /**
     * LPOP key
     * 移除並返回列表 key 的頭元素。
     * <p/>
     * RPOP key
     * 移除並返回列表 key 的尾元素。
     */
    @Test
    public void LPOP() {
        LRANGE();
        jedis.lpop(KEY);
        LRANGE();
    }

    /**
     * BLPOP key [key ...] timeout
     * BLPOP 是列表的阻塞式(blocking)彈出原語。
     * 它是 LPOP 命令的阻塞版本，當給定列表內沒有任何元素可供彈出的時候，鏈接將被 BLPOP 命令阻塞，直到等待超時或發現可彈出元素爲止。
     * 當給定多個 key 參數時，按參數 key 的前後順序依次檢查各個列表，彈出第一個非空列表的頭元素。
     * 非阻塞行爲:
     * 當 BLPOP 被調用時，若是給定 key 內至少有一個非空列表，那麼彈出遇到的第一個非空列表的頭元素，並和被彈出元素所屬的列表的名字一塊兒，組成結果返回給調用者。
     * 當存在多個給定 key 時， BLPOP 按給定 key 參數排列的前後順序，依次檢查各個列表。
     * 假設如今有 job 、 command 和 request 三個列表，其中 job 不存在， command 和 request 都持有非空列表。考慮如下命令：BLPOP job command request 0
     * <p/>
     * 超時參數 timeout 接受一個以秒爲單位的數字做爲值。超時參數設爲 0 表示阻塞時間能夠無限期延長(block indefinitely) 。
     * <p/>
     * BRPOP key [key ...] timeout
     * 它是 RPOP 命令的阻塞版本，當給定列表內沒有任何元素可供彈出的時候，鏈接將被 BRPOP 命令阻塞，直到等待超時或發現可彈出元素爲止。
     * BRPOP 除了彈出元素的位置和 BLPOP 不一樣以外，其餘表現一致。
     */
    @Test
    public void BLPOP() throws InterruptedException {
        LRANGE();
        //返回的list第一個元素爲返回值列表的key值，第二個元素爲返回的值
        List<String> blpop = jedis.blpop(5, KEY);
        System.out.println(blpop);
        jedis.blpop(5, KEY);
    }

    /**
     * RPOPLPUSH source destination
     * 命令 RPOPLPUSH 在一個原子時間內，執行如下兩個動做：
     * 1,將列表 source 中的最後一個元素(尾元素)彈出，並返回給客戶端。
     * 2,將 source 彈出的元素插入到列表 destination ，做爲 destination 列表的的頭元素。
     * 舉個例子，你有兩個列表 source 和 destination ， source 列表有元素 a, b, c ， destination 列表有元素 x, y, z ，
     * 執行 RPOPLPUSH source destination以後，source列表包含元素a,b,destination列表包含元素 c, x, y, z,而且元素c會被返回給客戶端。
     * 若是 source 不存在，值 nil 被返回，而且不執行其餘動做。
     * 若是 source 和 destination 相同，則列表中的表尾元素被移動到表頭，並返回該元素，能夠把這種特殊狀況視做列表的旋轉(rotation)
     * <p/>
     * BRPOPLPUSH source destination timeout
     * BRPOPLPUSH 是 RPOPLPUSH 的阻塞版本，當給定列表 source 不爲空時， BRPOPLPUSH 的表現和 RPOPLPUSH 同樣。
     * 當列表 source 爲空時， BRPOPLPUSH 命令將阻塞鏈接，直到等待超時，或有另外一個客戶端對 source 執行 LPUSH 或 RPUSH 命令爲止。
     * 超時參數 timeout 接受一個以秒爲單位的數字做爲值。超時參數設爲 0 表示阻塞時間能夠無限期延長(block indefinitely) 。
     */
    @Test
    public void RPOPLPUSH() {
        LPUSH();
        jedis.rpoplpush(KEY, KEY);
        LRANGE();
    }

    /**
     * LINDEX key index
     * 返回列表 key 中，下標爲 index 的元素。
     * 下標(index)參數 start 和 stop 都以 0 爲底，也就是說，以 0 表示列表的第一個元素，以 1 表示列表的第二個元素，以此類推。
     * 你也可使用負數下標，以 -1 表示列表的最後一個元素， -2 表示列表的倒數第二個元素，以此類推。
     * 若是 key 不是列表類型，返回一個錯誤。
     */
    @Test
    public void LINDEX() {
        System.out.println(jedis.lindex(KEY, 1));
    }

    /**
     * LSET key index value
     * 將列表 key 下標爲 index 的元素的值設置爲 value 。
     * 當 index 參數超出範圍，或對一個空列表( key 不存在)進行 LSET 時，返回一個錯誤。
     * 關於列表下標的更多信息，請參考 LINDEX 命令。
     */
    @Test
    public void LSET() {
        LRANGE();
        jedis.lset(KEY, 0, VALUE + "0");
        LRANGE();
    }

    /**
     * LINSERT key BEFORE|AFTER pivot value
     * 將值 value 插入到列表 key 當中，位於值 pivot 以前或以後。
     * 當 pivot 不存在於列表 key 時，不執行任何操做。
     * 當 key 不存在時， key 被視爲空列表，不執行任何操做。
     * 若是 key 不是列表類型，返回一個錯誤。
     */
    @Test
    public void LINSERT() {
        LRANGE();
        jedis.linsert(KEY, BinaryClient.LIST_POSITION.AFTER, VALUE, "insert");
        LRANGE();
    }

    /**
     * LTRIM key start stop
     * 對一個列表進行修剪(trim)，就是說，讓列表只保留指定區間內的元素，不在指定區間以內的元素都將被刪除。
     * 舉個例子，執行命令 LTRIM list 0 2 ，表示只保留列表 list 的前三個元素，其他元素所有刪除。
     * 下標(index)參數 start 和 stop 都以 0 爲底，也就是說，以 0 表示列表的第一個元素，以 1 表示列表的第二個元素，以此類推。
     * 你也可使用負數下標，以 -1 表示列表的最後一個元素， -2 表示列表的倒數第二個元素，以此類推。
     */
    @Test
    public void LTRIM() {
        LRANGE();
        jedis.ltrim(KEY, 0, 1);
        LRANGE();
    }

    /**
     * LREM key count value
     * 根據參數 count 的值，移除列表中與參數 value 相等的元素。
     * count 的值能夠是如下幾種：
     * count > 0 : 從表頭開始向表尾搜索，移除與 value 相等的元素，數量爲 count 。
     * count < 0 : 從表尾開始向表頭搜索，移除與 value 相等的元素，數量爲 count 的絕對值。
     * count = 0 : 移除表中全部與 value 相等的值。
     */
    @Test
    public void LREM() {
        jedis.rpush(KEY, "A", "B", "A", "C", "A", "D");
        LRANGE();
        jedis.lrem(KEY, -2, "A");
        LRANGE();
    }

    /**
     * LLEN key
     * 返回列表 key 的長度。
     * 若是 key 不存在，則 key 被解釋爲一個空列表，返回 0 .
     * 若是 key 不是列表類型，返回一個錯誤。
     */
    @Test
    public void LLEN() {
        System.out.println(jedis.llen(KEY));
    }

    /**
     * LRANGE key start stop
     * 返回列表 key 中指定區間內的元素，區間以偏移量 start 和 stop 指定。
     * 下標(index)參數 start 和 stop 都以 0 爲底，也就是說，以 0 表示列表的第一個元素，以 1 表示列表的第二個元素，以此類推。
     * 你也可使用負數下標，以 -1 表示列表的最後一個元素， -2 表示列表的倒數第二個元素，以此類推。
     */
    @Test
    public void LRANGE() {
        System.out.println(jedis.lrange(KEY, 0, -1));
    }
}