1. 程式人生 > >Jedis操作Redis--List型別

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));
    }
}