List類型對應的jedis操作詳解
在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)
#返回指定范圍內元素的列表。該命令的參數start和end都是0-based。即0表示鏈表頭部(leftmost)的第一個元素。其中start的值也可以為負值,-1將表示鏈表中的最后一個元素,即尾部元素,-2表示倒數第二個并以此類推。該命令在獲取元素時,start和end位置上的元素也會被取出。如果start的值大于鏈表中元素的數量,空鏈表將會被返回。如果end的值大于元素的數量,該命令則獲取從start(包括start)開始,鏈表中剩余的所有元素。
List<byte[]> lrange(final String key, final long start, final long end)
#該命令將僅保留指定范圍內的元素,從而保證鏈接中的元素數量相對恒定。start和stop參數都是0-based,0表示頭部元素。和其他命令一樣,start和stop也可以為負值,-1表示尾部元素。如果start大于鏈表的尾部,或start大于stop,該命令不錯報錯,而是返回一個空的鏈表,與此同時該Key也將被刪除。如果stop大于元素的數量,則保留從start開始剩余的所有元素。
void ltrim(final String key, final long start, final long end)
#該命令將返回鏈表中指定位置(index)的元素,index是0-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,同時不再做任何其它的操作了。如果srckey和dstkey是同一個鍵,則相當于原子性的將其關聯鏈表中的尾部元素移到該鏈表的頭部。
byte[] rpoplpush(final String srckey, final String dstkey)