springboot3?redis?常用操作工具類詳解

更新時間：2025年01月07日 09:23:18 作者：等一場春雨

本文詳細介紹了Spring Boot 3中使用Spring Data Redis進行Redis操作的工具類實現(xiàn),該工具類涵蓋了字符串、哈希、列表、集合和有序集合等常用功能,感興趣的朋友一起看看吧

完整的 Redis 工具類

以下工具類可以實現(xiàn)基本的 Redis 操作，例如字符串、哈希、列表、集合和有序集合等。

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.redis.core.*;
import org.springframework.stereotype.Component;
import java.util.*;
import java.util.concurrent.TimeUnit;
@Component
public class RedisUtils {
    @Autowired
    private RedisTemplate<String, Object> redisTemplate;
    /**
     * 設(shè)置值
     */
    public void set(String key, Object value, long timeout, TimeUnit timeUnit) {
        redisTemplate.opsForValue().set(key, value, timeout, timeUnit);
    }
    /**
     * 獲取值
     */
    public Object get(String key) {
        return redisTemplate.opsForValue().get(key);
    }
    /**
     * 刪除鍵
     */
    public void delete(String key) {
        redisTemplate.delete(key);
    }
    /**
     * 批量刪除
     */
    public void deleteKeys(String pattern) {
        Set<String> keys = redisTemplate.keys(pattern);
        if (keys != null && !keys.isEmpty()) {
            redisTemplate.delete(keys);
        }
    }
    /**
     * 設(shè)置鍵的過期時間
     */
    public boolean expire(String key, long timeout, TimeUnit unit) {
        return Boolean.TRUE.equals(redisTemplate.expire(key, timeout, unit));
    }
    /**
     * 獲取剩余過期時間
     */
    public long getExpire(String key) {
        return Optional.ofNullable(redisTemplate.getExpire(key)).orElse(0L);
    }
    /**
     * 檢查鍵是否存在
     */
    public boolean hasKey(String key) {
        return Boolean.TRUE.equals(redisTemplate.hasKey(key));
    }
    /**
     * 增加值
     */
    public long increment(String key, long delta) {
        return Optional.ofNullable(redisTemplate.opsForValue().increment(key, delta)).orElse(0L);
    }
    /**
     * 哈希操作：設(shè)置值
     */
    public void hSet(String key, String hashKey, Object value) {
        redisTemplate.opsForHash().put(key, hashKey, value);
    }
    /**
     * 哈希操作：獲取值
     */
    public Object hGet(String key, String hashKey) {
        return redisTemplate.opsForHash().get(key, hashKey);
    }
    /**
     * 列表操作：左推入
     */
    public void lPush(String key, Object value) {
        redisTemplate.opsForList().leftPush(key, value);
    }
    /**
     * 列表操作：右彈出
     */
    public Object rPop(String key) {
        return redisTemplate.opsForList().rightPop(key);
    }
    /**
     * 集合操作：添加元素
     */
    public void sAdd(String key, Object... values) {
        redisTemplate.opsForSet().add(key, values);
    }
    /**
     * 集合操作：獲取所有元素
     */
    public Set<Object> sMembers(String key) {
        return redisTemplate.opsForSet().members(key);
    }
    /**
     * 有序集合操作：添加元素
     */
    public void zAdd(String key, Object value, double score) {
        redisTemplate.opsForZSet().add(key, value, score);
    }
    /**
     * 有序集合操作：獲取范圍內(nèi)的元素
     */
    public Set<Object> zRange(String key, long start, long end) {
        return redisTemplate.opsForZSet().range(key, start, end);
    }
}

工具類的使用

設(shè)置和獲取值

@Autowired
private RedisUtils redisUtils;
public void testSetValue() {
    redisUtils.set("key", "value", 10, TimeUnit.MINUTES);
    Object value = redisUtils.get("key");
    System.out.println("Value: " + value);
}

刪除鍵

redisUtils.delete("key");

哈希操作

redisUtils.hSet("hashKey", "field", "value");
Object value = redisUtils.hGet("hashKey", "field");
System.out.println("Hash Value: " + value);

列表操作

redisUtils.lPush("listKey", "value1");
Object value = redisUtils.rPop("listKey");
System.out.println("List Value: " + value);

集合操作

redisUtils.sAdd("setKey", "value1", "value2");
Set<Object> members = redisUtils.sMembers("setKey");
System.out.println("Set Members: " + members);

有序集合操作

redisUtils.zAdd("zSetKey", "value1", 1.0);
Set<Object> range = redisUtils.zRange("zSetKey", 0, -1);
System.out.println("ZSet Range: " + range);

注意事項

使用合適的序列化方式默認情況下，RedisTemplate 使用的是 JdkSerializationRedisSerializer，這可能導(dǎo)致數(shù)據(jù)在 Redis 中以二進制形式存儲。你可以配置自定義的序列化器，例如 StringRedisSerializer 或 Jackson2JsonRedisSerializer。

示例配置：

@Configuration
public class RedisConfig {
    @Bean
    public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory connectionFactory) {
        RedisTemplate<String, Object> template = new RedisTemplate<>();
        template.setConnectionFactory(connectionFactory);
        // 設(shè)置 Key 和 Value 的序列化器
        template.setKeySerializer(new StringRedisSerializer());
        template.setValueSerializer(new Jackson2JsonRedisSerializer<>(Object.class));
        // 設(shè)置 Hash Key 和 Value 的序列化器
        template.setHashKeySerializer(new StringRedisSerializer());
        template.setHashValueSerializer(new Jackson2JsonRedisSerializer<>(Object.class));
        template.afterPropertiesSet();
        return template;
    }
}