Schedule a task

Creating a job

To create a new job, do the following :

1. Create a class implementing the `org.quartz.Job` interface.
2. Add annotations if necessary (see the example)
3. Autowire existing beans if they are needed by the job

An example is provided below.

import org.quartz.Job; @DisallowConcurrentExecution @PersistJobDataAfterExecution public class SampleJob implements Job { private final Logger LOGGER = LoggerFactory.getLogger(SampleJob.class); @Autowired // Jobs can be Autowired with beans from context private ApplicationContext applicationContext; @Override public void execute(JobExecutionContext jobExecutionContext) throws JobExecutionException { // Do something here ... } }

Creating a job detail factory

The job definition and execution being created, you know need to reference it with Quartz in order to schedule it.

It requires the creation of a `JobDetailFactoryBean` in your application context.

This factory doesn't schedule anything, it's a definition of your job.

You can configure it by setting :

• a group name to regroup jobs that are related (e.g : Indexation).
• a job name
• a job description
• a durability (should the job definition be kept even if it's not scheduled ?)

An example is provided below.

@Bean public JobDetailFactoryBean sampleJobDetail() { JobDetailFactoryBean factoryBean = new JobDetailFactoryBean(); factoryBean.setJobClass(SampleJob.class); factoryBean.setGroup("Sample"); factoryBean.setName("Sample Job"); factoryBean.setDescription("Sample job for demonstration purpose"); factoryBean.setDurability(true); return factoryBean; }

Creating triggers

Trigger are what really schedule the jobs at given times.

They can be named and described.

Multiple triggers of different types can be configured for each job detail.

The SimpleTriggerFactoryBean allows you to define a repeat interval in milliseconds, and a repeat count (possibly indefinitely).

This trigger can also be used as a "fire once" trigger with a repeat count of zero.

(Note: the "fire once" trigger will be stored and not triggered again when the application restarts. See below for on-application-start trigger)

@Bean public SimpleTriggerFactoryBean sampleJobCronTrigger(@Qualifier("sampleJobDetail") JobDetail sampleJobDetail) { SimpleTriggerFactoryBean factoryBean = new SimpleTriggerFactoryBean(); factoryBean.setName("Cron trigger"); factoryBean.setDescription("This is a cron trigger for demonstration purpose"); factoryBean.setJobDetail(sampleJobDetail); factoryBean.setStartDelay((long) 30 * 1000); factoryBean.setRepeatInterval(1 * 60 * 60 * 1000); factoryBean.setRepeatCount(SimpleTrigger.REPEAT_INDEFINITELY); factoryBean.setMisfireInstruction(SimpleTrigger.MISFIRE_INSTRUCTION_RESCHEDULE_NEXT_WITH_REMAINING_COUNT); return factoryBean; }

The CronTriggerFactoryBean allows you to define cron expression to schedule the job.

@Bean public CronTriggerFactoryBean sampleJobSimpleTrigger(@Qualifier("sampleJobDetail") JobDetail sampleJobDetail) { CronTriggerFactoryBean factoryBean = new CronTriggerFactoryBean(); factoryBean.setName("Simple trigger"); factoryBean.setDescription("This is a simple trigger for demonstration purpose"); factoryBean.setJobDetail(sampleJobDetail); factoryBean.setStartDelay(10L); factoryBean.setCronExpression("0/30 * * * * ?"); factoryBean.setMisfireInstruction(SimpleTrigger.MISFIRE_INSTRUCTION_IGNORE_MISFIRE_POLICY); return factoryBean; }