/*
* Copyright (c) 2019-2029, Dreamlu 卢春梦 ([email protected] & www.dreamlu.net).
*
* Licensed under the GNU LESSER GENERAL PUBLIC LICENSE 3.0;
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.gnu.org/licenses/lgpl.html
*
* 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 net.dreamlu.mica.redis.cache;
import lombok.Getter;
import net.dreamlu.mica.core.utils.CollectionUtil;
import net.dreamlu.mica.core.utils.JsonUtil;
import org.springframework.data.domain.Range;
import org.springframework.data.redis.connection.BitFieldSubCommands;
import org.springframework.data.redis.core.*;
import org.springframework.data.redis.serializer.RedisSerializer;
import org.springframework.lang.Nullable;
import java.nio.charset.StandardCharsets;
import java.time.Duration;
import java.util.*;
import java.util.concurrent.TimeUnit;
import java.util.function.Consumer;
import java.util.function.Function;
import java.util.function.LongSupplier;
import java.util.function.Supplier;
/**
* redis 工具
*
* @author L.cm
*/
@Getter
@SuppressWarnings("unchecked")
public class MicaRedisCache {
private final RedisTemplate redisTemplate;
private final ValueOperations valueOps;
private final HashOperations hashOps;
private final ListOperations listOps;
private final SetOperations setOps;
private final ZSetOperations zSetOps;
private final GeoOperations geoOps;
private final HyperLogLogOperations hllOps;
public MicaRedisCache(RedisTemplate redisTemplate) {
this.redisTemplate = redisTemplate;
this.valueOps = redisTemplate.opsForValue();
this.hashOps = redisTemplate.opsForHash();
this.listOps = redisTemplate.opsForList();
this.setOps = redisTemplate.opsForSet();
this.zSetOps = redisTemplate.opsForZSet();
this.geoOps = redisTemplate.opsForGeo();
this.hllOps = redisTemplate.opsForHyperLogLog();
}
/**
* 方便多 redis 数据源使用
*
* @param redisTemplate RedisTemplate
* @return MicaRedisCache
*/
public static MicaRedisCache use(RedisTemplate redisTemplate) {
return new MicaRedisCache(redisTemplate);
}
/**
* 设置缓存
*
* @param cacheKey 缓存key
* @param value 缓存value
*/
public void set(CacheKey cacheKey, T value) {
String key = cacheKey.getKey();
Duration expire = cacheKey.getExpire();
if (expire == null) {
set(key, value);
} else {
setEx(key, value, expire);
}
}
/**
* 存放 key value 对到 redis，用于自定义序列化的方式
*
* @param cacheKey redis cacheKey
* @param value value
* @param mapper 序列化转换
* @param 泛型
*/
public void set(CacheKey cacheKey, T value, Function mapper) {
redisTemplate.execute((RedisCallback) redis -> {
byte[] rawKey = keySerialize(cacheKey.getKey());
Duration timeout = cacheKey.getExpire();
byte[] rawValue = mapper.apply(value);
if (timeout == null) {
return redis.set(rawKey, rawValue);
} else {
if (TimeoutUtils.hasMillis(timeout)) {
return redis.setEx(rawKey, TimeoutUtils.toSeconds(timeout.toMillis(), TimeUnit.MILLISECONDS), rawValue);
} else {
return redis.setEx(rawKey, TimeoutUtils.toSeconds(timeout.getSeconds(), TimeUnit.SECONDS), rawValue);
}
}
});
}
/**
* 存放 key value 对到 redis，采用 json 序列化
*
* @param cacheKey redis cacheKey
* @param value value
* @param 泛型
*/
public void setByJsonSer(CacheKey cacheKey, T value) {
set(cacheKey, value, JsonUtil::toJsonAsBytes);
}
/**
* 存放 key value 对到 redis。
*/
public void set(String key, T value) {
valueOps.set(key, value);
}
/**
* 存放 key value 对到 redis，用于自定义序列化的方式
*
* @param key redis key
* @param mapper 序列化转换
* @param 泛型
*/
public void set(String key, T value, Function mapper) {
redisTemplate.execute((RedisCallback) redis -> redis.set(keySerialize(key), mapper.apply(value)));
}
/**
* 存放 key value 对到 redis，采用 json 序列化
*
* @param cacheKey redis cacheKey
* @param value value
* @param 泛型
*/
public void setByJsonSer(String cacheKey, T value) {
set(cacheKey, value, JsonUtil::toJsonAsBytes);
}
/**
* 存放 key value 对到 redis，并将 key 的生存时间设为 seconds (以秒为单位)。
* 如果 key 已经存在， SETEX 命令将覆写旧值。
*/
public void setEx(String key, T value, Duration timeout) {
valueOps.set(key, value, timeout);
}
/**
* 存放 key value 对到 redis，并将 key 的生存时间设为 seconds (以秒为单位)。
* 如果 key 已经存在， SETEX 命令将覆写旧值。
*/
public void setEx(String key, T value, Long seconds) {
valueOps.set(key, value, seconds, TimeUnit.SECONDS);
}
/**
* Set the {@code value} and expiration {@code timeout} for {@code key}.
*
* @param key must not be {@literal null}.
* @param value must not be {@literal null}.
* @param timeout the key expiration timeout.
* @param unit must not be {@literal null}.
* @see Redis Documentation: SETEX
*/
public void setEx(String key, T value, long timeout, TimeUnit unit) {
valueOps.set(key, value, timeout, unit);
}
/**
* 存放 key value 对到 redis
* 如果 key 已经存在， SETNX 命令将返回 false， 即不执行任何操作，
*
* @param key 缓存key
* @param value 缓存value
* @return 如果设置成功则为 {@literal true}, 如果 key 已存在则为 {@literal false}.
* @see Redis Documentation: SETNX
*/
@Nullable
public Boolean setNx(String key, T value) {
return valueOps.setIfAbsent(key, value);
}
/**
* 存放 key value 对到 redis
* 如果 key 已经存在， SETNX 命令将返回 false， 即不执行任何操作，
*
* @param key 缓存key
* @param value 缓存value
* @return 如果设置成功则为 {@literal true}, 如果 key 已存在则为 {@literal false}.
* @see Redis Documentation: set
*/
@Nullable
public Boolean setNx(String key, T value, long time, TimeUnit unit) {
return valueOps.setIfAbsent(key, value, time, unit);
}
/**
* 返回 key 所关联的 value 值
* 如果 key 不存在那么返回特殊值 nil 。
*/
@Nullable
public T get(String key) {
return (T) valueOps.get(key);
}
/**
* 返回 key 所关联的 value 值
*
* @param key redis key
* @param mapper 函数式
* @param 泛型
* @return T
*/
@Nullable
public T get(String key, Function mapper) {
return redisTemplate.execute((RedisCallback) redis -> {
byte[] value = redis.get(keySerialize(key));
if (value == null) {
return null;
}
return mapper.apply(value);
});
}
/**
* 返回 key 所关联的 value 值，采用 jdk 序列化
* 如果 key 不存在那么返回特殊值 nil 。
*/
@Nullable
public T getByJdkSer(String key) {
return get(key, (value) -> (T) RedisSerializer.java().deserialize(value));
}
/**
* 返回 key 所关联的 value 值，采用 json 序列化
* 如果 key 不存在那么返回特殊值 nil 。
*/
@Nullable
public T getByJsonSer(String key, Class clazz) {
return get(key, (value) -> JsonUtil.readValue(value, clazz));
}
/**
* 获取cache 为 null 时使用加载器，然后设置缓存
*
* @param key cacheKey
* @param loader cache loader
* @param 泛型
* @return 结果
*/
@Nullable
public T get(String key, Supplier loader) {
T value = this.get(key);
if (value != null) {
return value;
}
value = loader.get();
if (value == null) {
return null;
}
this.set(key, value);
return value;
}
/**
* 获取cache 为 null 时使用加载器，然后设置缓存
*
* @param key cacheKey
* @param clazz Class
* @param loader cache loader
* @param 泛型
* @return 结果
*/
@Nullable
public T getByJsonSer(String key, Class clazz, Supplier loader) {
T value = this.getByJsonSer(key, clazz);
if (value != null) {
return value;
}
value = loader.get();
if (value == null) {
return null;
}
this.set(key, value, JsonUtil::toJsonAsBytes);
return value;
}
/**
* 返回 key 所关联的 value 值
* 如果 key 不存在那么返回特殊值 nil 。
*/
@Nullable
public T get(CacheKey cacheKey) {
return (T) valueOps.get(cacheKey.getKey());
}
/**
* 返回 key 所关联的 value 值
* 如果 key 不存在那么返回特殊值 nil 。
*/
@Nullable
public T getByJsonSer(CacheKey cacheKey, Class clazz) {
return getByJsonSer(cacheKey.getKey(), clazz);
}
/**
* 获取cache 为 null 时使用加载器，然后设置缓存
*
* @param cacheKey cacheKey
* @param loader cache loader
* @param 泛型
* @return 结果
*/
@Nullable
public T get(CacheKey cacheKey, Supplier loader) {
String key = cacheKey.getKey();
T value = this.get(key);
if (value != null) {
return value;
}
value = loader.get();
if (value == null) {
return null;
}
this.set(cacheKey, value);
return value;
}
/**
* 获取cache 为 null 时使用加载器，然后设置缓存
*
* @param cacheKey cacheKey
* @param loader cache loader
* @param 泛型
* @return 结果
*/
@Nullable
public T getByJsonSer(CacheKey cacheKey, Class clazz, Supplier loader) {
String key = cacheKey.getKey();
T value = this.getByJsonSer(key, clazz);
if (value != null) {
return value;
}
value = loader.get();
if (value == null) {
return null;
}
this.set(cacheKey, value, JsonUtil::toJsonAsBytes);
return value;
}
/**
* 删除给定的一个 key
* 不存在的 key 会被忽略。
*/
@Nullable
public Boolean del(String key) {
return redisTemplate.delete(key);
}
/**
* 删除给定的一个 key
* 不存在的 key 会被忽略。
*/
@Nullable
public Boolean del(CacheKey key) {
return redisTemplate.delete(key.getKey());
}
/**
* 删除给定的多个 key
* 不存在的 key 会被忽略。
*/
@Nullable
public Long del(String... keys) {
return del(Arrays.asList(keys));
}
/**
* 删除给定的多个 key
* 不存在的 key 会被忽略。
*/
@Nullable
public Long del(Collection keys) {
return redisTemplate.delete(keys);
}
/**
* 查找所有符合给定模式 pattern 的 key 。
* KEYS * 匹配数据库中所有 key 。
* KEYS h?llo 匹配 hello ， hallo 和 hxllo 等。
* KEYS h*llo 匹配 hllo 和 heeeeello 等。
* KEYS h[ae]llo 匹配 hello 和 hallo ，但不匹配 hillo 。
* 特殊符号用 \ 隔开
*/
@Nullable
public Set keys(String pattern) {
return redisTemplate.keys(pattern);
}
/**
* redis scan，count 默认 100
*
* @param pattern 匹配表达式
* @return 扫描结果
*/
public Set scan(String pattern) {
return scan(pattern, 100L);
}
/**
* redis scan
*
* @param pattern 匹配表达式
* @param count 一次扫描的数量, redis 默认为 10
* @return 扫描结果
*/
public Set scan(String pattern, @Nullable Long count) {
final Set keySet = new HashSet<>();
scan(pattern, count, keySet::add);
return keySet;
}
/**
* redis scan, count 默认 100
*
* @param pattern 匹配表达式
* @param consumer 消费者
*/
public void scan(String pattern, Consumer consumer) {
scan(pattern, 100L, consumer);
}
/**
* redis scan
*
* @param pattern 匹配表达式
* @param count 一次扫描的数量
* @param consumer 消费者
*/
public void scan(String pattern, @Nullable Long count, Consumer consumer) {
scanBytes(pattern, count, (bytes) -> consumer.accept(keyDeserialize(bytes)));
}
/**
* redis scan
*
* @param pattern 匹配表达式
* @param count 一次扫描的数量
* @param consumer 消费者
*/
public void scanBytes(String pattern, @Nullable Long count, Consumer consumer) {
redisTemplate.execute((RedisCallback) redis -> {
ScanOptions.ScanOptionsBuilder builder = ScanOptions.scanOptions()
.match(pattern);
if (count != null) {
builder.count(count);
}
try (Cursor cursor = redis.scan(builder.build())) {
cursor.forEachRemaining(consumer);
}
return null;
});
}
/**
* redis sscan，count 默认 100
*
* @param key key
* @param pattern 匹配表达式
* @return 扫描结果
*/
public Set sScan(String key, String pattern) {
return sScan(key, pattern, 100L);
}
/**
* redis sscan
*
* @param key key
* @param pattern 匹配表达式
* @param count 一次扫描的数量
* @return 扫描结果
*/
public Set sScan(String key, String pattern, @Nullable Long count) {
final Set keySet = new HashSet<>();
sScan(key, pattern, count, keySet::add);
return keySet;
}
/**
* redis sscan
*
* @param key key
* @param pattern 匹配表达式
* @param consumer consumer
*/
public void sScan(String key, String pattern, Consumer consumer) {
sScan(key, pattern, 100L, consumer);
}
/**
* redis sscan
*
* @param key key
* @param pattern 匹配表达式
* @param count 一次扫描的数量
* @param consumer consumer
*/
public void sScan(String key, String pattern, @Nullable Long count, Consumer consumer) {
sScanBytes(key, pattern, count, (bytes) -> consumer.accept(keyDeserialize(bytes)));
}
/**
* redis sscan
*
* @param key key
* @param pattern 匹配表达式
* @param count 一次扫描的数量
* @param consumer consumer
*/
public void sScanBytes(String key, String pattern, @Nullable Long count, Consumer consumer) {
redisTemplate.execute((RedisCallback) redis -> {
ScanOptions.ScanOptionsBuilder builder = ScanOptions.scanOptions()
.match(pattern);
if (count != null) {
builder.count(count);
}
try (Cursor cursor = redis.sScan(keySerialize(key), builder.build())) {
cursor.forEachRemaining(consumer);
}
return null;
});
}
/**
* 返回集合中元素的数量。
*
* @param key redis key
* @return 数量
*/
@Nullable
public Long sCard(String key) {
return setOps.size(key);
}
/**
* 同时设置一个或多个 key-value 对。
* 如果某个给定 key 已经存在，那么 MSET 会用新值覆盖原来的旧值，如果这不是你所希望的效果，请考虑使用 MSETNX 命令：它只会在所有给定 key 都不存在的情况下进行设置操作。
* MSET 是一个原子性(atomic)操作，所有给定 key 都会在同一时间内被设置，某些给定 key 被更新而另一些给定 key 没有改变的情况，不可能发生。
*
* 例子：
* Cache cache = RedisKit.use(); // 使用 Redis 的 cache
* cache.mset("k1", "v1", "k2", "v2"); // 放入多个 key value 键值对
* List list = cache.mget("k1", "k2"); // 利用多个键值得到上面代码放入的值
*
*/
public void mSet(Object... keysValues) {
valueOps.multiSet(CollectionUtil.toMap(keysValues));
}
/**
* 返回所有(一个或多个)给定 key 的值。
* 如果给定的 key 里面，有某个 key 不存在，那么这个 key 返回特殊值 nil 。因此，该命令永不失败。
*/
@Nullable
public List mGet(String... keys) {
return mGet(Arrays.asList(keys));
}
/**
* 返回所有(一个或多个)给定 key 的值。
* 如果给定的 key 里面，有某个 key 不存在，那么这个 key 返回特殊值 nil 。因此，该命令永不失败。
*/
@Nullable
public List mGet(Collection keys) {
return valueOps.multiGet(keys);
}
/**
* 将 key 中储存的数字值减一。
* 如果 key 不存在，那么 key 的值会先被初始化为 0 ，然后再执行 DECR 操作。
* 如果值包含错误的类型，或字符串类型的值不能表示为数字，那么返回一个错误。
* 本操作的值限制在 64 位(bit)有符号数字表示之内。
* 关于递增(increment) / 递减(decrement)操作的更多信息，请参见 INCR 命令。
*/
@Nullable
public Long decr(String key) {
return valueOps.decrement(key);
}
/**
* 将 key 所储存的值减去减量 decrement 。
* 如果 key 不存在，那么 key 的值会先被初始化为 0 ，然后再执行 DECRBY 操作。
* 如果值包含错误的类型，或字符串类型的值不能表示为数字，那么返回一个错误。
* 本操作的值限制在 64 位(bit)有符号数字表示之内。
* 关于更多递增(increment) / 递减(decrement)操作的更多信息，请参见 INCR 命令。
*/
@Nullable
public Long decrBy(String key, long longValue) {
return valueOps.decrement(key, longValue);
}
/**
* 将 key 所储存的值减去减量 decrement 。
* 如果 key 不存在，那么 key 的值会先被初始化为 0 ，然后再执行 DECRBY 操作。
* 如果值包含错误的类型，或字符串类型的值不能表示为数字，那么返回一个错误。
* 本操作的值限制在 64 位(bit)有符号数字表示之内。
* 关于更多递增(increment) / 递减(decrement)操作的更多信息，请参见 INCR 命令。
*/
public Long decrBy(String key, long longValue, long seconds) {
byte[] serializedKey = keySerialize(key);
List result = redisTemplate.executePipelined((RedisCallback) redis -> {
Long data = redis.decrBy(serializedKey, longValue);
redis.expire(serializedKey, seconds);
return data;
});
return (Long) result.get(0);
}
/**
* 将 key 所储存的值减去减量 decrement 。
* 如果 key 不存在，那么 key 的值会先被初始化为 0 ，然后再执行 DECRBY 操作。
* 如果值包含错误的类型，或字符串类型的值不能表示为数字，那么返回一个错误。
* 本操作的值限制在 64 位(bit)有符号数字表示之内。
* 关于更多递增(increment) / 递减(decrement)操作的更多信息，请参见 INCR 命令。
*/
public Long decrBy(String key, long longValue, Duration timeout) {
long seconds = timeout.getSeconds();
return decrBy(key, longValue, seconds);
}
/**
* 将 key 中储存的数字值增一。
* 如果 key 不存在，那么 key 的值会先被初始化为 0 ，然后再执行 INCR 操作。
* 如果值包含错误的类型，或字符串类型的值不能表示为数字，那么返回一个错误。
* 本操作的值限制在 64 位(bit)有符号数字表示之内。
*/
@Nullable
public Long incr(String key) {
return valueOps.increment(key);
}
/**
* 将 key 所储存的值加上增量 increment 。
* 如果 key 不存在，那么 key 的值会先被初始化为 0 ，然后再执行 INCRBY 命令。
* 如果值包含错误的类型，或字符串类型的值不能表示为数字，那么返回一个错误。
* 本操作的值限制在 64 位(bit)有符号数字表示之内。
* 关于递增(increment) / 递减(decrement)操作的更多信息，参见 INCR 命令。
*/
@Nullable
public Long incrBy(String key, long longValue) {
return valueOps.increment(key, longValue);
}
/**
* 将 key 所储存的值加上增量 increment 。
* 如果 key 不存在，那么 key 的值会先被初始化为 0 ，然后再执行 INCRBY 命令。
* 如果值包含错误的类型，或字符串类型的值不能表示为数字，那么返回一个错误。
* 本操作的值限制在 64 位(bit)有符号数字表示之内。
* 关于递增(increment) / 递减(decrement)操作的更多信息，参见 INCR 命令。
*/
public Long incrBy(String key, long longValue, long seconds) {
byte[] serializedKey = keySerialize(key);
List result = redisTemplate.executePipelined((RedisCallback) redis -> {
Long data = redis.incrBy(serializedKey, longValue);
redis.expire(serializedKey, seconds);
return data;
});
return (Long) result.get(0);
}
/**
* 将 key 所储存的值加上增量 increment 。
* 如果 key 不存在，那么 key 的值会先被初始化为 0 ，然后再执行 INCRBY 命令。
* 如果值包含错误的类型，或字符串类型的值不能表示为数字，那么返回一个错误。
* 本操作的值限制在 64 位(bit)有符号数字表示之内。
* 关于递增(increment) / 递减(decrement)操作的更多信息，参见 INCR 命令。
*/
public Long incrBy(String key, long longValue, Duration timeout) {
return incrBy(key, longValue, timeout.getSeconds());
}
/**
* 获取记数器的值，用于获取 incr、incrBy 的值
*
* @param key key
*/
@Nullable
public Long getCounter(String key) {
return redisTemplate.execute((RedisCallback) redis -> {
byte[] value = redis.get(keySerialize(key));
if (value == null) {
return null;
}
return Long.valueOf(new String(value, StandardCharsets.UTF_8));
});
}
/**
* 获取记数器的值，用于初始化获取 incr、incrBy 的值
*
* @param key key
* @param seconds 超时时间
* @param loader 加载器
*/
@Nullable
public Long getCounter(String key, long seconds, LongSupplier loader) {
return redisTemplate.execute((RedisCallback) redis -> {
byte[] keyBytes = keySerialize(key);
byte[] value = redis.get(keyBytes);
long longValue;
if (value != null) {
longValue = Long.parseLong(new String(value, StandardCharsets.UTF_8));
} else {
longValue = loader.getAsLong();
redis.setEx(keyBytes, seconds, String.valueOf(longValue).getBytes());
}
return longValue;
});
}
/**
* 获取记数器的值，用于获取 hIncr、hIncrBy 的值
*
* @param key key
*/
@Nullable
public Long getHCounter(String key, Object field) {
return redisTemplate.execute((RedisCallback) redis -> {
byte[] value = redis.hGet(keySerialize(key), hashKeySerializer(field));
if (value == null) {
return null;
}
return Long.valueOf(new String(value, StandardCharsets.UTF_8));
});
}
/**
* 获取记数器的值，用于初始化获取 hIncr、hIncrBy 的值
*
* @param key key
* @param loader 加载器
*/
@Nullable
public Long getHCounter(String key, Object field, LongSupplier loader) {
return redisTemplate.execute((RedisCallback) redis -> {
byte[] keyBytes = keySerialize(key);
byte[] fieldBytes = hashKeySerializer(field);
byte[] value = redis.hGet(keyBytes, fieldBytes);
long longValue;
if (value != null) {
longValue = Long.parseLong(new String(value, StandardCharsets.UTF_8));
} else {
longValue = loader.getAsLong();
redis.hSet(keyBytes, fieldBytes, String.valueOf(longValue).getBytes());
}
return longValue;
});
}
/**
* 检查给定 key 是否存在。
*/
@Nullable
public Boolean exists(String key) {
return redisTemplate.hasKey(key);
}
/**
* 检查给定 key 是否存在。
*/
@Nullable
public Boolean exists(CacheKey cacheKey) {
return exists(cacheKey.getKey());
}
/**
* 从当前数据库中随机返回(不删除)一个 key 。
*/
@Nullable
public String randomKey() {
return redisTemplate.randomKey();
}
/**
* 将 key 改名为 newkey 。
* 当 key 和 newkey 相同，或者 key 不存在时，返回一个错误。
* 当 newkey 已经存在时， RENAME 命令将覆盖旧值。
*/
public void rename(String oldKey, String newKey) {
redisTemplate.rename(oldKey, newKey);
}
/**
* 将当前数据库的 key 移动到给定的数据库 db 当中。
* 如果当前数据库(源数据库)和给定数据库(目标数据库)有相同名字的给定 key ，或者 key 不存在于当前数据库，那么 MOVE 没有任何效果。
* 因此，也可以利用这一特性，将 MOVE 当作锁(locking)原语(primitive)。
*/
@Nullable
public Boolean move(String key, int dbIndex) {
return redisTemplate.move(key, dbIndex);
}
/**
* 为给定 key 设置生存时间，当 key 过期时(生存时间为 0 )，它会被自动删除。
* 在 Redis 中，带有生存时间的 key 被称为『易失的』(volatile)。
*/
@Nullable
public Boolean expire(String key, long seconds) {
return redisTemplate.expire(key, seconds, TimeUnit.SECONDS);
}
/**
* 为给定 key 设置生存时间，当 key 过期时(生存时间为 0 )，它会被自动删除。
* 在 Redis 中，带有生存时间的 key 被称为『易失的』(volatile)。
*/
@Nullable
public Boolean expire(String key, Duration timeout) {
return expire(key, timeout.getSeconds());
}
/**
* EXPIREAT 的作用和 EXPIRE 类似，都用于为 key 设置生存时间。不同在于 EXPIREAT 命令接受的时间参数是 UNIX 时间戳(unix timestamp)。
*/
@Nullable
public Boolean expireAt(String key, Date date) {
return redisTemplate.expireAt(key, date);
}
/**
* EXPIREAT 的作用和 EXPIRE 类似，都用于为 key 设置生存时间。不同在于 EXPIREAT 命令接受的时间参数是 UNIX 时间戳(unix timestamp)。
*/
@Nullable
public Boolean expireAt(String key, long unixTime) {
return expireAt(key, new Date(unixTime));
}
/**
* 这个命令和 EXPIRE 命令的作用类似，但是它以毫秒为单位设置 key 的生存时间，而不像 EXPIRE 命令那样，以秒为单位。
*/
@Nullable
public Boolean pExpire(String key, long milliseconds) {
return redisTemplate.expire(key, milliseconds, TimeUnit.MILLISECONDS);
}
/**
* 将给定 key 的值设为 value ，并返回 key 的旧值(old value)。
* 当 key 存在但不是字符串类型时，返回一个错误。
*/
@Nullable
public T getSet(String key, T value) {
return (T) valueOps.getAndSet(key, value);
}
/**
* 移除给定 key 的生存时间，将这个 key 从『易失的』(带生存时间 key )转换成『持久的』(一个不带生存时间、永不过期的 key )。
*/
@Nullable
public Boolean persist(String key) {
return redisTemplate.persist(key);
}
/**
* 返回 key 所储存的值的类型。
*/
public String type(String key) {
return redisTemplate.type(key).code();
}
/**
* 以秒为单位，返回给定 key 的剩余生存时间(TTL, time to live)。
*/
@Nullable
public Long ttl(String key) {
return redisTemplate.getExpire(key);
}
/**
* 这个命令类似于 TTL 命令，但它以毫秒为单位返回 key 的剩余生存时间，而不是像 TTL 命令那样，以秒为单位。
*/
@Nullable
public Long pttl(String key) {
return redisTemplate.getExpire(key, TimeUnit.MILLISECONDS);
}
/**
* 将哈希表 key 中的域 field 的值设为 value 。
* 如果 key 不存在，一个新的哈希表被创建并进行 HSET 操作。
* 如果域 field 已经存在于哈希表中，旧值将被覆盖。
*/
public void hSet(String key, F field, V value) {
hashOps.put(key, field, value);
}
/**
* 同时将多个 field-value (域-值)对设置到哈希表 key 中。
* 此命令会覆盖哈希表中已存在的域。
* 如果 key 不存在，一个空哈希表被创建并执行 HMSET 操作。
*/
public void hMset(String key, Map hash) {
hashOps.putAll(key, hash);
}
/**
* 返回哈希表 key 中给定域 field 的值。
*/
@Nullable
public T hGet(String key, Object field) {
return (T) hashOps.get(key, field);
}
/**
* 返回哈希表 key 中，一个或多个给定域的值。
* 如果给定的域不存在于哈希表，那么返回一个 nil 值。
* 因为不存在的 key 被当作一个空哈希表来处理，所以对一个不存在的 key 进行 HMGET 操作将返回一个只带有 nil 值的表。
*/
public List hmGet(String key, F... fields) {
return hmGet(key, Arrays.asList(fields));
}
/**
* 返回哈希表 key 中，一个或多个给定域的值。
* 如果给定的域不存在于哈希表，那么返回一个 nil 值。
* 因为不存在的 key 被当作一个空哈希表来处理，所以对一个不存在的 key 进行 HMGET 操作将返回一个只带有 nil 值的表。
*/
public List hmGet(String key, Collection hashKeys) {
return (List) hashOps.multiGet(key, (Collection) hashKeys);
}
/**
* 删除哈希表 key 中的一个或多个指定域，不存在的域将被忽略。
*/
public Long hDel(String key, Object... fields) {
return hashOps.delete(key, fields);
}
/**
* 查看哈希表 key 中，给定域 field 是否存在。
*/
public Boolean hExists(String key, Object field) {
return hashOps.hasKey(key, field);
}
/**
* 返回哈希表 key 中，所有的域和值。
* 在返回值里，紧跟每个域名(field name)之后是域的值(value)，所以返回值的长度是哈希表大小的两倍。
*/
public Map hGetAll(String key) {
return hashOps.entries(key);
}
/**
* 返回哈希表 key 中所有域的值。
*/
public List hVals(String key) {
return hashOps.values(key);
}
/**
* 返回哈希表 key 中的所有域。
* 底层实现此方法取名为 hfields 更为合适，在此仅为与底层保持一致
*/
public Set hKeys(String key) {
return hashOps.keys(key);
}
/**
* 返回哈希表 key 中域的数量。
*/
public Long hLen(String key) {
return hashOps.size(key);
}
/**
* 为哈希表 key 中的域 field 的值加上增量 increment 。
* 增量也可以为负数，相当于对给定域进行减法操作。
* 如果 key 不存在，一个新的哈希表被创建并执行 HINCRBY 命令。
* 如果域 field 不存在，那么在执行命令前，域的值被初始化为 0 。
* 对一个储存字符串值的域 field 执行 HINCRBY 命令将造成一个错误。
* 本操作的值被限制在 64 位(bit)有符号数字表示之内。
*/
public Long hIncr(String key, Object field) {
return hashOps.increment(key, field, 1);
}
/**
* 为哈希表 key 中的域 field 的值加上增量 increment 。
* 增量也可以为负数，相当于对给定域进行减法操作。
* 如果 key 不存在，一个新的哈希表被创建并执行 HINCRBY 命令。
* 如果域 field 不存在，那么在执行命令前，域的值被初始化为 0 。
* 对一个储存字符串值的域 field 执行 HINCRBY 命令将造成一个错误。
* 本操作的值被限制在 64 位(bit)有符号数字表示之内。
*/
public Long hDecr(String key, Object field) {
return hashOps.increment(key, field, -1);
}
/**
* 为哈希表 key 中的域 field 的值加上增量 increment 。
* 增量也可以为负数，相当于对给定域进行减法操作。
* 如果 key 不存在，一个新的哈希表被创建并执行 HINCRBY 命令。
* 如果域 field 不存在，那么在执行命令前，域的值被初始化为 0 。
* 对一个储存字符串值的域 field 执行 HINCRBY 命令将造成一个错误。
* 本操作的值被限制在 64 位(bit)有符号数字表示之内。
*/
public Long hIncrBy(String key, Object field, long value) {
return hashOps.increment(key, field, value);
}
/**
* 为哈希表 key 中的域 field 加上浮点数增量 increment 。
* 如果哈希表中没有域 field ，那么 HINCRBYFLOAT 会先将域 field 的值设为 0 ，然后再执行加法操作。
* 如果键 key 不存在，那么 HINCRBYFLOAT 会先创建一个哈希表，再创建域 field ，最后再执行加法操作。
* 当以下任意一个条件发生时，返回一个错误：
* 1:域 field 的值不是字符串类型(因为 redis 中的数字和浮点数都以字符串的形式保存，所以它们都属于字符串类型）
* 2:域 field 当前的值或给定的增量 increment 不能解释(parse)为双精度浮点数(double precision floating point number)
* HINCRBYFLOAT 命令的详细功能和 INCRBYFLOAT 命令类似，请查看 INCRBYFLOAT 命令获取更多相关信息。
*/
public Double hIncrByFloat(String key, Object field, double value) {
return hashOps.increment(key, field, value);
}
/**
* 返回列表 key 中，下标为 index 的元素。
* 下标(index)参数 start 和 stop 都以 0 为底，也就是说，以 0 表示列表的第一个元素，
* 以 1 表示列表的第二个元素，以此类推。
* 你也可以使用负数下标，以 -1 表示列表的最后一个元素， -2 表示列表的倒数第二个元素，以此类推。
* 如果 key 不是列表类型，返回一个错误。
*/
@Nullable
public T lIndex(String key, long index) {
return (T) listOps.index(key, index);
}
/**
* 返回列表 key 的长度。
* 如果 key 不存在，则 key 被解释为一个空列表，返回 0 .
* 如果 key 不是列表类型，返回一个错误。
*/
@Nullable
public Long lLen(String key) {
return listOps.size(key);
}
/**
* 移除并返回列表 key 的头元素。
*/
@Nullable
public T lPop(String key) {
return (T) listOps.leftPop(key);
}
/**
* 将一个或多个值 value 插入到列表 key 的表头
* 如果有多个 value 值，那么各个 value 值按从左到右的顺序依次插入到表头： 比如说，
* 对空列表 mylist 执行命令 LPUSH mylist a b c ，列表的值将是 c b a ，
* 这等同于原子性地执行 LPUSH mylist a 、 LPUSH mylist b 和 LPUSH mylist c 三个命令。
* 如果 key 不存在，一个空列表会被创建并执行 LPUSH 操作。
* 当 key 存在但不是列表类型时，返回一个错误。
*/
@Nullable
public Long lPush(String key, T value) {
return listOps.leftPush(key, value);
}
/**
* 将一个或多个值 value 插入到列表 key 的表头
* 如果有多个 value 值，那么各个 value 值按从左到右的顺序依次插入到表头： 比如说，
* 对空列表 mylist 执行命令 LPUSH mylist a b c ，列表的值将是 c b a ，
* 这等同于原子性地执行 LPUSH mylist a 、 LPUSH mylist b 和 LPUSH mylist c 三个命令。
* 如果 key 不存在，一个空列表会被创建并执行 LPUSH 操作。
* 当 key 存在但不是列表类型时，返回一个错误。
*/
@Nullable
public Long lPush(String key, T... values) {
return listOps.leftPushAll(key, values);
}
/**
* 将一个或多个值 value 插入到列表 key 的表头
* 如果有多个 value 值，那么各个 value 值按从左到右的顺序依次插入到表头： 比如说，
* 对空列表 mylist 执行命令 LPUSH mylist a b c ，列表的值将是 c b a ，
* 这等同于原子性地执行 LPUSH mylist a 、 LPUSH mylist b 和 LPUSH mylist c 三个命令。
* 如果 key 不存在，一个空列表会被创建并执行 LPUSH 操作。
* 当 key 存在但不是列表类型时，返回一个错误。
*/
@Nullable
public Long lPush(String key, Collection values) {
return listOps.leftPushAll(key, values);
}
/**
* 将列表 key 下标为 index 的元素的值设置为 value 。
* 当 index 参数超出范围，或对一个空列表( key 不存在)进行 LSET 时，返回一个错误。
* 关于列表下标的更多信息，请参考 LINDEX 命令。
*/
public void lSet(String key, long index, Object value) {
listOps.set(key, index, value);
}
/**
* 根据参数 count 的值，移除列表中与参数 value 相等的元素。
* count 的值可以是以下几种：
* count > 0 : 从表头开始向表尾搜索，移除与 value 相等的元素，数量为 count 。
* count < 0 : 从表尾开始向表头搜索，移除与 value 相等的元素，数量为 count 的绝对值。
* count = 0 : 移除表中所有与 value 相等的值。
*/
@Nullable
public Long lRem(String key, long count, Object value) {
return listOps.remove(key, count, value);
}
/**
* 返回列表 key 中指定区间内的元素，区间以偏移量 start 和 stop 指定。
* 下标(index)参数 start 和 stop 都以 0 为底，也就是说，以 0 表示列表的第一个元素，以 1 表示列表的第二个元素，以此类推。
* 你也可以使用负数下标，以 -1 表示列表的最后一个元素， -2 表示列表的倒数第二个元素，以此类推。
*
* 例子：
* 获取 list 中所有数据：cache.lrange(listKey, 0, -1);
* 获取 list 中下标 1 到 3 的数据： cache.lrange(listKey, 1, 3);
*
*/
@Nullable
public List lRange(String key, long start, long end) {
return (List) listOps.range(key, start, end);
}
/**
* 对一个列表进行修剪(trim)，就是说，让列表只保留指定区间内的元素，不在指定区间之内的元素都将被删除。
* 举个例子，执行命令 LTRIM list 0 2 ，表示只保留列表 list 的前三个元素，其余元素全部删除。
* 下标(index)参数 start 和 stop 都以 0 为底，也就是说，以 0 表示列表的第一个元素，以 1 表示列表的第二个元素，以此类推。
* 你也可以使用负数下标，以 -1 表示列表的最后一个元素， -2 表示列表的倒数第二个元素，以此类推。
* 当 key 不是列表类型时，返回一个错误。
*/
public void lTrim(String key, long start, long end) {
listOps.trim(key, start, end);
}
/**
* 移除并返回列表 key 的尾元素。
*/
@Nullable
public T rPop(String key) {
return (T) listOps.rightPop(key);
}
/**
* 将一个或多个值 value 插入到列表 key 的表尾(最右边)。
* 如果有多个 value 值，那么各个 value 值按从左到右的顺序依次插入到表尾：比如
* 对一个空列表 mylist 执行 RPUSH mylist a b c ，得出的结果列表为 a b c ，
* 等同于执行命令 RPUSH mylist a 、 RPUSH mylist b 、 RPUSH mylist c 。
* 如果 key 不存在，一个空列表会被创建并执行 RPUSH 操作。
* 当 key 存在但不是列表类型时，返回一个错误。
*/
@Nullable
public Long rPush(String key, T value) {
return listOps.rightPush(key, value);
}
/**
* 将一个或多个值 value 插入到列表 key 的表尾(最右边)。
* 如果有多个 value 值，那么各个 value 值按从左到右的顺序依次插入到表尾：比如
* 对一个空列表 mylist 执行 RPUSH mylist a b c ，得出的结果列表为 a b c ，
* 等同于执行命令 RPUSH mylist a 、 RPUSH mylist b 、 RPUSH mylist c 。
* 如果 key 不存在，一个空列表会被创建并执行 RPUSH 操作。
* 当 key 存在但不是列表类型时，返回一个错误。
*/
@Nullable
public Long rPush(String key, T... values) {
return listOps.rightPushAll(key, values);
}
/**
* 将一个或多个值 value 插入到列表 key 的表尾(最右边)。
* 如果有多个 value 值，那么各个 value 值按从左到右的顺序依次插入到表尾：比如
* 对一个空列表 mylist 执行 RPUSH mylist a b c ，得出的结果列表为 a b c ，
* 等同于执行命令 RPUSH mylist a 、 RPUSH mylist b 、 RPUSH mylist c 。
* 如果 key 不存在，一个空列表会被创建并执行 RPUSH 操作。
* 当 key 存在但不是列表类型时，返回一个错误。
*/
@Nullable
public Long rPush(String key, Collection values) {
return listOps.rightPushAll(key, values);
}
/**
* 命令 RPOPLPUSH 在一个原子时间内，执行以下两个动作：
* 将列表 source 中的最后一个元素(尾元素)弹出，并返回给客户端。
* 将 source 弹出的元素插入到列表 destination ，作为 destination 列表的的头元素。
*/
@Nullable
public T rPopLPush(String srcKey, String dstKey) {
return (T) listOps.rightPopAndLeftPush(srcKey, dstKey);
}
/**
* 将一个或多个 member 元素加入到集合 key 当中，已经存在于集合的 member 元素将被忽略。
* 假如 key 不存在，则创建一个只包含 member 元素作成员的集合。
* 当 key 不是集合类型时，返回一个错误。
*/
@Nullable
public Long sAdd(String key, T... members) {
return setOps.add(key, members);
}
/**
* 移除并返回集合中的一个随机元素。
* 如果只想获取一个随机元素，但不想该元素从集合中被移除的话，可以使用 SRANDMEMBER 命令。
*/
@Nullable
public T sPop(String key) {
return (T) setOps.pop(key);
}
/**
* 返回集合 key 中的所有成员。
* 不存在的 key 被视为空集合。
*/
@Nullable
public Set sMembers(String key) {
return (Set) setOps.members(key);
}
/**
* 判断 member 元素是否集合 key 的成员。
*/
@Nullable
public Boolean sIsMember(String key, T member) {
return setOps.isMember(key, member);
}
/**
* 返回多个集合的交集，多个集合由 keys 指定
*/
@Nullable
public Set sInter(String key, String otherKey) {
return (Set) setOps.intersect(key, otherKey);
}
/**
* 返回多个集合的交集，多个集合由 keys 指定
*/
@Nullable
public Set sInter(String key, Collection otherKeys) {
return (Set) setOps.intersect(key, otherKeys);
}
/**
* 返回集合中的一个随机元素。
*/
public T sRandMember(String key) {
return (T) setOps.randomMember(key);
}
/**
* 返回集合中的 count 个随机元素。
* 从 Redis 2.6 版本开始， SRANDMEMBER 命令接受可选的 count 参数：
* 如果 count 为正数，且小于集合基数，那么命令返回一个包含 count 个元素的数组，数组中的元素各不相同。
* 如果 count 大于等于集合基数，那么返回整个集合。
* 如果 count 为负数，那么命令返回一个数组，数组中的元素可能会重复出现多次，而数组的长度为 count 的绝对值。
* 该操作和 SPOP 相似，但 SPOP 将随机元素从集合中移除并返回，而 SRANDMEMBER 则仅仅返回随机元素，而不对集合进行任何改动。
*/
@Nullable
public List sRandMember(String key, int count) {
return (List) setOps.randomMembers(key, count);
}
/**
* 移除集合 key 中的一个或多个 member 元素，不存在的 member 元素会被忽略。
*/
@Nullable
public Long sRem(String key, T... members) {
return setOps.remove(key, members);
}
/**
* 返回多个集合的并集，多个集合由 keys 指定
* 不存在的 key 被视为空集。
*/
@Nullable
public Set sUnion(String key, String otherKey) {
return (Set) setOps.union(key, otherKey);
}
/**
* 返回多个集合的并集，多个集合由 keys 指定
* 不存在的 key 被视为空集。
*/
@Nullable
public Set sUnion(String key, Collection otherKeys) {
return (Set) setOps.union(key, otherKeys);
}
/**
* 返回多个集合的并集，多个集合由 keys 指定
* 不存在的 key 被视为空集。
*/
@Nullable
public Set sUnion(Collection keys) {
return (Set) setOps.union(keys);
}
/**
* 返回一个集合的全部成员，该集合是所有给定集合之间的差集。
* 不存在的 key 被视为空集。
*/
@Nullable
public Set sDiff(String key, String otherKey) {
return (Set) setOps.difference(key, otherKey);
}
/**
* 返回一个集合的全部成员，该集合是所有给定集合之间的差集。
* 不存在的 key 被视为空集。
*/
@Nullable
public Set sDiff(String key, Collection otherKeys) {
return (Set) setOps.difference(key, otherKeys);
}
/**
* 将一个或多个 member 元素及其 score 值加入到有序集 key 当中。
* 如果某个 member 已经是有序集的成员，那么更新这个 member 的 score 值，
* 并通过重新插入这个 member 元素，来保证该 member 在正确的位置上。
*/
@Nullable
public Boolean zAdd(String key, T member, double score) {
return zSetOps.add(key, member, score);
}
/**
* 将一个或多个 member 元素及其 score 值加入到有序集 key 当中。
* 如果某个 member 已经是有序集的成员，那么更新这个 member 的 score 值，
* 并通过重新插入这个 member 元素，来保证该 member 在正确的位置上。
*/
@Nullable
public Long zAdd(String key, Map scoreMembers) {
Set> tuples = new HashSet<>();
scoreMembers.forEach((k, v) -> tuples.add(new DefaultTypedTuple<>(k, v)));
return zSetOps.add(key, tuples);
}
/**
* 返回有序集 key 的基数。
*/
@Nullable
public Long zCard(String key) {
return zSetOps.zCard(key);
}
/**
* 返回有序集 key 中， score 值在 min 和 max 之间(默认包括 score 值等于 min 或 max )的成员的数量。
* 关于参数 min 和 max 的详细使用方法，请参考 ZRANGEBYSCORE 命令。
*/
@Nullable
public Long zCount(String key, double min, double max) {
return zSetOps.count(key, min, max);
}
/**
* 为有序集 key 的成员 member 的 score 值加上增量 increment 。
*/
@Nullable
public Double zIncrBy(String key, T member, double score) {
return zSetOps.incrementScore(key, member, score);
}
/**
* 返回有序集 key 中，指定区间内的成员。
* 其中成员的位置按 score 值递增(从小到大)来排序。
* 具有相同 score 值的成员按字典序(lexicographical order )来排列。
* 如果你需要成员按 score 值递减(从大到小)来排列，请使用 ZREVRANGE 命令。
*/
@Nullable
public Set zRange(String key, long start, long end) {
return (Set) zSetOps.range(key, start, end);
}
/**
* 返回有序集 key 中，指定区间内的成员。
* 其中成员的位置按 score 值递减(从大到小)来排列。
* 具有相同 score 值的成员按字典序的逆序(reverse lexicographical order)排列。
* 除了成员按 score 值递减的次序排列这一点外， ZREVRANGE 命令的其他方面和 ZRANGE 命令一样。
*/
@Nullable
public Set zRevrange(String key, long start, long end) {
return (Set) zSetOps.reverseRange(key, start, end);
}
/**
* 返回有序集 key 中，所有 score 值介于 min 和 max 之间(包括等于 min 或 max )的成员。
* 有序集成员按 score 值递增(从小到大)次序排列。
*/
@Nullable
public Set zRangeByScore(String key, double min, double max) {
return (Set) zSetOps.rangeByScore(key, min, max);
}
/**
* 返回有序集 key 中成员 member 的排名。其中有序集成员按 score 值递增(从小到大)顺序排列。
* 排名以 0 为底，也就是说， score 值最小的成员排名为 0 。
* 使用 ZREVRANK 命令可以获得成员按 score 值递减(从大到小)排列的排名。
*/
@Nullable
public Long zRank(String key, T member) {
return zSetOps.rank(key, member);
}
/**
* 返回有序集 key 中成员 member 的排名。其中有序集成员按 score 值递减(从大到小)排序。
* 排名以 0 为底，也就是说， score 值最大的成员排名为 0 。
* 使用 ZRANK 命令可以获得成员按 score 值递增(从小到大)排列的排名。
*/
@Nullable
public Long zRevrank(String key, T member) {
return zSetOps.reverseRank(key, member);
}
/**
* 移除有序集 key 中的一个或多个成员，不存在的成员将被忽略。
* 当 key 存在但不是有序集类型时，返回一个错误。
*/
@Nullable
public Long zRem(String key, T... members) {
return zSetOps.remove(key, members);
}
/**
* 返回有序集 key 中，成员 member 的 score 值。
* 如果 member 元素不是有序集 key 的成员，或 key 不存在，返回 nil 。
*/
@Nullable
public Double zScore(String key, T member) {
return zSetOps.score(key, member);
}
/**
* redis publish
*
* @param channel channel
* @param message message
* @param mapper mapper
* @param 泛型标记
* @return Long
*/
@Nullable
public Long publish(String channel, T message, Function mapper) {
return redisTemplate.execute((RedisCallback) redis -> {
byte[] channelBytes = keySerialize(channel);
return redis.publish(channelBytes, mapper.apply(message));
});
}
/**
* 位图统计个数
*
* @param key key
* @return 位图统计个数
*/
@Nullable
public Long bitCount(String key) {
return redisTemplate.execute((RedisCallback) redis -> redis.bitCount(keySerialize(key)));
}
/**
* 位图统计个数，start，end可以使用负数：比如 -1 表示最后一个位，而 -2 表示倒数第二个位等。
*
* @param key key
* @param start start
* @param end end
* @return 位图统计个数
*/
@Nullable
public Long bitCount(String key, long start, long end) {
return redisTemplate.execute((RedisCallback) redis -> redis.bitCount(keySerialize(key), start, end));
}
/**
* 位图统计个数
* 注意：model 需要 redis 版本 7.0以上
*
* @param key key
* @param start start
* @param end end
* @param model model
* @return 位图统计个数
*/
@Nullable
public Long bitCount(String key, long start, long end, RedisCommand.BitMapModel model) {
return redisTemplate.execute((RedisCallback) redis ->
(Long) redis.execute(RedisCommand.BITCOUNT, keySerialize(key),
keySerialize(Long.toString(start)), keySerialize(Long.toString(end)),
keySerialize(model.name()))
);
}
/**
* 获取/操作存储在给定键处的不同位宽和任意非（必要）对齐偏移量的特定整数字段。
*
* @param key key
* @param commands commands
* @return 子命令的相应结果
*/
@Nullable
public List bitField(String key, BitFieldSubCommands commands) {
return redisTemplate.execute((RedisCallback>) redis -> redis.bitField(keySerialize(key), commands));
}
/**
* 计算第一位为 1 或者 0 的 offset 位置
*
* @param key key
* @param bit bit
* @return offset 位置
*/
@Nullable
public Long bitPos(String key, boolean bit) {
return redisTemplate.execute((RedisCallback) redis -> redis.bitPos(keySerialize(key), bit));
}
/**
* 计算range范围内为 1 或者 0 的 offset 位置
*
* @param key key
* @param bit bit
* @return offset 位置
*/
@Nullable
public Long bitPos(String key, boolean bit, Range range) {
return redisTemplate.execute((RedisCallback) redis -> redis.bitPos(keySerialize(key), bit, range));
}
/**
* 获取第 offset 位的值（offset 从 0 开始算）
*
* @param key key
* @param offset offset
* @return 第 offset 位的值
*/
@Nullable
public Boolean getBit(String key, long offset) {
return redisTemplate.execute((RedisCallback) redis -> redis.getBit(keySerialize(key), offset));
}
/**
* 设置第 offset 位的值（offset 从 0 开始算）
*
* @param key key
* @param offset offset
* @param value value
* @return 第 offset 位的值
*/
@Nullable
public Boolean setBit(String key, long offset, boolean value) {
return redisTemplate.execute((RedisCallback) redis -> redis.setBit(keySerialize(key), offset, value));
}
/**
* redisKey 序列化
*
* @param redisKey redisKey
* @return byte array
*/
public byte[] keySerialize(String redisKey) {
RedisSerializer keySerializer = (RedisSerializer) this.redisTemplate.getKeySerializer();
return Objects.requireNonNull(keySerializer.serialize(redisKey), "Redis key is null.");
}
/**
* redisKey 序列化
*
* @param redisKey redisKey
* @return byte array
*/
public byte[] hashKeySerializer(Object redisKey) {
RedisSerializer hashKeySerializer = (RedisSerializer) this.redisTemplate.getHashKeySerializer();
return Objects.requireNonNull(hashKeySerializer.serialize(redisKey), "Redis key is null.");
}
/**
* redisKey 序列化
*
* @param redisKey redisKey
* @return byte array
*/
public String keyDeserialize(byte[] redisKey) {
RedisSerializer keySerializer = (RedisSerializer) this.redisTemplate.getKeySerializer();
return Objects.requireNonNull(keySerializer.deserialize(redisKey), "Redis key is null.");
}
public RedisTemplate getRedisTemplate() {
return redisTemplate;
}
public ValueOperations getValueOps() {
return valueOps;
}
public HashOperations getHashOps() {
return hashOps;
}
public ListOperations getListOps() {
return listOps;
}
public SetOperations getSetOps() {
return setOps;
}
public ZSetOperations getzSetOps() {
return zSetOps;
}
public GeoOperations getGeoOps() {
return geoOps;
}
public HyperLogLogOperations getHllOps() {
return hllOps;
}
}
