程序包 net.wenzuo.atom.redis.service

接口 RedisService

所有已知实现类:

RedisServiceImpl

public interface RedisService

从以下版本开始:

2023-06-15

作者:

Catch

方法概要

修饰符和类型	方法	说明
Long	countExistingKeys(Collection<String> keys)	获取 key 集合中存在的 key 数量
Long	decrement(String key)	按步长为 delta 递减 value
Long	decrement(String key, long delta)	按步长为 delta 递减 value
Boolean	delete(String key)	删除 key
Long	delete(Collection<String> keys)	批量删除 key
Boolean	expire(String key, long timeout, TimeUnit unit)	设置 key 过期时间
Boolean	expire(String key, Duration duration)	设置 key 过期时间
Boolean	expireAt(String key, Instant expireAt)	设置 key 在指定的时间过期
Boolean	expireAt(String key, Date date)	设置 key 在指定的时间过期
<T> T	get(String key, Class<?> wrapper, Class<?>... inners)	获取泛型 value
<T> T	get(String key, Class<T> clazz)	获取 value
<T> T	getAndDelete(String key, Class<?> wrapper, Class<?>... inners)	获取泛型 value 并删除 key
<T> T	getAndDelete(String key, Class<T> clazz)	获取 value 并删除 key
<T> T	getAndExpire(String key, long timeout, TimeUnit unit, Class<?> wrapper, Class<?>... inners)	获取泛型 value 并设置过期时间
<T> T	getAndExpire(String key, long timeout, TimeUnit unit, Class<T> clazz)	获取 value 并设置过期时间
<T> T	getAndExpire(String key, Duration timeout, Class<?> wrapper, Class<?>... inners)	获取泛型 value 并设置过期时间
<T> T	getAndExpire(String key, Duration timeout, Class<T> clazz)	获取 value 并设置过期时间
<T> T	getAndPersist(String key, Class<?> wrapper, Class<?>... inners)	获取泛型 value 并持久化 key, 此操作会移除 key 的过期时间
<T> T	getAndPersist(String key, Class<T> clazz)	获取 value 并持久化 key, 此操作会移除 key 的过期时间
<T> T	getAndSet(String key, Object value, Class<?> wrapper, Class<?>... inners)	保存泛型 value 并返回旧的 value
<T> T	getAndSet(String key, Object value, Class<T> clazz)	保存 value 并返回旧的 value
Long	getExpire(String key)	获取过期时间, 单位: 秒
Long	getExpire(String key, TimeUnit timeUnit)	获取过期时间
Boolean	hasKey(String key)	是否存在 key
Long	increment(String key)	按步长为 1 递增 value
Double	increment(String key, double delta)	按步长为 delta 递增 value
Long	increment(String key, long delta)	按步长为 delta 递增 value
Set<String>	keys(String pattern)	找到与模式匹配的所有键
<T> List<T>	multiGet(Collection<String> keys, Class<T> clazz)	批量获取 value, 按键的顺序排列,不存在则用 null 填充
void	multiSet(Map<String,?> map)	批量设置 key-value ,使用 redis mset 命令
Boolean	multiSetIfAbsent(Map<String,?> map)	批量设置 key-value ,使用 redis mset 命令, 如果 key 不存在则保存 value, 反之不保存
Boolean	persist(String key)	设置 key 永不过期
void	rename(String oldKey, String newKey)	将 key 重命名为 newKey
Boolean	renameIfAbsent(String oldKey, String newKey)	当 newKey 不存在时，将 key 重命名为 newKey
void	set(String key, Object value)	保存 value
void	set(String key, Object value, long timeout, TimeUnit unit)	保存 value 并设置过期时间
void	set(String key, Object value, Duration timeout)	保存 value 并设置过期时间
Boolean	setIfAbsent(String key, Object value)	如果 key 不存在则保存 value, 反之不保存
Boolean	setIfAbsent(String key, Object value, long timeout, TimeUnit unit)	如果 key 不存在则保存 value 并设置过期时间, 反之不保存
Boolean	setIfAbsent(String key, Object value, Duration timeout)	如果 key 不存在则保存 value 并设置过期时间, 反之不保存
Boolean	setIfPresent(String key, Object value)	如果 key 存在则保存 value, 反之不保存
Boolean	setIfPresent(String key, Object value, long timeout, TimeUnit unit)	如果 key 存在则保存 value 并设置过期时间, 反之不保存
Boolean	setIfPresent(String key, Object value, Duration timeout)	如果 key 存在则保存 value 并设置过期时间, 反之不保存
Boolean	unlink(String key)	从 key 空间中取消链接.
Long	unlink(Collection<String> keys)	批量从 key 空间中取消链接.

方法详细资料

set

void set(String key,
 Object value)

保存 value

参数:

