XXXTemplate 是 Spring 的一大设计特色,其中,RedisTemplate 功能是提供对 Redis 的支持。
RedisTemplate 是 Spring Boot 访问 Redis 的核心组件,是 SpringBoot 集成 Redis 的客户端方式。它的底层通过 RedisConnectionFactory 对多种 Redis 驱动进行集成,上层通过 XXXOperations 提供丰富的 API,并结合 Spring 基于泛型的 bean 注入,未开发提供了极大的便利。
一、Redis常用的数据类型
- String:字符串类型,可以存储多种类型,如:字符串,JSON串,二进制,序列化对象等;
- Hash:key-value结构,就像Java里的Map,特别适合存储对象;
- List:双端链表的结构,即可以作为栈,又可以作为队列,可以进行集合的头部或者尾部添加删除元素;
- Set:Set集合是String类型的无序集合,通过hashtable实现,可以对集合取交集,并集,差集;
- Sorted set:是String类型的有序集合,并且,每个元素都会关联一个 double 类型的分数,Redis 通过分数可以为集合中的成员进行从小到大的排序。有序集合的成员是唯一的,但分数(score)却可以重复。
二、RedisTemplate 常用方法
1. String类型
1.1 判断是否有key所对应的值,有则返回true,没有则返回false;
redisTemplate.hasKey(key);
1.2 有则取出key值所对应的值;
redisTemplate.opsForValue().get(key);
1.3 删除单个key值;
redisTemplate.delete(key);
1.4 批量删除key;
redisTemplate.delete(keys); //其中keys:Collection<K> keys
1.5 将当前传入的key值序列化为byte[]类型;
redisTemplate.dump(key);
1.6 设置过期时间;
-
Boolean redisTemplate.expire(
key, timeout,
unit);
/
/ 多久以后过期
-
-
Boolean redisTemplate.expireAt(
key,
date);
/
/
Date
date 具体过期时间
1.7 查找匹配的key值,返回一个Set集合类型( * 代表查询所有);
Set<String> redisTemplate.keys(pattern); // pattern为正则表达式
1.8 修改redis中key的名称;
-
void redisTemplate.
rename(oldKey, newKey);
-
-
// 如果旧值存在时,将旧值改为新值
-
Boolean redisTemplate.
renameIfAbsent(oldKey, newKey);
1.9 返回传入key所存储的值的类型;
DataType redisTemplate.type(key);
1.10 从redis中随机取出一个key;
redisTemplate.randomKey();
1.11 返回当前key所对应的剩余过期时间;
-
Long redisTemplate.getExpire(
key);
-
-
/
/ TimeUnit
unit 指定返回的时间的单位
-
Long redisTemplate.getExpire(
key,
unit);
1.12 将key持久化保存;
Boolean redisTemplate.persist(key);
1.13 将当前数据库的key移动到指定redis中数据库当中;
Boolean redisTemplate.move(key, dbIndex);
1.14 设置当前的key以及value值;
-
redisTemplate.opsForValue().
set(
key,
value);
-
-
/
/ 带过期时间timeout,和时间单位
unit
-
redisTemplate.opsForValue().
set(
key,
value, timeout,
unit);
1.15 返回key中字符串 start~end 位置的子字符;
String redisTemplate.opsForValue().get(key, start, end);
1.16 将旧的key设置为value,并且返回旧的key;
String redisTemplate.opsForValue().getAndSet(key, value);
1.17 批量获取值;
List<String> redisTemplate.opsForValue().multiGet(keys); // Collection<String> keys
1.18 在原有的值基础上新增字符串到末尾;
redisTemplate.opsForValue().append(key, value);
1.19 给 key 对应的 value 值进行自增(正值则自增,负值则自减),如果该 key 没有 value值,则默认为 0;
-
Double redisTemplate
.opsForValue()
.increment(key, increment);
// double increment
-
-
Long redisTemplate
.opsForValue()
.increment(key, increment);
// long increment
1.20 如果对应的map集合名称不存在,则添加否则不做修改;
-
Map valueMap =
new
HashMap();
-
valueMap.
put(
"valueMap1",
"map1");
-
valueMap.
put(
"valueMap2",
"map2");
-
valueMap.
put(
"valueMap3",
"map3");
-
redisTemplate.
opsForValue().
multiSetIfAbsent(valueMap);
1.21 设置map集合到redis;
-
Map valueMap =
new
HashMap();
-
valueMap.
put(
"valueMap1",
"map1");
-
valueMap.
put(
"valueMap2",
"map2");
-
valueMap.
put(
"valueMap3",
"map3");
-
redisTemplate.
opsForValue().
multiSet(valueMap);
1.22 获取字符串的长度;
redisTemplate.opsForValue().size(key);
1.23 用 value 参数覆写给定 key 所储存的字符串值,从偏移量 offset 开始;
redisTemplate.opsForValue().set(key, value, offset);
1.24 重新设置key对应的值,如果存在返回false,否则返回true;
redisTemplate.opsForValue().setIfAbsent(key, value);
1.25 将值 value 关联到 key,并将 key 的过期时间设为 timeout;
redisTemplate.opsForValue().set(key, value, timeout, unit);
1.26 对key所储存的字符串值,获取指定偏移量上的位(bit);
redisTemplate.opsForValue().getBit(key, offset);
1.27 将二进制第offset位值变为value;
redisTemplate.opsForValue().setBit(key, offset, value);
2. Hash类型
2.1 以map集合的形式添加键值对;
redisTemplate.opsForHash().putAll(key, maps); // Map<String, String> maps
2.2 获取变量中的键值对;
Map<Object, Object> redisTemplate.opsForHash().entries(key);
2.3 查看hash表中指定字段是否存在;
Boolean redisTemplate.opsForHash().hasKey(key, field);
2.4 获取变量中的指定map键是否有值,如果存在该map键则获取值,没有则返回null;
redisTemplate.opsForHash().get(key, field);
2.5 新增hashMap值;
redisTemplate.opsForHash().put(key, hashKey, value);
2.6 仅当hashKey不存在时才设置;
Boolean redisTemplate.opsForHash().putIfAbsent(key, hashKey, value);
2.7 删除一个或者多个hash表字段;
Long redisTemplate.opsForHash().delete(key, fields); // Object... fields
2.8 给哈希表key中的指定字段的整数值加上增量increment;
-
public
Double
hIncrByDouble(
String key, Object field, double delta) {
-
return redisTemplate.
opsForHash().
increment(key, field, delta);
-
}
-
public
Long
hashIncrBy(
String key, Object field, long increment) {
-
return redisTemplate.
opsForHash().
increment(key, field, increment);
-
}
2.9 获取所有hash表中字段;
redisTemplate.opsForHash().keys(key);
2.10 获取hash表中字段的数量;
redisTemplate.opsForHash().size(key);
2.11 获取hash表中存在的多个值;
List<Object> redisTemplate.opsForHash().values(key);
2.12 匹配获取键值对,ScanOptions.NONE为获取全部键对;
-
public
Cursor
<Entry
<
Object,
Object
>> hashScan(String key, ScanOptions options) {
-
return redisTemplate.opsForHash().scan(
key,
options);
-
}
3. List类型
3.1 通过索引获取列表中的元素;
redisTemplate.opsForList().index(key, index);
3.2 获取列表指定范围内的元素(start开始位置, 0是开始位置,end 结束位置, -1返回所有);
redisTemplate.opsForList().range(key, start, end);
3.3 存储在list的头部,即添加一个就把它放在最前面的索引处;
redisTemplate.opsForList().leftPush(key, value);
3.4 把多个值存入List中(value可以是多个值,也可以是一个Collection value);
redisTemplate.opsForList().leftPushAll(key, value);
3.5 List存在的时候再加入;
redisTemplate.opsForList().leftPushIfPresent(key, value);
3.6 如果pivot处值存在则在pivot前面添加;
redisTemplate.opsForList().leftPush(key, pivot, value);
3.7 按照先进先出的顺序来添加(value可以是多个值,或者是Collection var2);
-
redisTemplate
.opsForList()
.rightPush(key, value);
-
-
redisTemplate
.opsForList()
.rightPushAll(key, value);
3.8 在pivot元素的右边添加值;
redisTemplate.opsForList().rightPush(key, pivot, value);
3.9 设置指定索引处元素的值;
redisTemplate.opsForList().set(key, index, value);
3.10 移除并获取列表中第一个元素(如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止);
-
redisTemplate
.opsForList()
.leftPop(key);
-
-
redisTemplate
.opsForList()
.leftPop(key, timeout, unit);
3.11 移除并获取列表最后一个元素;
-
redisTemplate
.opsForList()
.rightPop(key);
-
-
redisTemplate
.opsForList()
.rightPop(key, timeout, unit);
3.12 从一个队列的右边弹出一个元素并将这个元素放入另一个指定队列的最左边;
-
redisTemplate
.opsForList()
.rightPopAndLeftPush(sourceKey, destinationKey);
-
-
redisTemplate
.opsForList()
.rightPopAndLeftPush(sourceKey, destinationKey, timeout, unit);
3.13 删除集合中值等于value的元素(index=0, 删除所有值等于value的元素; index>0, 从头部开始删除第一个值等于value的元素; index<0, 从尾部开始删除第一个值等于value的元素);
redisTemplate.opsForList().remove(key, index, value);
3.14 将List列表进行剪裁;
redisTemplate.opsForList().trim(key, start, end);
3.15 获取当前key的List列表长度;
redisTemplate.opsForList().size(key);
4. Set类型
4.1 添加元素;
redisTemplate.opsForSet().add(key, values);
4.2 移除元素(单个值、多个值);
redisTemplate.opsForSet().remove(key, values);
4.3 删除并且返回一个随机的元素;
redisTemplate.opsForSet().pop(key);
4.4 获取集合的大小;
redisTemplate.opsForSet().size(key);
4.5 判断集合是否包含value;
redisTemplate.opsForSet().isMember(key, value);
4.6 获取两个集合的交集(key对应的无序集合与otherKey对应的无序集合求交集);
redisTemplate.opsForSet().intersect(key, otherKey);
4.7 获取多个集合的交集(Collection var2);
redisTemplate.opsForSet().intersect(key, otherKeys);
4.8 key集合与otherKey集合的交集存储到destKey集合中(其中otherKey可以为单个值或者集合);
redisTemplate.opsForSet().intersectAndStore(key, otherKey, destKey);
4.9 key集合与多个集合的交集存储到destKey无序集合中;
redisTemplate.opsForSet().intersectAndStore(key, otherKeys, destKey);
4.10 获取两个或者多个集合的并集(otherKeys可以为单个值或者是集合);
redisTemplate.opsForSet().union(key, otherKeys);
4.11 key集合与otherKey集合的并集存储到destKey中(otherKeys可以为单个值或者是集合);
redisTemplate.opsForSet().unionAndStore(key, otherKey, destKey);
4.12 获取两个或者多个集合的差集(otherKeys可以为单个值或者是集合);
redisTemplate.opsForSet().difference(key, otherKeys);
4.13 差集存储到destKey中(otherKeys可以为单个值或者集合);
redisTemplate.opsForSet().differenceAndStore(key, otherKey, destKey);
4.14 随机获取集合中的一个/count个元素;
-
redisTemplate.opsForSet().randomMember(
key);
-
-
/
/ 随机获取集合中
count个元素
-
redisTemplate.opsForSet().randomMembers(
key,
count);
4.15 获取集合中的所有元素;
redisTemplate.opsForSet().members(key);
4.16 获取多个key无序集合中的元素(去重),count表示个数;
redisTemplate.opsForSet().distinctRandomMembers(key, count);
4.17 遍历set类似于Interator(ScanOptions.NONE为显示所有的);
redisTemplate.opsForSet().scan(key, options);
5. ZSet类型
5.1 添加元素(有序集合是按照元素的score值由小到大进行排列);
redisTemplate.opsForZSet().add(key, value, score);
5.2 删除对应的value,value可以为多个值;
redisTemplate.opsForZSet().remove(key, values);
5.3 增加元素的score值,并返回增加后的值;
redisTemplate.opsForZSet().incrementScore(key, value, delta);
5.4 返回元素在集合的排名,有序集合是按照元素的score值由小到大排列;
redisTemplate.opsForZSet().rank(key, value);
5.5 返回元素在集合的排名,按元素的score值由大到小排列;
redisTemplate.opsForZSet().reverseRank(key, value);
5.6 获取集合中给定区间的元素(start 开始位置,end 结束位置, -1查询所有);
redisTemplate.opsForZSet().reverseRangeWithScores(key, start,end);
5.7 按照分数范围升序输出名称;
rangebyscore key min max [withscores]
5.8 根据分数范围删除元素;
zremrangebyscore key min max [withscores]
5.9 按照分数范围降序输出名称;
-
redisTemplate.opsForZSet().reverseRangeByScore(
key, min, max);
-
-
/
/返回值为:
Set
<ZSetOperations.TypedTuple
<V
>>
-
redisTemplate.opsForZSet().reverseRangeByScoreWithScores(
key, min, max);
5.10 从高到低的排序集中获取分数在最小和最大值之间的元素;
redisTemplate.opsForZSet().reverseRangeByScore(key, min, max, start, end);
5.11 根据score值获取集合元素数量;
redisTemplate.opsForZSet().count(key, min, max);
5.12 获取集合的大小;
-
redisTemplate
.opsForZSet()
.size(key);
-
-
redisTemplate
.opsForZSet()
.zCard(key);
5.13 获取集合中key、value元素对应的score值;
redisTemplate.opsForZSet().score(key, value);
5.14 移除指定索引位置处的成员;
redisTemplate.opsForZSet().removeRange(key, start, end);
5.15 移除指定score范围的集合成员;
redisTemplate.opsForZSet().removeRangeByScore(key, min, max);
5.16 获取key和otherKey的并集并存储在destKey中(其中otherKeys可以为单个字符串或者字符串集合);
redisTemplate.opsForZSet().unionAndStore(key, otherKey, destKey);
5.17 获取key和otherKey的交集并存储在destKey中(其中otherKeys可以为单个字符串或者字符串集合);
redisTemplate.opsForZSet().intersectAndStore(key, otherKey, destKey);
5.遍历集合(和iterator一模一样)
-
Cursor
<TypedTuple
<
Object
>> scan = opsForZSet.scan("test3", ScanOptions.NONE);
-
while (scan.hasNext()){
-
ZSetOperations.TypedTuple
<
Object
> item
= scan.
next();
-
System.out.println(item.getValue()
+
":"
+ item.getScore());
-
}