org.springframework.data.redis.core

Interface ListOperations<K,V>

public interface ListOperations<K,V>

Redis list specific operations.

Author:

Costin Leau, David Liu, Thomas Darimont, Christoph Strobl, Mark Paluch

Method Summary

Modifier and Type	Method and Description
RedisOperations<K,V>	getOperations()
V	index(K key, long index) Get element at index form list at key.
V	leftPop(K key) Removes and returns first element in list stored at key.
V	leftPop(K key, long timeout, TimeUnit unit) Removes and returns first element from lists stored at key .
Long	leftPush(K key, V value) Prepend value to key.
Long	leftPush(K key, V pivot, V value) Prepend values to key before value.
Long	leftPushAll(K key, Collection<V> values) Prepend values to key.
Long	leftPushAll(K key, V... values) Prepend values to key.
Long	leftPushIfPresent(K key, V value) Prepend values to key only if the list exists.
List<V>	range(K key, long start, long end) Get elements between begin and end from list at key.
Long	remove(K key, long count, Object value) Removes the first count occurrences of value from the list stored at key.
V	rightPop(K key) Removes and returns last element in list stored at key.
V	rightPop(K key, long timeout, TimeUnit unit) Removes and returns last element from lists stored at key.
V	rightPopAndLeftPush(K sourceKey, K destinationKey) Remove the last element from list at sourceKey, append it to destinationKey and return its value.
V	rightPopAndLeftPush(K sourceKey, K destinationKey, long timeout, TimeUnit unit) Remove the last element from list at srcKey, append it to dstKey and return its value.
Long	rightPush(K key, V value) Append value to key.
Long	rightPush(K key, V pivot, V value) Append values to key before value.
Long	rightPushAll(K key, Collection<V> values) Append values to key.
Long	rightPushAll(K key, V... values) Append values to key.
Long	rightPushIfPresent(K key, V value) Append values to key only if the list exists.
void	set(K key, long index, V value) Set the value list element at index.
Long	size(K key) Get the size of list stored at key.
void	trim(K key, long start, long end) Trim list at key to elements between start and end.

Method Detail

range

@Nullable
List<V> range(K key,
                        long start,
                        long end)

Get elements between begin and end from list at key.

Parameters:

key - must not be null.

start -

end -

Returns:

null when used in pipeline / transaction.

See Also:

Redis Documentation: LRANGE

trim

void trim(K 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

size

@Nullable
Long size(K 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

leftPush

@Nullable
Long leftPush(K key,
                        V value)

Prepend value to key.

Parameters:

key - must not be null.

value -

Returns:

null when used in pipeline / transaction.

See Also:

Redis Documentation: LPUSH

leftPushAll

@Nullable
Long leftPushAll(K key,
                           V... values)

Prepend values to key.

Parameters:

key - must not be null.

values -

Returns:

null when used in pipeline / transaction.

See Also:

Redis Documentation: LPUSH

leftPushAll

@Nullable
Long leftPushAll(K key,
                           Collection<V> values)

Prepend values to key.

Parameters:

key - must not be null.

values - must not be null.

Returns:

null when used in pipeline / transaction.

Since:

1.5

See Also:

Redis Documentation: LPUSH

leftPushIfPresent

@Nullable
Long leftPushIfPresent(K key,
                                 V value)

Prepend values to key only if the list exists.

Parameters:

key - must not be null.

value -

Returns:

null when used in pipeline / transaction.

See Also:

Redis Documentation: LPUSHX

leftPush

@Nullable
Long leftPush(K key,
                        V pivot,
                        V value)

Prepend values to key before value.

Parameters:

key - must not be null.

value -

Returns:

null when used in pipeline / transaction.

See Also:

Redis Documentation: LPUSH

rightPush

@Nullable
Long rightPush(K key,
                         V value)

Append value to key.

Parameters:

key - must not be null.

value -

Returns:

null when used in pipeline / transaction.

See Also:

Redis Documentation: RPUSH

rightPushAll

@Nullable
Long rightPushAll(K key,
                            V... values)

Append values to key.

Parameters:

key - must not be null.

values -

Returns:

null when used in pipeline / transaction.

See Also:

Redis Documentation: RPUSH

rightPushAll

@Nullable
Long rightPushAll(K key,
                            Collection<V> values)

Append values to key.

Parameters:

key - must not be null.

values -

Returns:

null when used in pipeline / transaction.

Since:

1.5

See Also:

Redis Documentation: RPUSH

rightPushIfPresent

@Nullable
Long rightPushIfPresent(K key,
                                  V value)

Append values to key only if the list exists.

Parameters:

key - must not be null.

value -

Returns:

null when used in pipeline / transaction.

See Also:

Redis Documentation: RPUSHX

rightPush

@Nullable
Long rightPush(K key,
                         V pivot,
                         V value)

Append values to key before value.

Parameters:

key - must not be null.

value -

Returns:

null when used in pipeline / transaction.

See Also:

Redis Documentation: RPUSH

set

void set(K key,
         long index,
         V value)

Set the value list element at index.

Parameters:

key - must not be null.

index -

value -

See Also:

Redis Documentation: LSET

remove

@Nullable
Long remove(K key,
                      long count,
                      Object 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

index

@Nullable
V index(K key,
                  long index)

Get element at index form list at key.

Parameters:

key - must not be null.

index -

Returns:

null when used in pipeline / transaction.

See Also:

Redis Documentation: LINDEX

leftPop

@Nullable
V leftPop(K key)

Removes and returns first element in list stored at key.

Parameters:

key - must not be null.

Returns:

can be null.

See Also:

Redis Documentation: LPOP

leftPop

@Nullable
V leftPop(K key,
                    long timeout,
                    TimeUnit unit)

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

Parameters:

key - must not be null.

timeout -

unit - must not be null.

Returns:

can be null.

See Also:

Redis Documentation: BLPOP

rightPop

@Nullable
V rightPop(K key)

Removes and returns last element in list stored at key.

Parameters:

key - must not be null.

Returns:

can be null.

See Also:

Redis Documentation: RPOP

rightPop

@Nullable
V rightPop(K key,
                     long timeout,
                     TimeUnit unit)

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

Parameters:

key - must not be null.

timeout -

unit - must not be null.

Returns:

can be null.

See Also:

Redis Documentation: BRPOP

rightPopAndLeftPush

@Nullable
V rightPopAndLeftPush(K sourceKey,
                                K destinationKey)

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

Parameters:

sourceKey - must not be null.

destinationKey - must not be null.

Returns:

can be null.

See Also:

Redis Documentation: RPOPLPUSH

rightPopAndLeftPush

@Nullable
V rightPopAndLeftPush(K sourceKey,
                                K destinationKey,
                                long timeout,
                                TimeUnit unit)

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:

sourceKey - must not be null.

destinationKey - must not be null.

timeout -

unit - must not be null.

Returns:

can be null.

See Also:

Redis Documentation: BRPOPLPUSH

getOperations

RedisOperations<K,V> getOperations()