You are viewing the documentation for Blueriq 17. Documentation for other versions is available in our documentation directory.
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);