com.lambdaworks.redis.api.async

Interface RedisListAsyncCommands<K,V>

Type Parameters:

K - Key type.

V - Value type.

All Known Subinterfaces:

RedisAdvancedClusterAsyncCommands<K,V>, RedisAsyncCommands<K,V>, RedisClusterAsyncCommands<K,V>, RedisPubSubAsyncCommands<K,V>

All Known Implementing Classes:

AbstractRedisAsyncCommands, RedisAdvancedClusterAsyncCommandsImpl, RedisAsyncCommandsImpl, RedisPubSubAsyncCommandsImpl

public interface RedisListAsyncCommands<K,V>

Asynchronous executed commands for Lists.

Since:

4.0

Author:

Mark Paluch

Generated class:

by com.lambdaworks.apigenerator.CreateAsyncApi

Method Summary

Modifier and Type	Method and Description
RedisFuture<KeyValue<K,V>>	blpop(long timeout, K... keys) Remove and get the first element in a list, or block until one is available.
RedisFuture<KeyValue<K,V>>	brpop(long timeout, K... keys) Remove and get the last element in a list, or block until one is available.
RedisFuture<V>	brpoplpush(long timeout, K source, K destination) Pop a value from a list, push it to another list and return it; or block until one is available.
RedisFuture<V>	lindex(K key, long index) Get an element from a list by its index.
RedisFuture<Long>	linsert(K key, boolean before, V pivot, V value) Insert an element before or after another element in a list.
RedisFuture<Long>	llen(K key) Get the length of a list.
RedisFuture<V>	lpop(K key) Remove and get the first element in a list.
RedisFuture<Long>	lpush(K key, V... values) Prepend one or multiple values to a list.
RedisFuture<Long>	lpushx(K key, V value) Prepend a value to a list, only if the list exists.
RedisFuture<List<V>>	lrange(K key, long start, long stop) Get a range of elements from a list.
RedisFuture<Long>	lrange(ValueStreamingChannel<V> channel, K key, long start, long stop) Get a range of elements from a list.
RedisFuture<Long>	lrem(K key, long count, V value) Remove elements from a list.
RedisFuture<String>	lset(K key, long index, V value) Set the value of an element in a list by its index.
RedisFuture<String>	ltrim(K key, long start, long stop) Trim a list to the specified range.
RedisFuture<V>	rpop(K key) Remove and get the last element in a list.
RedisFuture<V>	rpoplpush(K source, K destination) Remove the last element in a list, append it to another list and return it.
RedisFuture<Long>	rpush(K key, V... values) Append one or multiple values to a list.
RedisFuture<Long>	rpushx(K key, V value) Append a value to a list, only if the list exists.

Method Detail

blpop

RedisFuture<KeyValue<K,V>> blpop(long timeout,
                                 K... keys)

Remove and get the first element in a list, or block until one is available.

Parameters:

timeout - the key

keys - the timeout type: long

Returns:

KeyValue<K,V> array-reply specifically: A null multi-bulk when no element could be popped and the timeout expired. A two-element multi-bulk with the first element being the name of the key where an element was popped and the second element being the value of the popped element.

brpop

RedisFuture<KeyValue<K,V>> brpop(long timeout,
                                 K... keys)

Remove and get the last element in a list, or block until one is available.

Parameters:

timeout - the key

keys - the timeout type: long

Returns:

KeyValue<K,V> array-reply specifically: A null multi-bulk when no element could be popped and the timeout expired. A two-element multi-bulk with the first element being the name of the key where an element was popped and the second element being the value of the popped element.

brpoplpush

RedisFuture<V> brpoplpush(long timeout,
                          K source,
                          K destination)

Pop a value from a list, push it to another list and return it; or block until one is available.

Parameters:

timeout - the source type: key

source - the destination type: key

destination - the timeout type: long

Returns:

V bulk-string-reply the element being popped from source and pushed to destination. If timeout is reached, a

lindex

RedisFuture<V> lindex(K key,
                      long index)

Get an element from a list by its index.

Parameters:

key - the key

index - the index type: long

Returns:

V bulk-string-reply the requested element, or null when index is out of range.

linsert

RedisFuture<Long> linsert(K key,
                          boolean before,
                          V pivot,
                          V value)

Insert an element before or after another element in a list.

Parameters:

key - the key

before - the before

pivot - the pivot

value - the value

Returns:

Long integer-reply the length of the list after the insert operation, or -1 when the value pivot was not found.

llen

RedisFuture<Long> llen(K key)

Get the length of a list.

Parameters:

key - the key

Returns:

Long integer-reply the length of the list at key.

lpop

RedisFuture<V> lpop(K key)

Remove and get the first element in a list.

Parameters:

key - the key

Returns:

V bulk-string-reply the value of the first element, or null when key does not exist.

lpush

RedisFuture<Long> lpush(K key,
                        V... values)

Prepend one or multiple values to a list.

Parameters:

key - the key

values - the value

Returns:

Long integer-reply the length of the list after the push operations.

lpushx

RedisFuture<Long> lpushx(K key,
                         V value)

Prepend a value to a list, only if the list exists.

Parameters:

key - the key

value - the value

Returns:

Long integer-reply the length of the list after the push operation.

lrange

RedisFuture<List<V>> lrange(K key,
                            long start,
                            long stop)

Get a range of elements from a list.

Parameters:

key - the key

start - the start type: long

stop - the stop type: long

Returns:

List<V> array-reply list of elements in the specified range.

lrange

RedisFuture<Long> lrange(ValueStreamingChannel<V> channel,
                         K key,
                         long start,
                         long stop)

Get a range of elements from a list.

Parameters:

channel - the channel

key - the key

start - the start type: long

stop - the stop type: long

Returns:

Long count of elements in the specified range.

lrem

RedisFuture<Long> lrem(K key,
                       long count,
                       V value)

Remove elements from a list.

Parameters:

key - the key

count - the count type: long

value - the value

Returns:

Long integer-reply the number of removed elements.

lset

RedisFuture<String> lset(K key,
                         long index,
                         V value)

Set the value of an element in a list by its index.

Parameters:

key - the key

index - the index type: long

value - the value

Returns:

String simple-string-reply

ltrim

RedisFuture<String> ltrim(K key,
                          long start,
                          long stop)

Trim a list to the specified range.

Parameters:

key - the key

start - the start type: long

stop - the stop type: long

Returns:

String simple-string-reply

rpop

RedisFuture<V> rpop(K key)

Remove and get the last element in a list.

Parameters:

key - the key

Returns:

V bulk-string-reply the value of the last element, or null when key does not exist.

rpoplpush

RedisFuture<V> rpoplpush(K source,
                         K destination)

Remove the last element in a list, append it to another list and return it.

Parameters:

source - the source type: key

destination - the destination type: key

Returns:

V bulk-string-reply the element being popped and pushed.

rpush

RedisFuture<Long> rpush(K key,
                        V... values)

Append one or multiple values to a list.

Parameters:

key - the key

values - the value

Returns:

Long integer-reply the length of the list after the push operation.

rpushx

RedisFuture<Long> rpushx(K key,
                         V value)

Append a value to a list, only if the list exists.

Parameters:

key - the key

value - the value

Returns:

Long integer-reply the length of the list after the push operation.