List类型对应的jedis操作详解

jopen 10年前

Redis中,List类型是按照插入顺序排序的字符串链表。和数据结构中的普通链表一样,我们可以在其头部(left)和尾部(right)添加新的元素。在插入时,如果该键并不存在,Redis将为该键创建一个新的链表。与此相反,如果链表中所有的元素均被移除,那么该键也将会被从数据库中删除。List中可以包含的最大元素数量是4,294,967,295(42亿左右)

#在指定Key所关联的List Value的尾部插入参数中给出的所有Values。如果该Key不存在,该命令将在插入之前创建一个与该Key关联的空链表,之后再将数据从链表的尾部插入。如果该键的Value不是链表类型,该命令将返回相关的错误信息。

void rpush(final String key, final String... string)

#在指定Key所关联的List Value的头部插入参数中给出的所有Values。如果该Key不存在,该命令将在插入之前创建一个与该Key关联的空链表,之后再将数据从链表的头部插入。如果该键的Value不是链表类型,该命令将返回相关的错误信息。

void lpush(final String key, final String... string)

#返回指定Key关联的链表中元素的数量,如果该Key不存在,则返回0。如果与该Key关联的Value的类型不是链表,则返回相关的错误信息。

long llen(final String key)

#返回指定范围内元素的列表。该命令的参数startend都是0-based。即0表示链表头部(leftmost)的第一个元素。其中start的值也可以为负值,-1将表示链表中的最后一个元素,即尾部元素,-2表示倒数第二个并以此类推。该命令在获取元素时,startend位置上的元素也会被取出。如果start的值大于链表中元素的数量,空链表将会被返回。如果end的值大于元素的数量,该命令则获取从start(包括start)开始,链表中剩余的所有元素。

List<byte[]> lrange(final String key, final long start, final long end)

#该命令将仅保留指定范围内的元素,从而保证链接中的元素数量相对恒定。startstop参数都是0-based0表示头部元素。和其他命令一样,startstop也可以为负值,-1表示尾部元素。如果start大于链表的尾部,或start大于stop,该命令不错报错,而是返回一个空的链表,与此同时该Key也将被删除。如果stop大于元素的数量,则保留从start开始剩余的所有元素。

void ltrim(final String key, final long start, final long end)

#该命令将返回链表中指定位置(index)的元素,index0-based,表示头部元素,如果index-1,表示尾部元素。如果与该Key关联的不是链表,该命令将返回相关的错误信息。

byte[] lindex(final String key, final long index)

#设定链表中指定位置的值为新值,其中0表示第一个元素,即头部元素,-1表示尾部元素。如果索引值Index超出了链表中元素的数量范围,该命令将返回相关的错误信息。

void lset(final String key, final long index, final String value)

#在指定Key关联的链表中,删除前count个值等于value的元素。如果count大于0,从头向尾遍历并删除,如果count小于0,则从尾向头遍历并删除。如果count等于0,则删除链表中所有等于value的元素。如果指定的Key不存在,则直接返回0,返回被删除的元素数量。

long lrem(final String key, long count, final String value)

#返回并弹出指定Key关联的链表中的第一个元素,即头部元素。如果该Key不存,返回null

byte[] lpop(final String key)

#返回并弹出指定Key关联的链表中的最后一个元素,即尾部元素。如果该Key不存,返回nil

byte[] rpop(final String key)

#原子性的从与srckey键关联的链表尾部弹出一个元素,同时再将弹出的元素插入到与dstkey键关联的链表的头部。如果srckey键不存在,该命令将返回null,同时不再做任何其它的操作了。如果srckeydstkey是同一个键,则相当于原子性的将其关联链表中的尾部元素移到该链表的头部。

byte[] rpoplpush(final String srckey, final String dstkey)