Interface RedisList<E>

Type Parameters:

E - the type of elements in this collection.

All Superinterfaces:

BlockingDeque<E>, BlockingQueue<E>, BoundKeyOperations<String>, Collection<E>, Deque<E>, Iterable<E>, List<E>, Queue<E>, RedisCollection<E>, RedisStore

All Known Implementing Classes:

DefaultRedisList

public interface RedisList<E>
extends RedisCollection<E>, List<E>, BlockingDeque<E>

Redis extension for the List contract. Supports List, Queue and Deque contracts as well as their equivalent blocking siblings BlockingDeque and BlockingDeque.

Author:

Costin Leau, Mark Paluch, John Blum

Method Summary

Modifier and Type	Method	Description
default void	addFirst(E element)
default void	addLast(E element)
static <E> RedisList<E>	create(String key, RedisOperations<String,E> operations)	Constructs a new, uncapped RedisList instance.
static <E> RedisList<E>	create(String key, RedisOperations<String,E> operations, int maxSize)	Factory method used to construct a new RedisList from a Redis list reference by the given key.
static <E> RedisList<E>	create(BoundListOperations<String,E> boundOps)	Constructs a new, uncapped DefaultRedisList instance.
static <E> RedisList<E>	create(BoundListOperations<String,E> boundOps, int maxSize)	Constructs a new DefaultRedisList.
default @Nullable E	getFirst()
default @Nullable E	getLast()
@Nullable E	moveFirstTo(RedisList<E> destination, RedisListCommands.Direction destinationPosition)	Atomically returns and removes the first element of the list stored at the bound key, and pushes the element at the first/last element (head/tail depending on the destinationPosition argument) of the list stored at destination.
@Nullable E	moveFirstTo(RedisList<E> destination, RedisListCommands.Direction destinationPosition, long timeout, TimeUnit unit)	Deprecated. since 4.1 in favor of moveFirstTo(RedisList, Direction, Duration).
@Nullable E	moveFirstTo(RedisList<E> destination, RedisListCommands.Direction destinationPosition, Duration timeout)	Atomically returns and removes the first element of the list stored at the bound key, and pushes the element at the first/last element (head/tail depending on the destinationPosition argument) of the list stored at destination.
@Nullable E	moveLastTo(RedisList<E> destination, RedisListCommands.Direction destinationPosition)	Atomically returns and removes the last element of the list stored at the bound key, and pushes the element at the first/last element (head/tail depending on the destinationPosition argument) of the list stored at destination.
@Nullable E	moveLastTo(RedisList<E> destination, RedisListCommands.Direction destinationPosition, long timeout, TimeUnit unit)	Deprecated. since 4.1 in favor of moveLastTo(RedisList, Direction, Duration).
@Nullable E	moveLastTo(RedisList<E> destination, RedisListCommands.Direction destinationPosition, Duration timeout)	Atomically returns and removes the last element of the list stored at the bound key, and pushes the element at the first/last element (head/tail depending on the destinationPosition argument) of the list stored at destination.
List<E>	range(long start, long end)	Get elements between start and end from list at the bound key.
default @Nullable E	removeFirst()
default @Nullable E	removeLast()
default RedisList<E>	reversed()	Returns a reverse-ordered view of this collection.
RedisList<E>	trim(int start, int end)	Trim list at the bound key to elements between start and end.
RedisList<E>	trim(long start, long end)	Trim list at the bound key to elements between start and end.

Methods inherited from interface BlockingDeque

add, contains, element, iterator, offer, offer, offerFirst, offerFirst, offerLast, offerLast, peek, poll, poll, pollFirst, pollLast, push, put, putFirst, putLast, remove, remove, removeFirstOccurrence, removeLastOccurrence, size, take, takeFirst, takeLast

Methods inherited from interface BlockingQueue

drainTo, drainTo, remainingCapacity

Methods inherited from interface BoundKeyOperations

expiration, expire, expire, expire, expireAt, expireAt, getExpire, getKey, getType, persist, rename

Methods inherited from interface Collection

parallelStream, removeIf, stream, toArray

Methods inherited from interface Deque

addAll, descendingIterator, peekFirst, peekLast, pollFirst, pollLast, pop

Methods inherited from interface Iterable

forEach

Methods inherited from interface List

add, add, addAll, addAll, clear, contains, containsAll, equals, get, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, replaceAll, retainAll, set, size, sort, spliterator, subList, toArray, toArray

Methods inherited from interface RedisStore

getOperations

Method Details

create

static <E> RedisList<E> create(String key,
 RedisOperations<String,E> operations)

Constructs a new, uncapped RedisList instance.

Parameters:

key - Redis key of this list.

operations - RedisOperations for the value type of this list.

Since:

2.6

create

static <E> RedisList<E> create(String key,
 RedisOperations<String,E> operations,
 int maxSize)

Factory method used to construct a new RedisList from a Redis list reference by the given key.

Parameters:

key - Redis key of this list.

operations - RedisOperations for the value type of this list.

maxSize - Integer used to constrain the size of the list.

Since:

2.6

create

static <E> RedisList<E> create(BoundListOperations<String,E> boundOps)

Constructs a new, uncapped DefaultRedisList instance.

Parameters:

boundOps - BoundListOperations for the value type of this list.

Since:

2.6

create

static <E> RedisList<E> create(BoundListOperations<String,E> boundOps,
 int maxSize)

Constructs a new DefaultRedisList.

Parameters:

boundOps - BoundListOperations for the value type of this list.

maxSize - Integer constraining the size of the list.

Since:

2.6

moveFirstTo

@Nullable E moveFirstTo(RedisList<E> destination,
 RedisListCommands.Direction destinationPosition)

Atomically returns and removes the first element of the list stored at the bound key, and pushes the element at the first/last element (head/tail depending on the destinationPosition argument) of the list stored at destination.

