Jedis操作Redis--List类型

Posted Laymen

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了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));
    }
}

 

以上是关于Jedis操作Redis--List类型的主要内容,如果未能解决你的问题,请参考以下文章

Redis - list类型操作

redis的数据类型List,其原生命令和php操作Redis List函数介绍

Redis list数据类型

Jedis入门及对Redis数据结构的操作

Jedis操作Redis--Set类型

Jedis操作Redis--SortedSet类型