JobRunr Pro

Workflows using Job Chains

Reuse existing service methods and chain jobs for cleaner code and an immediate overview of your business process

JobRunr Pro allows you to chain jobs using a fluent API style. This gives you an immediate overview of your business process.

Job chaining via continueWith

@Inject
private ArchiveService archiveService;
@Inject
private NotifyService notifyService;

public void createArchiveAndNotify(String folder) {
    BackgroundJob
        .enqueue(() -> archiveService.createArchive(folder))
        .continueWith(() -> notifyService.notifyViaSlack("ops-team", "The following folder was archived: " + folder))
}

The notification will only be send once the archive was created successfully (and thus the archiveService.createArchive(String folder) job succeeded

Job chaining when using the JobBuilder

If you are using the JobBuilder pattern, this is also possible by means of the runAfter method.

@Inject
private ArchiveService archiveService;
@Inject
private NotifyService notifyService;

public void createArchiveAndNotify(String folder) {
    JobId createArchiveJobId = BackgroundJob
        .create(aJob()
            .withDetails(() -> archiveService.createArchive(folder)));

    JobId notifyViaSlackJobId = BackgroundJob
        .create(aJob()
            .runAfter(createArchiveJobId)
            .withDetails(() -> notifyService.notifyViaSlack("ops-team", "The following folder was archived: " + folder)));
}

The notification will only be send once the archive was created successfully (and thus the archiveService.createArchive(String folder) job succeeded

How does it work?

  • the first job (archiveService.createArchive(folder)) is enqueued and will start processing as soon as some worker threads are available
  • the second job (notifyService.notifyViaSlack(String room, String message)) will initially be saved using the AWAITING state.
  • once the first job succeeds, the second job will be enqueued and processed.

This comes in really handy when using Batches - start a new step in your business process when a whole bunch of related jobs have finished.