SpringBoot集成redisson實現(xiàn)延時隊列教程

更新時間：2025年08月16日 08:46:05 作者：帥白~

文章介紹了使用Redisson實現(xiàn)延遲隊列的完整步驟,包括依賴導入、Redis配置、工具類封裝、業(yè)務枚舉定義、執(zhí)行器實現(xiàn)、Bean創(chuàng)建、消費線程啟動及測試接口驗證,適用于需定時處理任務的場景

1、先給項目導入redisson依賴
2、配置redis
3、創(chuàng)建 RedissonConfig 配置
4、封裝 Redis 延遲隊列工具類
5、創(chuàng)建延遲隊列業(yè)務枚舉
6、定義延遲隊列執(zhí)行器
7、創(chuàng)建枚舉中定義的Bean，并實現(xiàn)延遲隊列執(zhí)行器
8、創(chuàng)建延遲隊列消費線程，項目啟動完成后開啟
9、創(chuàng)建一個測試接口，模擬添加延遲隊列
總結

1、先給項目導入redisson依賴

 		<dependency>
            <groupId>org.redisson</groupId>
            <artifactId>redisson-spring-boot-starter</artifactId>
            <version>3.15.4</version>
        </dependency>

2、配置redis

3、創(chuàng)建 RedissonConfig 配置

4、封裝 Redis 延遲隊列工具類

import lombok.extern.slf4j.Slf4j;
import org.redisson.api.RBlockingDeque;
import org.redisson.api.RDelayedQueue;
import org.redisson.api.RedissonClient;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;

import java.util.Map;
import java.util.concurrent.TimeUnit;

/**
 * @author bigboss
 */
@Slf4j
@Component
public class RedisDelayQueueUtil {

    @Autowired
    private RedissonClient redissonClient;

    /**
     * 添加延遲隊列
     *
     * @param value     隊列值
     * @param delay     延遲時間
     * @param timeUnit  時間單位
     * @param queueCode 隊列鍵
     * @param <T>
     */
    public <T> void addDelayQueue(T value, long delay, TimeUnit timeUnit, String queueCode) {
        try {
            RBlockingDeque<Object> blockingDeque = redissonClient.getBlockingDeque(queueCode);
            RDelayedQueue<Object> delayedQueue = redissonClient.getDelayedQueue(blockingDeque);
            //刪除之前進來的id值
            delayedQueue.remove(value);
            delayedQueue.offer(value, delay, timeUnit);
            log.info("(添加延時隊列成功) 隊列鍵：{}，隊列值：{}，延遲時間：{}", queueCode, value, timeUnit.toSeconds(delay) + "秒");
        } catch (Exception e) {
            log.error("(添加延時隊列失敗) {}", e.getMessage());
            throw new RuntimeException("(添加延時隊列失敗)");
        }
    }

    /**
     * 獲取延遲隊列
     *
     * @param queueCode
     * @param <T>
     * @return
     * @throws InterruptedException
     */
    public <T> T getDelayQueue(String queueCode) throws InterruptedException {
        RBlockingDeque<Map> blockingDeque = redissonClient.getBlockingDeque(queueCode);
        T value = (T) blockingDeque.take();
        return value;
    }


    /**
     * 刪除延遲隊列
     *
     * @param queueCode
     * @param <T>
     * @return
     */
    public <T> T removeDelayQueue(T value, String queueCode) {
        RBlockingDeque<Object> blockingDeque = redissonClient.getBlockingDeque(queueCode);
        RDelayedQueue<Object> delayedQueue = redissonClient.getDelayedQueue(blockingDeque);
        delayedQueue.remove(value);
        return value;
    }
}

5、創(chuàng)建延遲隊列業(yè)務枚舉

import lombok.AllArgsConstructor;
import lombok.Getter;
import lombok.NoArgsConstructor;

/**
 * @author: Bigboss369
 * @Created: 2022/8/11/011
 */
@Getter
@NoArgsConstructor
@AllArgsConstructor
public enum  RedisDelayQueueEnum {
    pengyuyan("pengyuyan","心跳", "pengyuyan");
    /**
     * 延遲隊列 Redis Key
     */
    private String code;

    /**
     * 中文描述
     */
    private String name;

    /**
     * 延遲隊列具體業(yè)務實現(xiàn)的 Bean
     * 可通過 Spring 的上下文獲取
     */
    private String beanId;
}

6、定義延遲隊列執(zhí)行器

/**
 * @author: Bigboss369
 * @Created: 2022/8/11/011
 */
public interface RedisDelayQueueHandle<T> {

    void execute(T t);

}

7、創(chuàng)建枚舉中定義的Bean，并實現(xiàn)延遲隊列執(zhí)行器

import com.a.service.RedisDelayQueueHandle;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Component;

import java.util.Map;

@Component(value = "pengyuyan")
@Slf4j
public class PengYuYan implements RedisDelayQueueHandle<Map> {
    @Override
    public void execute(Map map) {
        log.info("收到心跳延遲消息map:" + map);
    }
}

8、創(chuàng)建延遲隊列消費線程，項目啟動完成后開啟

import com.a.service.RedisDelayQueueHandle;
import com.a.util.RedisDelayQueueUtil;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.CommandLineRunner;
import org.springframework.stereotype.Component;

/**
 * @author bigboss
 */
@Slf4j
@Component
public class RedisDelayQueueRunner implements CommandLineRunner {

    @Autowired
    private RedisDelayQueueUtil redisDelayQueueUtil;

    @Override
    public void run(String... args) {
        RedisDelayQueueEnum[] queueEnums = RedisDelayQueueEnum.values();
        for (RedisDelayQueueEnum queueEnum : queueEnums) {
            new Thread(() -> {
                try {
                    while (true) {
                        Object value = redisDelayQueueUtil.getDelayQueue(queueEnum.getCode());
                        log.debug("----value-->" + value);
                        RedisDelayQueueHandle redisDelayQueueHandle = SpringUtil.getBean(queueEnum.getBeanId());
                        redisDelayQueueHandle.execute(value);
                    }
                } catch (InterruptedException e) {
                    log.error("(Redis延遲隊列異常中斷) {}", e.getMessage());
                }
            }).start();
        }
        log.info("(Redis延遲隊列啟動成功)");
    }
}