Rqueue: Redis-Backed Job Queue and Scheduler for Spring and Spring Boot

Rqueue is a Redis-backed job queue and producer-consumer system for Spring and Spring Boot. It supports both producers and consumers for background jobs, scheduled tasks, and event-driven workflows, similar to Sidekiq or Celery, but fully integrated into the Spring programming model with annotation-driven APIs and minimal setup.

Features

• Job execution

  • Run background jobs asynchronously
  • Schedule jobs for any future time
  • Run periodic jobs at fixed intervals
  • Guarantee at-least-once delivery
  • Retry failed jobs automatically with fixed or exponential backoff

• Queues and routing

  • Deduplicate messages using message IDs
  • Process priority workloads such as high, medium, and low
  • Prioritize workloads with group-level queue priority and weighted, strict, or hard strict ordering
  • Fan out the same message to multiple listeners
  • Poll messages in batches for higher throughput

• Consumers and scale

  • Use annotation-driven listeners with Spring beans
  • Get started with just the dependency in Spring Boot applications
  • Run multiple competing consumers in parallel
  • Configure listener concurrency per worker
  • Support long-running jobs with periodic check-ins
  • Serialize and deserialize message payloads automatically

• Operations and extensibility

  • Add middleware before listener execution
  • Use callbacks for dead-letter, discard, and related flows
  • Subscribe to bootstrap and task execution events
  • Monitor in-flight, queued, and scheduled messages with metrics
  • Use the built-in web dashboard for queue visibility and latency insights

• Redis and platform support

  • Use a separate Redis setup for Rqueue if needed
  • Support Redis standalone, Sentinel, and Cluster setups
  • Work with Lettuce for Redis Cluster
  • Support reactive Redis and Spring WebFlux

Requirements

• Spring 5+, 6+, 7+
• Java 1.8+,17, 21
• Spring boot 2+,3+,4+
• Lettuce client for Redis cluster
• Read master preference for Redis cluster

Getting Started

Dependency

Release Version: Maven central

Spring Boot

NOTE:

• For Spring Boot 3.x use Rqueue 3.x
• For Spring Boot 4.x use Rqueue 4.x

Get the latest one from Maven central

• Add dependency

  • Gradle

        implementation 'com.github.sonus21:rqueue-spring-boot-starter:4.0.0-RELEASE'

  • Maven

     <dependency>
        <groupId>com.github.sonus21</groupId>
        <artifactId>rqueue-spring-boot-starter</artifactId>
        <version>4.0.0-RELEASE</version>
    </dependency>

  No additional configurations are required, only dependency is required.

---

Spring Framework

NOTE

• For Spring Framework 6.x use Rqueue 3.x
• For Spring Framework 7.x use Rqueue 4.x

Get the latest one from Maven central

• Add Dependency
  • Gradle

        implementation 'com.github.sonus21:rqueue-spring:4.0.0-RELEASE'

  • Maven

     <dependency>
       <groupId>com.github.sonus21</groupId>
       <artifactId>rqueue-spring</artifactId>
       <version>4.0.0-RELEASE</version>
     </dependency>

• Add annotation EnableRqueue on application config class
• Provide a RedisConnectionFactory bean

Configuration

@EnableRqueue
public class Application {
  @Bean
  public RedisConnectionFactory redisConnectionFactory() {
    // return a redis connection factory
  }
}

---

Message publishing/Task submission

All messages need to be sent using RqueueMessageEnqueuer bean's enqueueXXX, enqueueInXXX and enqueueAtXXX methods. It has handful number of enqueue, enqueueIn, enqueueAt methods, we can use any one of them based on the use case.

public class MessageService {

  @AutoWired
  private RqueueMessageEnqueuer rqueueMessageEnqueuer;

  public void doSomething() {
    rqueueMessageEnqueuer.enqueue("simple-queue", "Rqueue is configured");
  }

  public void createJOB(Job job) {
    rqueueMessageEnqueuer.enqueue("job-queue", job);
  }

