Refine RedisList.

Add missing Javadoc. Add trim overload accepting long to avoid potential integer downcasting. Add factory methods to RedisList.

See: #2039
Original Pull Request: #2107

src/main/java/org/springframework/data/redis/support/collections/DefaultRedisList.java

@@ -69,6 +69,18 @@ public class DefaultRedisList<E> extends AbstractRedisCollection<E> implements R
 		this(operations.boundListOps(key));
 	}
 
+	/**
+	 * Constructs a new {@link DefaultRedisList} instance.
+	 *
+	 * @param key Redis key of this list.
+	 * @param operations {@link RedisOperations} for the value type of this list.
+	 * @param maxSize
+	 * @since 2.6
+	 */
+	public DefaultRedisList(String key, RedisOperations<String, E> operations, int maxSize) {
+		this(operations.boundListOps(key), maxSize);
+	}
+
 	/**
 	 * Constructs a new, uncapped {@link DefaultRedisList} instance.
 	 *
@@ -194,6 +206,16 @@ public class DefaultRedisList<E> extends AbstractRedisCollection<E> implements R
 		return this;
 	}
 
+	/*
+	 * (non-Javadoc)
+	 * @see org.springframework.data.redis.support.collections.RedisList#trim(long, long)
+	 */
+	@Override
+	public RedisList<E> trim(long start, long end) {
+		listOps.trim(start, end);
+		return this;
+	}
+
 	/*
 	 * (non-Javadoc)
 	 * @see java.util.AbstractCollection#iterator()

src/main/java/org/springframework/data/redis/support/collections/RedisCollectionFactoryBean.java

@@ -106,7 +106,7 @@ public class RedisCollectionFactoryBean implements InitializingBean, BeanNameAwa
 	private RedisStore createStore(DataType dt) {
 		switch (dt) {
 			case LIST:
-				return new DefaultRedisList(key, template);
+				return RedisList.create(key, template);
 
 			case SET:
 				return new DefaultRedisSet(key, template);

src/main/java/org/springframework/data/redis/support/collections/RedisList.java

@@ -24,6 +24,8 @@ import java.util.Queue;
 import java.util.concurrent.BlockingDeque;
 import java.util.concurrent.TimeUnit;
 
+import org.springframework.data.redis.core.BoundListOperations;
+import org.springframework.data.redis.core.RedisOperations;
 import org.springframework.data.redis.core.TimeoutUtils;
 import org.springframework.lang.Nullable;
 import org.springframework.util.Assert;
@@ -37,6 +39,50 @@ import org.springframework.util.Assert;
  */
 public interface RedisList<E> extends RedisCollection<E>, List<E>, BlockingDeque<E> {
 
+	/**
+	 * Constructs a new, uncapped {@link RedisList} instance.
+	 *
+	 * @param key Redis key of this list.
+	 * @param operations {@link RedisOperations} for the value type of this list.
+	 * @since 2.6
+	 */
+	static <E> RedisList<E> create(String key, RedisOperations<String, E> operations) {
+		return new DefaultRedisList<>(key, operations);
+	}
+
+	/**
+	 * Constructs a new {@link RedisList} instance.
+	 *
+	 * @param key Redis key of this list.
+	 * @param operations {@link RedisOperations} for the value type of this list.
+	 * @param maxSize
+	 * @since 2.6
+	 */
+	static <E> RedisList<E> create(String key, RedisOperations<String, E> operations, int maxSize) {
+		return new DefaultRedisList<>(key, operations, maxSize);
+	}
+
+	/**
+	 * Constructs a new, uncapped {@link DefaultRedisList} instance.
+	 *
+	 * @param boundOps {@link BoundListOperations} for the value type of this list.
+	 * @since 2.6
+	 */
+	static <E> RedisList<E> create(BoundListOperations<String, E> boundOps) {
+		return new DefaultRedisList<>(boundOps);
+	}
+
+	/**
+	 * Constructs a new {@link DefaultRedisList} instance.
+	 *
+	 * @param boundOps {@link BoundListOperations} for the value type of this list.
+	 * @param maxSize
+	 * @since 2.6
+	 */
+	static <E> RedisList<E> create(BoundListOperations<String, E> boundOps, int maxSize) {
+		return new DefaultRedisList<>(boundOps, maxSize);
+	}
+
 	/**
 	 * 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 {@link Direction destinationPosition} argument) of the list stored
@@ -155,7 +201,32 @@ public interface RedisList<E> extends RedisCollection<E>, List<E>, BlockingDeque
 	@Nullable
 	E moveLastTo(RedisList<E> destination, Direction destinationPosition, long timeout, TimeUnit unit);
 
-	List<E> range(long begin, long end);
+	/**
+	 * Get elements between {@code start} and {@code end} from list at the bound key.
+	 *
+	 * @param start
+	 * @param end
+	 * @return {@literal null} when used in pipeline / transaction.
+	 * @see <a href="https://redis.io/commands/lrange">Redis Documentation: LRANGE</a>
+	 */
+	List<E> range(long start, long end);
 
-	RedisList<E> trim(int begin, int end);
+	/**
+	 * Trim list at the bound key to elements between {@code start} and {@code end}.
+	 *
+	 * @param start
+	 * @param end
+	 * @see <a href="https://redis.io/commands/ltrim">Redis Documentation: LTRIM</a>
+	 */
+	RedisList<E> trim(int start, int end);
+
+	/**
+	 * Trim list at the bound key to elements between {@code start} and {@code end}.
+	 *
+	 * @param start
+	 * @param end
+	 * @since 2.6
+	 * @see <a href="https://redis.io/commands/ltrim">Redis Documentation: LTRIM</a>
+	 */
+	RedisList<E> trim(long start, long end);
 }