key - 键

value - 值

set

void set(String key,
 Object value,
 long timeout,
 TimeUnit unit)

保存 value 并设置过期时间

参数:

key - 键

value - 值

timeout - 超时时间

unit - 时间单位

set

void set(String key,
 Object value,
 Duration timeout)

保存 value 并设置过期时间

参数:

key - 键

value - 值

timeout - 超时时间

setIfAbsent

Boolean setIfAbsent(String key,
 Object value)

如果 key 不存在则保存 value, 反之不保存

参数:

key - 键

value - 值

返回:

是否保存成功

setIfAbsent

Boolean setIfAbsent(String key,
 Object value,
 long timeout,
 TimeUnit unit)

如果 key 不存在则保存 value 并设置过期时间, 反之不保存

参数:

key - 键

value - 值

timeout - 超时时间

unit - 时间单位

返回:

是否保存成功

setIfAbsent

Boolean setIfAbsent(String key,
 Object value,
 Duration timeout)

如果 key 不存在则保存 value 并设置过期时间, 反之不保存

参数:

key - 键

value - 值

timeout - 超时时间

返回:

是否保存成功

setIfPresent

Boolean setIfPresent(String key,
 Object value)

如果 key 存在则保存 value, 反之不保存

参数:

key - 键

value - 值

返回:

是否保存成功

setIfPresent

Boolean setIfPresent(String key,
 Object value,
 long timeout,
 TimeUnit unit)

如果 key 存在则保存 value 并设置过期时间, 反之不保存

参数:

key - 键

value - 值

timeout - 超时时间

unit - 时间单位

返回:

是否保存成功

setIfPresent

Boolean setIfPresent(String key,
 Object value,
 Duration timeout)

如果 key 存在则保存 value 并设置过期时间, 反之不保存

参数:

key - 键

value - 值

timeout - 超时时间

返回:

是否保存成功

multiSet

void multiSet(Map<String,?> map)

批量设置 key-value ,使用 redis mset 命令

参数:

map - key-value

multiSetIfAbsent

Boolean multiSetIfAbsent(Map<String,?> map)

批量设置 key-value ,使用 redis mset 命令, 如果 key 不存在则保存 value, 反之不保存

参数:

map - key-value

get

<T> T get(String key,
 Class<T> clazz)

获取 value

类型参数:

T - 泛型

参数:

key - 键

clazz - 类型

返回:

值

get

<T> T get(String key,
 Class<?> wrapper,
 Class<?>... inners)

获取泛型 value

如：List<Object> list = redisService.get(key, List.class, Object.class)

类型参数:

T - 泛型

参数:

key - 键

wrapper - 包装类

inners - 内部类

返回:

值

getAndDelete

<T> T getAndDelete(String key,
 Class<T> clazz)

获取 value 并删除 key

类型参数:

T - 泛型

参数:

key - 键

clazz - 类型

返回:

值

getAndDelete

<T> T getAndDelete(String key,
 Class<?> wrapper,
 Class<?>... inners)

获取泛型 value 并删除 key

如：List<Object> list = redisService.getAndDelete(key, List.class, Object.class)

类型参数:

T - 泛型

参数:

key - 键

wrapper - 包装类

inners - 内部类

返回:

值

getAndExpire

<T> T getAndExpire(String key,
 long timeout,
 TimeUnit unit,
 Class<T> clazz)

获取 value 并设置过期时间

类型参数:

T - 泛型

参数:

key - 键

timeout - 超时时间

unit - 时间单位

clazz - 类型

返回:

值

getAndExpire

<T> T getAndExpire(String key,
 long timeout,
 TimeUnit unit,
 Class<?> wrapper,
 Class<?>... inners)

获取泛型 value 并设置过期时间

如：List<Object> list = redisService.getAndExpire(key, 1, TimeUnit.MINUTES, List.class, Object.class)

类型参数:

T - 泛型

参数:

key - 键

timeout - 超时时间

unit - 时间单位

wrapper - 包装类

inners - 内部类

返回:

值

getAndExpire

<T> T getAndExpire(String key,
 Duration timeout,
 Class<T> clazz)

获取 value 并设置过期时间

参数:

key - 键

timeout - 超时时间

clazz - 类型

返回:

值

getAndExpire

<T> T getAndExpire(String key,
 Duration timeout,
 Class<?> wrapper,
 Class<?>... inners)

获取泛型 value 并设置过期时间

如：List<Object> list = redisService.getAndExpire(key, Duration.ofMinutes(1), List.class, Object.class)

类型参数:

T - 泛型

参数:

key - 键

timeout - 超时时间

wrapper - 包装类

inners - 内部类

返回:

值

getAndPersist

<T> T getAndPersist(String key,
 Class<T> clazz)