Parameters:

destination - must not be null.

destinationPosition - must not be null.

Returns:

Since:

2.6

See Also:

• RedisListCommands.Direction.first()
• RedisListCommands.Direction.last()

moveFirstTo

@Nullable E moveFirstTo(RedisList<E> destination,
 RedisListCommands.Direction destinationPosition,
 Duration timeout)

Atomically returns and removes the first element of the list stored at the bound key, and pushes the element at the first/last element (head/tail depending on the destinationPosition argument) of the list stored at destination.

Blocks connection until element available or timeout reached.

Parameters:

destination - must not be null.

destinationPosition - must not be null.

timeout - must not be null or negative.

Returns:

Since:

2.6

See Also:

• RedisListCommands.Direction.first()
• RedisListCommands.Direction.last()

moveFirstTo

@Deprecated(since="4.1")
@Nullable E moveFirstTo(RedisList<E> destination,
 RedisListCommands.Direction destinationPosition,
 long timeout,
 TimeUnit unit)

Deprecated.

since 4.1 in favor of moveFirstTo(RedisList, Direction, Duration).

Atomically returns and removes the first element of the list stored at the bound key, and pushes the element at the first/last element (head/tail depending on the destinationPosition argument) of the list stored at destination.

Blocks connection until element available or timeout reached.

Parameters:

destination - must not be null.

destinationPosition - must not be null.

timeout -

unit - must not be null.

Returns:

Since:

2.6

See Also:

• RedisListCommands.Direction.first()
• RedisListCommands.Direction.last()

moveLastTo

@Nullable E moveLastTo(RedisList<E> destination,
 RedisListCommands.Direction destinationPosition)

Atomically returns and removes the last element of the list stored at the bound key, and pushes the element at the first/last element (head/tail depending on the destinationPosition argument) of the list stored at destination.

Parameters:

destination - must not be null.

destinationPosition - must not be null.

Returns:

Since:

2.6

See Also:

• RedisListCommands.Direction.first()
• RedisListCommands.Direction.last()

moveLastTo

@Nullable E moveLastTo(RedisList<E> destination,
 RedisListCommands.Direction destinationPosition,
 Duration timeout)

Atomically returns and removes the last element of the list stored at the bound key, and pushes the element at the first/last element (head/tail depending on the destinationPosition argument) of the list stored at destination.

Blocks connection until element available or timeout reached.

Parameters:

destination - must not be null.

destinationPosition - must not be null.

timeout - must not be null or negative.

Returns:

Since:

2.6

See Also:

• RedisListCommands.Direction.first()
• RedisListCommands.Direction.last()

moveLastTo

@Deprecated
@Nullable E moveLastTo(RedisList<E> destination,
 RedisListCommands.Direction destinationPosition,
 long timeout,
 TimeUnit unit)

Deprecated.

since 4.1 in favor of moveLastTo(RedisList, Direction, Duration).

Atomically returns and removes the last element of the list stored at the bound key, and pushes the element at the first/last element (head/tail depending on the destinationPosition argument) of the list stored at destination.

Blocks connection until element available or timeout reached.

Parameters:

destination - must not be null.

destinationPosition - must not be null.

timeout -

unit - must not be null.

Returns:

Since:

2.6

See Also:

• RedisListCommands.Direction.first()
• RedisListCommands.Direction.last()

range

List<E> range(long start,
 long end)

Get elements between start and end from list at the bound key.

Parameters:

start -

end -

Returns:

null when used in pipeline / transaction.

See Also:

• Redis Documentation: LRANGE

trim

RedisList<E> trim(int start,
 int end)

Trim list at the bound key to elements between start and end.

Parameters:

start -

end -

See Also:

• Redis Documentation: LTRIM

trim

RedisList<E> trim(long start,
 long end)

Trim list at the bound key to elements between start and end.

Parameters:

start -

end -

Since:

2.6

See Also:

• Redis Documentation: LTRIM

addFirst

default void addFirst(E element)

This method is forward-compatible with Java 21 SequencedCollections.

Specified by:

addFirst in interface BlockingDeque<E>

Specified by:

addFirst in interface Deque<E>

Parameters:

element - element to be added to the head of the collection.

addLast

default void addLast(E element)

This method is forward-compatible with Java 21 SequencedCollections.

Specified by:

addLast in interface BlockingDeque<E>

Specified by:

addLast in interface Deque<E>

Parameters:

element - element to be added to the end of the collection.

getFirst

default @Nullable E getFirst()

This method is forward-compatible with Java 21 SequencedCollections.

Specified by:

getFirst in interface Deque<E>

Returns:

the head of this Deque.

getLast

default @Nullable E getLast()

This method is forward-compatible with Java 21 SequencedCollections.

Specified by:

getLast in interface Deque<E>

Returns:

the tail of this Deque.

removeFirst

default @Nullable E removeFirst()

This method is forward-compatible with Java 21 SequencedCollections.

Specified by:

removeFirst in interface Deque<E>

Returns:

the head of this Deque.

removeLast

default @Nullable E removeLast()

This method is forward-compatible with Java 21 SequencedCollections.

Specified by:

removeLast in interface Deque<E>

Returns:

the tail of this Deque.

reversed

default RedisList<E> reversed()

Returns a reverse-ordered view of this collection.

The encounter order of elements returned by the view is the inverse of the encounter order of the elements stored in this collection. The reverse ordering affects all order-sensitive operations, including any operations on further views of the returned view. If the collection implementation permits modifications to this view, the modifications "write-through" to the underlying collection. Changes to the underlying collection might or might not be visible in this reversed view, depending upon the implementation.

This method is forward-compatible with Java 21 SequencedCollections.

Returns:

a reverse-ordered view of this collection.