RedisTemplate操作String及Hash数据方式

RedisTemplate用法

在实际开发中，直接使用RedisTemplate固然可以，但将其常用操作封装成工具类，能让代码更整洁、复用性更高。下面我们就来聊聊如何封装几个核心的通用方法。

封装自己的操作方法

首先，我们可以围绕RedisTemplate的基础功能，构建一套自己的工具方法。这不仅能统一操作风格，也便于后期维护和扩展。

1. 删除单个Key
封装一个delete方法，接收一个key参数，内部调用redisTemplate.delete(key)即可。这是最直接的操作。

redisTemplate.delete(key)

2. 批量删除多个Key
批量删除的思路类似，只是参数变为可变参数或集合。例如，可以定义一个deleteByKeys(String... keys)方法。

redisTemplate.delete(keys)

这里的keys对应的是可变参数：public void deleteByKey(String ...keys)。

3. 设置Key的过期时间
给指定的Key设置生存时间非常常用。我们可以封装一个方法，接收三个参数：Key、时间数值、时间单位（如秒或分钟）。

redisTemplate.expire(key, time, TimeUnit.MINUTES)

4. 获取Key的剩余过期时间
想知道一个Key还有多久失效？通过getExpire方法，传入Key即可获取其剩余的生存时间（秒）。

redisTemplate.getExpire(key)

5. 判断Key是否存在
在操作前先判断Key是否存在，可以避免一些空指针异常。这个方法同样简单，一个hasKey调用就能搞定。

redisTemplate.hasKey(key)

String 类型的操作

String是Redis最基础的数据类型，其操作也最为频繁。掌握其几种设置方式，能应对不同场景。

1. 添加缓存
设置String值有多种姿势，可以根据编码习惯选择：

// 方式一：直接通过redisTemplate的boundValueOps设置
redisTemplate.boundValueOps("StringKey").set("StringValue");
// 支持设置过期时间
redisTemplate.boundValueOps("StringKey").set("StringValue", 1, TimeUnit.MINUTES);

// 方式二：先获取BoundValueOperations对象再操作
BoundValueOperations stringKey = redisTemplate.boundValueOps("StringKey");
stringKey.set("StringVaule");
stringKey.set("StringValue", 1, TimeUnit.SECOND);

// 方式三：通过opsForValue()获取ValueOperations接口操作
ValueOperations ops = redisTemplate.opsForValue();
ops.set("StringKey", "StringVaule");
ops.set("StringValue", "StringVaule", 1, TimeUnit.SECOND);

2. 删除缓存
删除操作返回一个布尔值，表示是否删除成功。

Boolean result = redisTemplate.delete(key);

3. 值的递增与递减
对于数值型的String，可以方便地进行原子增减操作，常用于计数器场景。

// 递增4
redisTemplate.boundValueOps("key").increment(4L);
// 递减4（传入负数）
redisTemplate.boundValueOps("key").increment(-4L);

Hash 类型数据相关操作

Hash结构适合存储对象，其操作主要围绕field（小key）和value展开。

1. 添加缓存数据
向一个Hash结构中添加或修改一个field-value对，同样有多种方式：

// 方式一：直接操作
redisTemplate.boundHashOps("HashKey").put("SmallKey", "HashVaue");

// 方式二：获取BoundHashOperations对象后操作
BoundHashOperations hashKey = redisTemplate.boundHashOps("HashKey");
hashKey.put("SmallKey", "HashVaue");

// 方式三：通过opsForHash()获取HashOperations接口操作
HashOperations hashOps = redisTemplate.opsForHash();
hashOps.put("HashKey", "SmallKey", "HashVaue");

2. 设置过期时间
需要注意的是，过期时间是针对整个Hash Key（大Key）设置的，而不是内部的某个小field。

// 通过boundValueOps设置（注意：这里是对HashKey这个“键”本身设置过期）
redisTemplate.boundValueOps("HashKey").expire(1, TimeUnit.SECOND);
// 或者直接使用expire方法
redisTemplate.expire("HashKey", 1, TimeUnit.SECOND);

3. 批量添加Map数据
如果有一个Map，可以一次性将其所有键值对存入Hash中，非常高效。

HashMap hashMap = new HashMap<>();
// ... 向hashMap中添加数据
redisTemplate.boundHashOps("HashKey").putAll(hashMap);

4. 获取所有field
有时我们需要知道一个Hash结构里存了哪些field，可以使用keys()方法。

// 方式一
Set keys1 = redisTemplate.boundHashOps("HashKey").keys();
// 方式二
BoundHashOperations hashKey = redisTemplate.boundHashOps("HashKey");
Set keys2 = hashKey.keys();
// 方式三
HashOperations hashOps = redisTemplate.opsForHash();
Set keys3 = hashOps.keys("HashKey");

总结

以上就是对RedisTemplate操作String和Hash两种核心数据类型的常用封装思路。通过将这些散落的API进行归类封装，能显著提升代码的规范性和开发效率。希望这些具体的代码示例能为你设计自己的缓存工具类提供清晰的参考。