org.springframework.data.redis.core.BoundZSetOperations Maven / Gradle / Ivy
/*
* Copyright 2011-2018 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.springframework.data.redis.core;
import java.util.Collection;
import java.util.Set;
import org.springframework.data.redis.connection.RedisZSetCommands.Aggregate;
import org.springframework.data.redis.connection.RedisZSetCommands.Limit;
import org.springframework.data.redis.connection.RedisZSetCommands.Range;
import org.springframework.data.redis.connection.RedisZSetCommands.Tuple;
import org.springframework.data.redis.connection.RedisZSetCommands.Weights;
import org.springframework.data.redis.core.ZSetOperations.TypedTuple;
import org.springframework.lang.Nullable;
/**
* ZSet (or SortedSet) operations bound to a certain key.
*
* @author Costin Leau
* @author Christoph Strobl
* @author Mark Paluch
* @author Wongoo (望哥)
*/
public interface BoundZSetOperations extends BoundKeyOperations {
/**
* Add {@code value} to a sorted set at the bound key, or update its {@code score} if it already exists.
*
* @param score the score.
* @param value the value.
* @return {@literal null} when used in pipeline / transaction.
* @see Redis Documentation: ZADD
*/
@Nullable
Boolean add(V value, double score);
/**
* Add {@code tuples} to a sorted set at the bound key, or update its {@code score} if it already exists.
*
* @param tuples must not be {@literal null}.
* @return {@literal null} when used in pipeline / transaction.
* @see Redis Documentation: ZADD
*/
@Nullable
Long add(Set> tuples);
/**
* Remove {@code values} from sorted set. Return number of removed elements.
*
* @param values must not be {@literal null}.
* @return {@literal null} when used in pipeline / transaction.
* @see Redis Documentation: ZREM
*/
@Nullable
Long remove(Object... values);
/**
* Increment the score of element with {@code value} in sorted set by {@code increment}.
*
* @param delta
* @param value the value.
* @return {@literal null} when used in pipeline / transaction.
* @see Redis Documentation: ZINCRBY
*/
@Nullable
Double incrementScore(V value, double delta);
/**
* Determine the index of element with {@code value} in a sorted set.
*
* @param o the value.
* @return {@literal null} when used in pipeline / transaction.
* @see Redis Documentation: ZRANK
*/
@Nullable
Long rank(Object o);
/**
* Determine the index of element with {@code value} in a sorted set when scored high to low.
*
* @param o the value.
* @return {@literal null} when used in pipeline / transaction.
* @see Redis Documentation: ZREVRANK
*/
@Nullable
Long reverseRank(Object o);
/**
* Get elements between {@code start} and {@code end} from sorted set.
*
* @param start
* @param end
* @return {@literal null} when used in pipeline / transaction.
* @see Redis Documentation: ZRANGE
*/
@Nullable
Set range(long start, long end);
/**
* Get set of {@link Tuple}s between {@code start} and {@code end} from sorted set.
*
* @param start
* @param end
* @return {@literal null} when used in pipeline / transaction.
* @see Redis Documentation: ZRANGE
*/
@Nullable
Set> rangeWithScores(long start, long end);
/**
* Get elements where score is between {@code min} and {@code max} from sorted set.
*
* @param min
* @param max
* @return {@literal null} when used in pipeline / transaction.
* @see Redis Documentation: ZRANGEBYSCORE
*/
@Nullable
Set rangeByScore(double min, double max);
/**
* Get set of {@link Tuple}s where score is between {@code min} and {@code max} from sorted set.
*
* @param min
* @param max
* @return {@literal null} when used in pipeline / transaction.
* @see Redis Documentation: ZRANGEBYSCORE
*/
@Nullable
Set> rangeByScoreWithScores(double min, double max);
/**
* Get elements in range from {@code start} to {@code end} from sorted set ordered from high to low.
*
* @param start
* @param end
* @return {@literal null} when used in pipeline / transaction.
* @see Redis Documentation: ZREVRANGE
*/
@Nullable
Set reverseRange(long start, long end);
/**
* Get set of {@link Tuple}s in range from {@code start} to {@code end} from sorted set ordered from high to low.
*
* @param start
* @param end
* @return {@literal null} when used in pipeline / transaction.
* @see Redis Documentation: ZREVRANGE
*/
@Nullable
Set> reverseRangeWithScores(long start, long end);
/**
* Get elements where score is between {@code min} and {@code max} from sorted set ordered from high to low.
*
* @param min
* @param max
* @return {@literal null} when used in pipeline / transaction.
* @see Redis Documentation: ZREVRANGE
*/
@Nullable
Set reverseRangeByScore(double min, double max);
/**
* Get set of {@link Tuple} where score is between {@code min} and {@code max} from sorted set ordered from high to
* low.
*
* @param min
* @param max
* @return {@literal null} when used in pipeline / transaction.
* @see Redis Documentation: ZREVRANGEBYSCORE
*/
@Nullable
Set> reverseRangeByScoreWithScores(double min, double max);
/**
* Count number of elements within sorted set with scores between {@code min} and {@code max}.
*
* @param min
* @param max
* @return {@literal null} when used in pipeline / transaction.
* @see Redis Documentation: ZCOUNT
*/
@Nullable
Long count(double min, double max);
/**
* Returns the number of elements of the sorted set stored with given the bound key.
*
* @see #zCard()
* @return {@literal null} when used in pipeline / transaction.
* @see Redis Documentation: ZCARD
*/
@Nullable
Long size();
/**
* Get the size of sorted set with the bound key.
*
* @return {@literal null} when used in pipeline / transaction.
* @since 1.3
* @see Redis Documentation: ZCARD
*/
@Nullable
Long zCard();
/**
* Get the score of element with {@code value} from sorted set with key the bound key.
*
* @param o the value.
* @return {@literal null} when used in pipeline / transaction.
* @see Redis Documentation: ZSCORE
*/
@Nullable
Double score(Object o);
/**
* Remove elements in range between {@code start} and {@code end} from sorted set with the bound key.
*
* @param start
* @param end
* @return {@literal null} when used in pipeline / transaction.
* @see Redis Documentation: ZREMRANGEBYRANK
*/
@Nullable
Long removeRange(long start, long end);
/**
* Remove elements with scores between {@code min} and {@code max} from sorted set with the bound key.
*
* @param min
* @param max
* @return {@literal null} when used in pipeline / transaction.
* @see Redis Documentation: ZREMRANGEBYSCORE
*/
@Nullable
Long removeRangeByScore(double min, double max);
/**
* Union sorted sets at the bound key and {@code otherKeys} and store result in destination {@code destKey}.
*
* @param otherKey must not be {@literal null}.
* @param destKey must not be {@literal null}.
* @return {@literal null} when used in pipeline / transaction.
* @see Redis Documentation: ZUNIONSTORE
*/
@Nullable
Long unionAndStore(K otherKey, K destKey);
/**
* Union sorted sets at the bound key and {@code otherKeys} and store result in destination {@code destKey}.
*
* @param otherKeys must not be {@literal null}.
* @param destKey must not be {@literal null}.
* @return {@literal null} when used in pipeline / transaction.
* @see Redis Documentation: ZUNIONSTORE
*/
@Nullable
Long unionAndStore(Collection otherKeys, K destKey);
/**
* Union sorted sets at the bound key and {@code otherKeys} and store result in destination {@code destKey}.
*
* @param otherKeys must not be {@literal null}.
* @param destKey must not be {@literal null}.
* @param aggregate must not be {@literal null}.
* @return {@literal null} when used in pipeline / transaction.
* @since 2.1
* @see Redis Documentation: ZUNIONSTORE
*/
@Nullable
Long unionAndStore(Collection otherKeys, K destKey, Aggregate aggregate);
/**
* Union sorted sets at the bound key and {@code otherKeys} and store result in destination {@code destKey}.
*
* @param otherKeys must not be {@literal null}.
* @param destKey must not be {@literal null}.
* @param aggregate must not be {@literal null}.
* @param weights must not be {@literal null}.
* @return {@literal null} when used in pipeline / transaction.
* @since 2.1
* @see Redis Documentation: ZUNIONSTORE
*/
@Nullable
Long unionAndStore(Collection otherKeys, K destKey, Aggregate aggregate, Weights weights);
/**
* Intersect sorted sets at the bound key and {@code otherKey} and store result in destination {@code destKey}.
*
* @param otherKey must not be {@literal null}.
* @param destKey must not be {@literal null}.
* @return {@literal null} when used in pipeline / transaction.
* @see Redis Documentation: ZINTERSTORE
*/
@Nullable
Long intersectAndStore(K otherKey, K destKey);
/**
* Intersect sorted sets at the bound key and {@code otherKeys} and store result in destination {@code destKey}.
*
* @param otherKeys must not be {@literal null}.
* @param destKey must not be {@literal null}.
* @return {@literal null} when used in pipeline / transaction.
* @see Redis Documentation: ZINTERSTORE
*/
@Nullable
Long intersectAndStore(Collection otherKeys, K destKey);
/**
* Intersect sorted sets at the bound key and {@code otherKeys} and store result in destination {@code destKey}.
*
* @param otherKeys must not be {@literal null}.
* @param destKey must not be {@literal null}.
* @param aggregate must not be {@literal null}.
* @return {@literal null} when used in pipeline / transaction.
* @since 2.1
* @see Redis Documentation: ZINTERSTORE
*/
@Nullable
Long intersectAndStore(Collection otherKeys, K destKey, Aggregate aggregate);
/**
* Intersect sorted sets at the bound key and {@code otherKeys} and store result in destination {@code destKey}.
*
* @param otherKeys must not be {@literal null}.
* @param destKey must not be {@literal null}.
* @param aggregate must not be {@literal null}.
* @param weights must not be {@literal null}.
* @return {@literal null} when used in pipeline / transaction.
* @since 2.1
* @see Redis Documentation: ZINTERSTORE
*/
@Nullable
Long intersectAndStore(Collection otherKeys, K destKey, Aggregate aggregate, Weights weights);
/**
* Iterate over elements in zset at the bound key.
* Important: Call {@link Cursor#close()} when done to avoid resource leak.
*
* @param options
* @return
* @since 1.4
*/
Cursor> scan(ScanOptions options);
/**
* Get all elements with lexicographical ordering with a value between {@link Range#getMin()} and
* {@link Range#getMax()}.
*
* @param range must not be {@literal null}.
* @return {@literal null} when used in pipeline / transaction.
* @since 1.7
* @see Redis Documentation: ZRANGEBYLEX
*/
@Nullable
Set rangeByLex(Range range);
/**
* Get all elements {@literal n} elements, where {@literal n = } {@link Limit#getCount()}, starting at
* {@link Limit#getOffset()} with lexicographical ordering having a value between {@link Range#getMin()} and
* {@link Range#getMax()}.
*
* @param range must not be {@literal null}.
* @param limit can be {@literal null}.
* @return {@literal null} when used in pipeline / transaction.
* @since 1.7
* @see Redis Documentation: ZRANGEBYLEX
*/
@Nullable
Set rangeByLex(Range range, Limit limit);
/**
* @return never {@literal null}.
*/
RedisOperations getOperations();
}