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