The Quarkus JBeret Extension adds support for JSR-352 Batch Applications for the Java Platform. JBeret is an implementation of the JSR-352.
To use the extension, add the dependency to the target project:
<dependency>
<groupId>io.quarkiverse.jberet</groupId>
<artifactId>quarkus-jberet</artifactId>
<version>2.2.0</version>
</dependency>ℹ️ Recommended Quarkus version: 3.9.0 or higher
The Batch API and Runtime will be available out of the box. Please refer to the Batch documentation, or the JBeret documentation to learn about Batch Applications.
The JBeret Quarkus extension supports the following configuration:
| Name | Type | Default |
|---|---|---|
quarkus.jberet.repositoryThe repository type to store JBeret and Job data. A jdbc type requires a JDBC datasource. |
in-memory, jdbc |
in-memory |
quarkus.jberet.repository.jdbc.datasourceThe datasource name. |
string | <default> |
quarkus.jberet.jobs.includesA list of patterns to match batch files to include. |
list of string | |
quarkus.jberet.jobs.excludesA list of patterns to match batch files to exclude. |
list of string | |
quarkus.jberet.job."job-name".cronA cron style expression in Quartz format to schedule the job. |
string | |
quarkus.jberet.job."job-name".params."param-key"A parameter to start a job. |
string | |
quarkus.jberet.max-async"A parameter control the number of Threads that can be used by JBeret. An additional Thread for JBeret coordination is always added. Thus setting 1 will proide one thread for job executions. |
string | Based on available cores |
The Batch API requires the @BatchProperty annotation to inject the specific configuration from the batch definition
file. Instead, you can use the @ConfigProperty annotation, which is used to inject configuration properties in
Quarkus using the MicroProfile Config API and keep consistency:
@Inject
@BatchProperty(name = "job.config.name")
String batchConfig;
// These is equivalent to @BatchProperty injection
@ConfigProperty(name = "job.config.name")
Optional<String> mpConfig;Although, there is a slight limitation: since job configuration is mostly dynamic and only injected on job execution,
Quarkus may fail to start due to invalid configuration (can't find the Job configuration values). In this case,
configuration injection points with the @ConfigProperty annotation need to set a default value or use an Optional.
The Batch APIs JobOperator and JobRepository are available as CDI beans, so they can be injected directly into any
code:
@Inject
JobOperator jobOperator;
@Inject
JobRepository jobRepository;
void start() {
long executionId = jobOperator.start("batchlet", new Properties());
JobExecution jobExecution = jobRepository.getJobExecution(executionId);
}It is possible to provide a Job definition via a CDI producer (instead of using XML):
@ApplicationScoped
public static class JobProducer {
@Produces
@Named
public Job job() {
return new JobBuilder("job")
.step(new StepBuilder("step").batchlet("batchlet", new String[] {}).build())
.build();
}
}A Job registered with CDI will be named by the name provided in the @Named annotation or by the method name. The
@Named annotations is required regardless.
Specific Quarkus implementation is available in QuarkusJobOperator, which can be also injected directly:
@Inject
QuarkusJobOperator jobOperator;
void start() {
Job job = new JobBuilder("programmatic")
.step(new StepBuilder("programmaticStep")
.batchlet("programmaticBatchlet")
.build())
.build();
long executionId = jobOperator.start(job, new Properties());
JobExecution jobExecution = jobOperator.getJobExecution(executionId);
}With QuarkusJobOperator it is possible to define and start programmatic Jobs, with the
JBeret Programmatic Job Definition.
The JBeret Scheduler is integrated out of the box in this extension.
To schedule a Job execution, please refer to the quarkus.jberet.job."job-name".cron and
quarkus.jberet.job."job-name".params."param-key" configurations.
A Job can also be scheduled programmatically, using the JobScheduler API and the Quarkus startup event:
@ApplicationScoped
public class Scheduler {
@Inject
JobScheduler jobScheduler;
void onStart(@Observes StartupEvent startupEvent) {
final JobScheduleConfig scheduleConfig = JobScheduleConfigBuilder.newInstance()
.jobName("scheduler")
.initialDelay(0)
.build();
jobScheduler.schedule(scheduleConfig);
}
}The JobScheduler does not support persistent schedules.
The JBeret REST is integrated as separate extension that can be easily added to the target project with the following dependency:
<dependency>
<groupId>io.quarkiverse.jberet</groupId>
<artifactId>quarkus-jberet-rest</artifactId>
<version>2.0.0</version>
</dependency>The JBeret REST API, provides REST resources to several operations around the Batch API: starting and stopping jobs, querying the status of a job, schedule a job, and many more. The extension includes a REST client to simplify the REST API calls:
@Inject
BatchClient batchClient;
void start() throws Exception {
JobExecutionEntity jobExecutionEntity = batchClient.startJob("batchlet", new Properties());
}Example applications can be found inside the integration-tests folder:
chunk- A simple Job that reads, processes, and stores data from a file.jdbc-repository- A Job that uses ajdbcdatasource to store JBeret and Job metadata.scheduler- Schedule a Job to run every 10 seconds
Or take a look into the World of Warcraft Auctions - Batch Application. It downloads the World of Warcraft Auction House data and provides statistics about items prices.
The Quakus JBeret Extension fully supports the Graal VM Native Image with the following exceptions:
- Scripting Languages.
While
Javascriptshould work, it is unlikely that other scripting languages will be supported in Graal via JSR-223.
Thanks goes to these wonderful people (emoji key):
 Roberto Cortez 💻 🚧 |
This project follows the all-contributors specification. Contributions of any kind welcome!
![allcontributors[bot] avatar](https://avatars.githubusercontent.com/in/23186?v=4 "allcontributors[bot]")
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent