RedisTemplate 常用方法汇总

本文详细介绍了SpringBoot中RedisTemplate如何支持Redis的各种数据类型(String,Hash,List,Set,ZSet),涵盖了RedisTemplate提供的常用方法,如存储、检索、操作和管理不同数据结构的关键操作。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

 XXXTemplate 是 Spring 的一大设计特色,其中,RedisTemplate 功能是提供对 Redis 的支持。

RedisTemplate  是 Spring Boot 访问 Redis 的核心组件,是 SpringBoot 集成 Redis 的客户端方式。它的底层通过 RedisConnectionFactory 对多种 Redis 驱动进行集成,上层通过 XXXOperations 提供丰富的 API,并结合 Spring 基于泛型的 bean 注入,未开发提供了极大的便利。


一、Redis常用的数据类型

  1. String:字符串类型,可以存储多种类型,如:字符串,JSON串,二进制,序列化对象等;
  2. Hash:key-value结构,就像Java里的Map,特别适合存储对象;
  3. List:双端链表的结构,即可以作为栈,又可以作为队列,可以进行集合的头部或者尾部添加删除元素;
  4. Set:Set集合是String类型的无序集合,通过hashtable实现,可以对集合取交集,并集,差集;
  5. 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 设置过期时间;


   
   
  1. Boolean redisTemplate.expire( key, timeout, unit); / / 多久以后过期
  2. Boolean redisTemplate.expireAt( key, date); / / Date date 具体过期时间

1.7 查找匹配的key值,返回一个Set集合类型( * 代表查询所有);

Set<String> redisTemplate.keys(pattern); // pattern为正则表达式

   
   

1.8 修改redis中key的名称;


   
   
  1. void redisTemplate. rename(oldKey, newKey);
  2. // 如果旧值存在时,将旧值改为新值
  3. Boolean redisTemplate. renameIfAbsent(oldKey, newKey);

1.9 返回传入key所存储的值的类型;

DataType redisTemplate.type(key);
   
   

1.10 从redis中随机取出一个key;

redisTemplate.randomKey();
   
   

1.11 返回当前key所对应的剩余过期时间;


   
   
  1. Long redisTemplate.getExpire( key);
  2. / / TimeUnit unit 指定返回的时间的单位
  3. 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值;


   
   
  1. redisTemplate.opsForValue(). set( key, value);
  2. / / 带过期时间timeout,和时间单位 unit
  3. 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;


   
   
  1. Double redisTemplate .opsForValue() .increment(key, increment); // double increment
  2. Long redisTemplate .opsForValue() .increment(key, increment); // long increment

1.20 如果对应的map集合名称不存在,则添加否则不做修改;


   
   
  1. Map valueMap = new HashMap();
  2. valueMap. put( "valueMap1", "map1");
  3. valueMap. put( "valueMap2", "map2");
  4. valueMap. put( "valueMap3", "map3");
  5. redisTemplate. opsForValue(). multiSetIfAbsent(valueMap);

1.21 设置map集合到redis;


   
   
  1. Map valueMap = new HashMap();
  2. valueMap. put( "valueMap1", "map1");
  3. valueMap. put( "valueMap2", "map2");
  4. valueMap. put( "valueMap3", "map3");
  5. 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;


   
   
  1. public Double hIncrByDouble( String key, Object field, double delta) {
  2. return redisTemplate. opsForHash(). increment(key, field, delta);
  3. }
  4. public Long hashIncrBy( String key, Object field, long increment) {
  5. return redisTemplate. opsForHash(). increment(key, field, increment);
  6. }

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为获取全部键对;


   
   
  1. public Cursor <Entry < Object, Object >> hashScan(String key, ScanOptions options) {
  2. return redisTemplate.opsForHash().scan( key, options);
  3. }

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);


   
   
  1. redisTemplate .opsForList() .rightPush(key, value);
  2. redisTemplate .opsForList() .rightPushAll(key, value);

3.8 在pivot元素的右边添加值;

redisTemplate.opsForList().rightPush(key, pivot, value);
   
   

3.9 设置指定索引处元素的值;

redisTemplate.opsForList().set(key, index, value);
   
   

3.10 移除并获取列表中第一个元素(如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止);


   
   
  1. redisTemplate .opsForList() .leftPop(key);
  2. redisTemplate .opsForList() .leftPop(key, timeout, unit);

3.11 移除并获取列表最后一个元素;


   
   
  1. redisTemplate .opsForList() .rightPop(key);
  2. redisTemplate .opsForList() .rightPop(key, timeout, unit);

3.12 从一个队列的右边弹出一个元素并将这个元素放入另一个指定队列的最左边;


   
   
  1. redisTemplate .opsForList() .rightPopAndLeftPush(sourceKey, destinationKey);
  2. 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个元素;


   
   
  1. redisTemplate.opsForSet().randomMember( key);
  2. / / 随机获取集合中 count个元素
  3. 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 按照分数范围降序输出名称;


   
   
  1. redisTemplate.opsForZSet().reverseRangeByScore( key, min, max);
  2. / /返回值为: Set <ZSetOperations.TypedTuple <V >>
  3. 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 获取集合的大小;


   
   
  1. redisTemplate .opsForZSet() .size(key);
  2. 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一模一样)


   
   
  1. Cursor <TypedTuple < Object >> scan = opsForZSet.scan("test3", ScanOptions.NONE);
  2. while (scan.hasNext()){
  3. ZSetOperations.TypedTuple < Object > item = scan. next();
  4. System.out.println(item.getValue() + ":" + item.getScore());
  5. }

### Redis ZSet 有序集合 #### 使用方法 ZSet 是 Redis 提供的一种特殊的数据结构,即有序集合。它类似于 Set 类型,但是其中的每一个成员都会关联一个分数(score),通过这个分数可以对集合中的成员进行排序。 为了查询某个 `value` 对应的 `score`,可以通过如下 Java 方法实现: ```java public Double score(String key, String value) { return redisTemplate.opsForZSet().score(key, value); } ``` 此函数用于获取指定键下的特定值所对应的分数[^4]。如果该值存在于集合中则返回相应的分数;反之,则返回 null。 #### 数据结构 内部编码方面,在满足一定条件下,Redis 的 ZSet 采用 ziplist(压缩列表)来存储数据。具体来说,当有序集合内的元素数量小于配置项 `zset-max-ziplist-entries` (默认为128个),并且每个元素大小不超过 `zset-max-ziplist-value` (默认64字节)时,就会启用这种紧凑形式以节省内存空间[^3]。 对于较大的 ZSet 或者不满足上述条件的情况,默认情况下会使用跳跃表(skiplist)来进行高效的操作处理[^5]。 #### 操作命令 以下是部分常用的针对 ZSet 进行增删改查等基本操作的命令汇总: - **增加/更新成员及其分数** - `ZADD key score member [score member ...]`: 向名为key的sorted set中添加带有给定分值的member元素,已存在的话就更新其分值并重新排列位置。 - **移除成员** - `ZREM key member [member ...]`: 移除有序集key中的一个或多个成员,不存在的成员将被忽略。当key存在但不是有序集类型时,返回一个错误[^2]。 - **获取范围内的成员** - `ZRANGE key start stop [WITHSCORES]`: 返回按升序排列后的索引介于start至stop之间的所有成员。 - `ZREVRANGE key start stop [WITHSCORES]`: 功能同上,只是按照降序顺序取回结果。 - **基于分数区间筛选成员** - `ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT offset count]`: 获取得分位于[min,max]区间的全部成员,并可选地附带它们各自的分数以及应用偏移量和计数限制参数。 - **其他实用功能** - `ZCARD key`: 计算集合内共有多少条记录。 - `ZCOUNT key min max`: 统计得分为[min,max]范围内有多少个成员。 - `ZRANK/ZREVRANK key member`: 查找某成员在整个序列里的排名情况(前者正向后者逆向)。 - `ZINCRBY key increment member`: 修改已有成员的分数值,增量为increment。 - `ZUNIONSTORE destination numkeys key [key ...] [WEIGHTS weight [weight ...]] [AGGREGATE SUM|MIN|MAX]`: 实现两个及以上有序集合之间求交集、并集运算并将最终得到的新集合保存到destination处。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值