获取 value 并持久化 key, 此操作会移除 key 的过期时间

类型参数:

T - 泛型

参数:

key - 键

clazz - 类型

返回:

值

getAndPersist

<T> T getAndPersist(String key,
 Class<?> wrapper,
 Class<?>... inners)

获取泛型 value 并持久化 key, 此操作会移除 key 的过期时间

如：List<Object> list = redisService.getAndPersist(key, List.class, Object.class)

类型参数:

T - 泛型

参数:

key - 键

wrapper - 包装类

inners - 内部类

返回:

值

getAndSet

<T> T getAndSet(String key,
 Object value,
 Class<T> clazz)

保存 value 并返回旧的 value

类型参数:

T - 泛型

参数:

key - 键

value - 新值

clazz - 类型

返回:

旧值

getAndSet

<T> T getAndSet(String key,
 Object value,
 Class<?> wrapper,
 Class<?>... inners)

保存泛型 value 并返回旧的 value

如：List<Object> list = redisService.getAndSet(key, value, List.class, Object.class)

类型参数:

T - 泛型

参数:

key - 键

value - 新值

wrapper - 包装类

inners - 内部类

返回:

旧值

multiGet

<T> List<T> multiGet(Collection<String> keys,
 Class<T> clazz)

批量获取 value, 按键的顺序排列,不存在则用 null 填充

参数:

keys - 键集合

返回:

值集合

increment

Long increment(String key)

按步长为 1 递增 value

参数:

key - 键

返回:

递增后的值

increment

Long increment(String key,
 long delta)

按步长为 delta 递增 value

参数:

key - 键

返回:

递增后的值

increment

Double increment(String key,
 double delta)

按步长为 delta 递增 value

参数:

key - 键

返回:

递增后的值

decrement

Long decrement(String key)

按步长为 delta 递减 value

参数:

key - 键

返回:

递减后的值

decrement

Long decrement(String key,
 long delta)

按步长为 delta 递减 value

参数:

key - 键

返回:

递减后的值

hasKey

Boolean hasKey(String key)

是否存在 key

参数:

key - 键

返回:

是否存在

countExistingKeys

Long countExistingKeys(Collection<String> keys)

获取 key 集合中存在的 key 数量

参数:

keys - 键集合

返回:

存在的 key 数量

delete

Boolean delete(String key)

删除 key

参数:

key - 键

返回:

是否删除成功

delete

Long delete(Collection<String> keys)

批量删除 key

参数:

keys - 键集合

返回:

删除的数量

unlink

Boolean unlink(String key)

从 key 空间中取消链接. 与 delete 不同，这里的内存回收是异步发生的

参数:

key - 键

返回:

是否成功

unlink

Long unlink(Collection<String> keys)

批量从 key 空间中取消链接. 与 delete 不同，这里的内存回收是异步发生的

参数:

keys - 键集合

返回:

取消链接的数量

keys

Set<String> keys(String pattern)

找到与模式匹配的所有键

匹配示例:

h?llo matches hello, hallo and hxllo

h*llo matches hllo and heeeello

h[ae]llo matches hello and hallo, but not hillo

h[^e]llo matches hallo, hbllo, ... but not hello

h[a-b]llo matches hallo and hbllo

参数:

pattern - 模式

返回:

匹配的所有键

rename

void rename(String oldKey,
 String newKey)

将 key 重命名为 newKey

参数:

oldKey - 旧键

newKey - 新键

renameIfAbsent

Boolean renameIfAbsent(String oldKey,
 String newKey)

当 newKey 不存在时，将 key 重命名为 newKey

参数:

oldKey - 旧键

newKey - 新键

返回:

是否重命名成功

expire

Boolean expire(String key,
 long timeout,
 TimeUnit unit)

设置 key 过期时间

参数:

key - 键

timeout - 超时时间

unit - 时间单位

返回:

是否设置成功

expire

Boolean expire(String key,
 Duration duration)

设置 key 过期时间

参数:

key - 键

duration - 超时时间

返回:

是否设置成功

expireAt

Boolean expireAt(String key,
 Date date)

设置 key 在指定的时间过期

参数:

key - 键

date - 指定的时间过期

返回:

是否设置成功

expireAt

Boolean expireAt(String key,
 Instant expireAt)

设置 key 在指定的时间过期

参数:

key - 键

expireAt - 指定的时间过期

返回:

是否设置成功

persist

Boolean persist(String key)

设置 key 永不过期

参数:

key - 键

返回:

是否设置成功

getExpire

Long getExpire(String key)

获取过期时间, 单位: 秒

参数:

key - 键

返回:

过期时间, 单位: 秒

getExpire

Long getExpire(String key,
 TimeUnit timeUnit)

获取过期时间

参数:

key - 键

timeUnit - 时间单位

返回:

过期时间