org.springframework.data.redis.connection

Interface RedisListCommands

All Known Subinterfaces:

DefaultedRedisClusterConnection, DefaultedRedisConnection, RedisClusterConnection, RedisCommands, RedisConnection, StringRedisConnection

All Known Implementing Classes:

AbstractRedisConnection, DefaultStringRedisConnection, JedisClusterConnection, JedisConnection, LettuceClusterConnection, LettuceConnection

public interface RedisListCommands

List-specific commands supported by Redis.

Author:

Costin Leau, Christoph Strobl, Mark Paluch

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	RedisListCommands.Position List insertion position.

Method Summary

Modifier and Type	Method and Description
List<byte[]>	bLPop(int timeout, byte[]... keys) Removes and returns first element from lists stored at keys.
List<byte[]>	bRPop(int timeout, byte[]... keys) Removes and returns last element from lists stored at keys.
byte[]	bRPopLPush(int timeout, byte[] srcKey, byte[] dstKey) Remove the last element from list at srcKey, append it to dstKey and return its value.
byte[]	lIndex(byte[] key, long index) Get element at index form list at key.
Long	lInsert(byte[] key, RedisListCommands.Position where, byte[] pivot, byte[] value) Insert value RedisListCommands.Position.BEFORE or RedisListCommands.Position.AFTER existing pivot for key.
Long	lLen(byte[] key) Get the size of list stored at key.
byte[]	lPop(byte[] key) Removes and returns first element in list stored at key.
Long	lPush(byte[] key, byte[]... values) Prepend values to key.
Long	lPushX(byte[] key, byte[] value) Prepend values to key only if the list exists.
List<byte[]>	lRange(byte[] key, long start, long end) Get elements between start and end from list at key.
Long	lRem(byte[] key, long count, byte[] value) Removes the first count occurrences of value from the list stored at key.
void	lSet(byte[] key, long index, byte[] value) Set the value list element at index.
void	lTrim(byte[] key, long start, long end) Trim list at key to elements between start and end.
byte[]	rPop(byte[] key) Removes and returns last element in list stored at key.
byte[]	rPopLPush(byte[] srcKey, byte[] dstKey) Remove the last element from list at srcKey, append it to dstKey and return its value.
Long	rPush(byte[] key, byte[]... values) Append values to key.
Long	rPushX(byte[] key, byte[] value) Append values to key only if the list exists.

Method Detail

rPush

@Nullable
Long rPush(byte[] key,
                     byte[]... values)

Append values to key.

Parameters:

key - must not be null.

values - must not be empty.

Returns:

null when used in pipeline / transaction.

See Also:

Redis Documentation: RPUSH

lPush

@Nullable
Long lPush(byte[] key,
                     byte[]... values)

Prepend values to key.

Parameters:

key - must not be null.

values - must not be empty.

Returns:

null when used in pipeline / transaction.

See Also:

Redis Documentation: LPUSH

rPushX

@Nullable
Long rPushX(byte[] key,
                      byte[] value)

Append values to key only if the list exists.

Parameters:

key - must not be null.

value - must not be null.

Returns:

null when used in pipeline / transaction.

See Also:

Redis Documentation: RPUSHX

lPushX

@Nullable
Long lPushX(byte[] key,
                      byte[] value)

Prepend values to key only if the list exists.

Parameters:

key - must not be null.

value - must not be null.

Returns:

null when used in pipeline / transaction.

See Also:

Redis Documentation: LPUSHX

lLen

@Nullable
Long lLen(byte[] key)

Get the size of list stored at key.

Parameters:

key - must not be null.

Returns:

null when used in pipeline / transaction.

See Also:

Redis Documentation: LLEN

lRange

@Nullable
List<byte[]> lRange(byte[] key,
                              long start,
                              long end)

Get elements between start and end from list at key.

Parameters:

key - must not be null.

start -

end -

Returns:

empty List if key does not exists or range does not contain values. null when used in pipeline / transaction.

See Also:

Redis Documentation: LRANGE

lTrim

void lTrim(byte[] key,
           long start,
           long end)

Trim list at key to elements between start and end.

Parameters:

key - must not be null.

start -

end -

See Also:

Redis Documentation: LTRIM

lIndex

@Nullable
byte[] lIndex(byte[] key,
                        long index)

Get element at index form list at key.

Parameters:

key - must not be null.

index - zero based index value. Use negative number to designate elements starting at the tail.

Returns:

null when index is out of range or when used in pipeline / transaction.

See Also:

Redis Documentation: LINDEX

lInsert

@Nullable
Long lInsert(byte[] key,
                       RedisListCommands.Position where,
                       byte[] pivot,
                       byte[] value)

Insert value RedisListCommands.Position.BEFORE or RedisListCommands.Position.AFTER existing pivot for key.

Parameters:

key - must not be null.

where - must not be null.

pivot - must not be null.

value - must not be null.

Returns:

null when used in pipeline / transaction.

See Also:

Redis Documentation: LINSERT

lSet

void lSet(byte[] key,
          long index,
          byte[] value)

Set the value list element at index.

Parameters:

key - must not be null.

index -

value -

See Also:

Redis Documentation: LSET

lRem

@Nullable
Long lRem(byte[] key,
                    long count,
                    byte[] value)

Removes the first count occurrences of value from the list stored at key.

Parameters:

key - must not be null.

count -

value -

Returns:

null when used in pipeline / transaction.

See Also:

Redis Documentation: LREM

lPop

@Nullable
byte[] lPop(byte[] key)

Removes and returns first element in list stored at key.

Parameters:

key - must not be null.

Returns:

null when key does not exist or used in pipeline / transaction.

See Also:

Redis Documentation: LPOP

rPop

@Nullable
byte[] rPop(byte[] key)

Removes and returns last element in list stored at key.

Parameters:

key - must not be null.

Returns:

null when key does not exist or used in pipeline / transaction.

See Also:

Redis Documentation: RPOP

bLPop

@Nullable
List<byte[]> bLPop(int timeout,
                             byte[]... keys)

Removes and returns first element from lists stored at keys.
Blocks connection until element available or timeout reached.

Parameters:

timeout - seconds to block.

keys - must not be null.

Returns:

empty List when no element could be popped and the timeout was reached. null when used in pipeline / transaction.

See Also:

Redis Documentation: BLPOP, lPop(byte[])

bRPop

@Nullable
List<byte[]> bRPop(int timeout,
                             byte[]... keys)

Removes and returns last element from lists stored at keys.
Blocks connection until element available or timeout reached.

Parameters:

timeout - seconds to block.

keys - must not be null.

Returns:

empty List when no element could be popped and the timeout was reached. null when used in pipeline / transaction.

See Also:

Redis Documentation: BRPOP, rPop(byte[])

rPopLPush

@Nullable
byte[] rPopLPush(byte[] srcKey,
                           byte[] dstKey)

Remove the last element from list at srcKey, append it to dstKey and return its value.

Parameters:

srcKey - must not be null.

dstKey - must not be null.

Returns:

can be null.

See Also:

Redis Documentation: RPOPLPUSH

bRPopLPush

@Nullable
byte[] bRPopLPush(int timeout,
                            byte[] srcKey,
                            byte[] dstKey)

Remove the last element from list at srcKey, append it to dstKey and return its value.
Blocks connection until element available or timeout reached.

Parameters:

timeout - seconds to block.

srcKey - must not be null.

dstKey - must not be null.

Returns:

can be null.

See Also:

Redis Documentation: BRPOPLPUSH, rPopLPush(byte[], byte[])