Scheduling generic jobs [Editor]

Description

With the help of the Scheduler Quartz Component generic Blueriq jobs can be scheduled unscheduled or rescheduled. This jobs does not need to have knowledge about the specific job scheduler used (in our case about Quartz), they only need to implement the scheduling interfaces defined in Blueriq. This interfaces and the how the jobs should be implemented and scheduled are detailed below. 

Creating custom jobs

A custom jobs should implement in both Java and .Net 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

@Component
public class MyJob implements IJob {

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

public class TestJob : BQ.IJob
{
    public void execute(BQ.IExecutionContext context)
    {
        BQ.IJobParamters parameters = context.getParameters();
        BQ.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 four parameters:

• the class of the job
• the paramteres 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)

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

BQ.IJobParameters parameters = scheduler.createJobParameters();
BQ.ISchedule schedule = scheduler.getScheduleBuilder().now();
BQ.IJobId jobId = scheduler.createJobId();
scheduler.schedule(typeof(MyJob), 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.

scheduler.unschedule(jobId);

scheduler.unschedule(jobId);

Rescheduling custom jobs

For reschdeuling 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.

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

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