Spring Persistent Tasks¶

A lightweight and simple task management framework for Spring Boot designed to queue and execute asynchronous tasks with support for database persistence and a user-friendly interface. Perfect for implementing scheduling patterns, outbound patterns, and background job processing in distributed systems.

Built for Spring Boot 3.x with JPA - seamlessly integrates with your existing Spring application.

Key Features ✨¶

1. JPA-Powered Persistence - Automatically persists tasks to your database
2. Spring Boot Auto-Configuration - Simple setup with @EnableSpringPersistentTasks
3. Clustering Support - Built-in lock management for distributed environments
4. Type-Safe Tasks - Generic task definitions with state objects
5. Retry Mechanisms - Automatic retry policies for failed executions
6. Transactional Integration - Works with Spring's transaction management
7. Queue Management - Intelligent task queuing and prioritization
8. Different DB Supports - MySQL, azure-sql-edge, PostgreSQL, and H2

Setup with Maven¶

• Maven Central spring-persistent-tasks-core

1
2
3
4
5

<dependency>
    <groupId>org.sterl.spring</groupId>
    <artifactId>spring-persistent-tasks-core</artifactId>
    <version>2.x.x</version>
</dependency>

Setup Spring¶

1
2
3

@SpringBootApplication
@EnableSpringPersistentTasks
public class ExampleApplication {

Create a Task¶

1
2
3
4

@Bean
PersistentTask<Vehicle> task1(VehicleHttpConnector vehicleHttpConnector) {
    return v -> vehicleHttpConnector.send(v);
}

Trigger a task¶

1
2
3
4
5
6
7

@Autowired
PersistentTaskService persistentTaskService;

public void triggerTask1(Vehicle vehicle) {
    persistentTaskService.runOrQueue(
        TriggerBuilder.newTrigger("task1").state(vehicle).build());
}