You are viewing the documentation for Blueriq 15. Documentation for other versions is available in our documentation directory.

Description

With the help of the 'Scheduler Quartz Component' generic Blueriq jobs can be scheduled, unscheduled or rescheduled. Generic jobs do not need to have knowledge about the specific scheduler used (in our case, about Quartz), they only need to implement the scheduling interfaces defined in Blueriq.

Details about the needed interfaces and how to implement and schedule a custom job are detailed in this article.

Implementing custom jobs

A custom jobs should implement the IJob Blueriq interface. The execute(IExecutionContext context) method defined in the IJob interface is going to be executed when the job is executed. The job's scheduler and the job's parameters can be accessed from the execution context: context.getParameters() and context.getScheduler().

Example

The Blueriq scheduler when executes the job looks for an object with the scheduled job's type in the application context. As a consequence at execution a bean of the scheduled job type should be available in the application context.

@Component
public class MyJob implements IJob {

 @Override
 public void execute(IExecutionContext context) {
	IJobParamters paramters = context.getParameters();
	IScheduler scheduler = context.getScheduler();     
 }
}


Scheduling, unscheduling and rescheduling custom jobs

Scheduling custom jobs

For scheduling custom jobs the IScheduler.schedule method can be used. It has the following four parameters:

  • the class of the job
  • the parameters of the job
    • can be created by calling the IScheduler.createJobParameters().
  • the schedule of the job
    • can be created by calling IScheduler.getScheduleBuilder().onDate(Date date) or IScheduler.getScheduleBuilder().now() methods
  • the ID of the job
    • can be created by calling the IScheduler.createJobId(String jobId)

Custom jobs can be scheduled using the SpringQuartzScheduler class in the Quartz Scheduler Component.

IJobParameters parameters = scheduler.createJobParameters();
ISchedule schedule = scheduler.getScheduleBuilder().now();
IJobId jobId = scheduler.createJobId();
scheduler.schedule(MyJob.class, parameters, schedule, jobId);


Unscheduling custom jobs

For unschdeuling custom jobs the IScheduler.unschedule method can be used which has only one paramters, the id of the job.

Custom jobs can be unscheduled using the SpringQuartzScheduler class in the Quartz Scheduler Component.

scheduler.unschedule(jobId);


Rescheduling custom jobs

For rescheduling custom jobs the IScheduler.reschedule method can be used. This method has two parameters: de id of the job and the it's new schedule.

Custom jobs can be rescheduled using the SpringQuartzScheduler class in the Quartz Scheduler Component.


ISchedule schedule = scheduler.getScheduleBuilder().now();
scheduler.reschedule(jobId, schedule);