Quartz入门例子简介 从入门到菜鸟(一)

刚接触quartz这个词并不是在学习过程中。。。而是WOW里面的界面插件。。。 汗=。= :oops:

言归正传，入门教程，不喜勿喷。

网上看到一些定时任务使用Timer来解决，但是在多任务的情况下可能会造成[b]延迟严重[/b]，并且Timer[b]不提供实时保证[/b]。所以推荐使用Quartz这个定时任务的框架来完成此类功能。相关问题见：[url]http://www.iteye.com/problems/90824[/url]，具体原理请google。

前面用过Quartz的功能，学新工具一般都是先用再写再看源码。其实应用场景很容易想象，比如每个月20号要发工资，数据库里面某些字段要标记为已发，或者要进行记账之类的，那么这时候可以用quartz来写表达式，就可以让系统自动的在每个月20号执行这些任务。

接下来就去下载Quartz吧([url]http://www.quartz-scheduler.org/[/url])，我的版本是quartz-2.1.0， 看官网现在最新应该是2.1.6。

解压开来，如果要直接用的话，取quartz-all.2.1.0.jar和lib目录下的那几个jar包就可以。docs存放Api文档，不再赘述。

对于那几个quartz-oracle,jboss几个包是干嘛的我还没细看=。= 后面再说。看readme应该是特殊场景应用吧。听高人提了下据说oracle里面的东西是直接调用orcl数据库底层的XXX，就是不采用Sql，增加效率什么的，[b]待考证[/b]。

对于我这种当前刚开始使用入门的话可以看examples里面的例子，目录：examples\src\main\java，里面包含了15个例子，从最简单的任务调用，到表达式、参数传递，再到。。。(后面的还没看..)

其实一般来说 前几个，应该够用了。(LZ当前看到第四个)

最简单的应用包含两个类：
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);
	}

通过代码可以看到几个重要的类：
[list]
[*]JobDetail： 真正的任务内容，任务本身是集成Job接口的，但是真正的任务是JobBuilder通过反射的方式实例化的，
[*]Trigger： 触发器，定义任务应当开始的时间，主要分为两类SimpleTrigger,CronTrigger，当前例子的就是简单触发器，CronTrigger主要用于处理quartz表达式定义的任务，比如每个月20号，每个星期一之类的。
[*]Scheduler： 计划表(可能翻译的不太贴切)，现在我们有了要做的内容，有了要做的时间，接下来，就把这两个内容填充到计划任务Scheduler对象里面，到了时间它就可以自动运行了。
[/list]

理解了这三个重要类，其余的就比较好理解了，主要是提供服务的工具类或工厂类如
DateBuilder：处理时间
TriggerBuilder，JobBuilder。

任务的完成是quartz为Scheduler分配的线程池启动的其他线程完成的，并不在主线程之中，具体的执行详细过程将在后续博客中撰写。

后续将介绍CronTrigger，参数传递等内容。