首先下载Quartz jar 导入到项目中。
最简单的应用包含两个类:
MyJob.java:定义任务(需要是public)QuartzTest.java:主线程,用于调用任务。
这个例子的目的是在当前运行时间的下一个整数分钟输出一行文字
MyJob:
- public class MyJob implements Job {
- @Override
- public void execute(JobExecutionContext context) throws JobExecutionException {
- System.out.println("任务正在执行,执行时间: " + Calendar.getInstance().getTime());
- }
- }
可以看到,任务很简单,MyJob 实现了Quartz的Job接口中的execute方法,任务的内容就是打印一行字。具体这个任务应该何时去执行,都在QuartzTest里面去定义实现。
QuartzTest:
- public static void main(String[] args) throws Throwable {
- SchedulerFactory factory = new StdSchedulerFactory();
- // 从工厂里面拿到一个scheduler实例
- Scheduler scheduler = factory.getScheduler();
- // 计算任务的开始时间,DateBuilder.evenMinuteDate方法是取下一个整数分钟
- Date runTime = DateBuilder.evenMinuteDate(new Date());
- // 真正执行的任务并不是Job接口的实例,而是用反射的方式实例化的一个JobDetail实例
- JobDetail job = JobBuilder.newJob(MyJob.class).withIdentity("job1", "group1").build();
- // 定义一个触发器,startAt方法定义了任务应当开始的时间
- Trigger trigger = TriggerBuilder.newTrigger().withIdentity("trigger1", "group1").startAt(runTime).build();
- // 将任务和Trigger放入scheduler
- scheduler.scheduleJob(job, trigger);
- scheduler.start();
- try {
- // 等待65秒,保证下一个整数分钟出现,这里注意,如果主线程停止,任务是不会执行的
- Thread.sleep(65L * 1000L);
- } catch (Exception e) {
- }
- // scheduler结束
- scheduler.shutdown(true);
- }
通过代码可以看到几个重要的类:
- JobDetail: 真正的任务内容,任务本身是集成Job接口的,但是真正的任务是JobBuilder通过反射的方式实例化的,
- Trigger: 触发器,定义任务应当开始的时间,主要分为两类SimpleTrigger,CronTrigger,当前例子的就是简单触发器,CronTrigger主要用于处理quartz表达式定义的任务,比如每个月20号,每个星期一之类的。
- Scheduler: 计划表(可能翻译的不太贴切),现在我们有了要做的内容,有了要做的时间,接下来,就把这两个内容填充到计划任务Scheduler对象里面,到了时间它就可以自动运行了。
理解了这三个重要类,其余的就比较好理解了,主要是提供服务的工具类或工厂类如
DateBuilder:处理时间
TriggerBuilder,JobBuilder。
任务的完成是quartz为Scheduler分配的线程池启动的其他线程完成的,并不在主线程之中,具体的执行详细过程将在后续博客中撰写。
后续将介绍CronTrigger,参数传递等内容。