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

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

Append values to key.

Parameters:

key - must not be null.

values -

Returns:

See Also:

Redis Documentation: RPUSH

lPush

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

Prepend values to key.

Parameters:

key - must not be null.

values -

Returns:

See Also:

Redis Documentation: LPUSH

rPushX

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

Append values to key only if the list exists.

Parameters:

key - must not be null.

value -

Returns:

See Also:

Redis Documentation: RPUSHX

lPushX

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

Prepend values to key only if the list exists.

Parameters:

key - must not be null.

value -

Returns:

See Also:

Redis Documentation: LPUSHX

lLen

Long lLen(byte[] key)

Get the size of list stored at key.

Parameters:

key - must not be null.

Returns:

See Also:

Redis Documentation: LLEN

lRange

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:

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

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

Get element at index form list at key.

Parameters:

key - must not be null.

index -

Returns:

See Also:

Redis Documentation: LINDEX

lInsert

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 -

value -

Returns:

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

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:

See Also:

Redis Documentation: LREM

lPop

byte[] lPop(byte[] key)

Removes and returns first element in list stored at key.

Parameters:

key - must not be null.

Returns:

See Also:

Redis Documentation: LPOP

rPop

byte[] rPop(byte[] key)

Removes and returns last element in list stored at key.

Parameters:

key - must not be null.

Returns:

See Also:

Redis Documentation: RPOP

bLPop

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 -

keys - must not be null.

Returns:

See Also:

Redis Documentation: BLPOP, lPop(byte[])

bRPop

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 -

keys - must not be null.

Returns:

See Also:

Redis Documentation: BRPOP, rPop(byte[])

rPopLPush

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:

See Also:

Redis Documentation: RPOPLPUSH

bRPopLPush

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 -

srcKey - must not be null.

dstKey - must not be null.

Returns:

See Also:

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