  // send notification in 30 seconds
  public void sendNotification(Notification notification) {
    rqueueMessageEnqueuer.enqueueIn("notification-queue", notification, 30 * 1000L);
  }

  // enqueue At example
  public void createInvoice(Invoice invoice, Instant instant) {
    rqueueMessageEnqueuer.enqueueAt("invoice-queue", invoice, instant);
  }

  // enqueue with priority, when sub queues are used as explained in the queue priority section.
  enum SmsPriority {
    CRITICAL("critical"),
    HIGH("high"),
    MEDIUM("medium"),
    LOW("low");
    private String value;
  }

  public void sendSms(Sms sms, SmsPriority priority) {
    rqueueMessageEnqueuer.enqueueWithPriority("sms-queue", priority.value(), sms);
  }

  // Index chat every 1 minute
  public void sendPeriodicEmail(Email email) {
    rqueueMessageEnqueuer.enqueuePeriodic("chat-indexer", chatIndexer, 60_000);
  }

}

---

Worker/Consumer/Task Executor/Listener

Any method that's part of spring bean, can be marked as worker/message listener using RqueueListener annotation

@Component
@Slf4j
public class MessageListener {

  @RqueueListener(value = "simple-queue")
  public void simpleMessage(String message) {
    log.info("simple-queue: {}", message);
  }

  @RqueueListener(value = "job-queue", numRetries = "3",
      deadLetterQueue = "failed-job-queue", concurrency = "5-10")
  public void onMessage(Job job) {
    log.info("Job alert: {}", job);
  }

  @RqueueListener(value = "push-notification-queue", numRetries = "3",
      deadLetterQueue = "failed-notification-queue")
  public void onMessage(Notification notification) {
    log.info("Push notification: {}", notification);
  }

  @RqueueListener(value = "sms", priority = "critical=10,high=8,medium=4,low=1")
  public void onMessage(Sms sms) {
    log.info("Sms : {}", sms);
  }

  @RqueueListener(value = "chat-indexing", priority = "20", priorityGroup = "chat")
  public void onMessage(ChatIndexing chatIndexing) {
    log.info("ChatIndexing message: {}", chatIndexing);
  }

  @RqueueListener(value = "chat-indexing-daily", priority = "10", priorityGroup = "chat")
  public void onMessage(ChatIndexing chatIndexing) {
    log.info("ChatIndexing message: {}", chatIndexing);
  }

  // checkin job example
  @RqueueListener(value = "chat-indexing-weekly", priority = "5", priorityGroup = "chat")
  public void onMessage(ChatIndexing chatIndexing,
      @Header(RqueueMessageHeaders.JOB) com.github.sonus21.rqueue.core.Job job) {
    log.info("ChatIndexing message: {}", chatIndexing);
    job.checkIn("Chat indexing...");
  }
}

---

Dashboard

Link: http://localhost:8080/rqueue

Queue Statistics

Micrometer based dashboard for queue

Message Waiting For Execution

Recent jobs details

---

Status

Rqueue is stable and production ready, processing millions of messages daily in production environments. Some of the Rqueue Users

        

We would love to add your organization name here, if you're one of the Rqueue users, please raise a PR/issue .

---

Support

• Please report bug,question,feature(s) to issue tracker.

Contribution

You are most welcome for any pull requests for any feature/bug/enhancement. You would need Java8 and gradle to start with. In root build.gradle file comment out spring related versions, or set environment variables for Spring versions. You can use module, class and other diagrams to familiarise yourself with the project.

Please format your code with Palantir Java Format using ./gradlew formatJava.

Links

• Documentation: https://sonus21.github.io/rqueue
• Releases: https://github.com/sonus21/rqueue/releases
• Issue tracker: https://github.com/sonus21/rqueue/issues
• Maven Central:
  • https://repo1.maven.org/maven2/com/github/sonus21/rqueue-spring
  • https://repo1.maven.org/maven2/com/github/sonus21/rqueue-spring-boot-starter

License

© Sonu Kumar 2019-Instant.now

The Rqueue is released under version 2.0 of the Apache License.