java quartz 浅谈

上篇 我总结了 java 原生的 调度器 Timer ,得出其 时间设置不灵活,且性能 不稳定,所以 大型项目还是 要用 quartz,

quartz 的概念 不再解释,大家有不理解的 地方 可以百度,废话补多说,

jar 准备 :quartz.jar 下载(自行百度)

直接上代码

第一: 任务类 implement Job  接口,重写 execute 方法

public class MonthReportJob implements Job {

public void execute(JobExecutionContext context)
throws JobExecutionException {
JobDataMap jobDataMap = context.getJobDetail().getJobDataMap();
// jobDataMap 用来 传参数用的,过度 作用
System.out.println("job is running......");
}

}


第二: 启动任务
2.1 获取 schedule

// 首先，必需要取得一个Scheduler的引用
SchedulerFactory sf = new StdSchedulerFactory();

Scheduler sched = sf.getScheduler();
2.2 通过 JobBuilder 创建 JobDetail
JobDetail job = JobBuilder.newJob(MonthReportJob.class)
.withIdentity("exportMonth-job", "export-group").build();
有些参数 可以用 JobDataMap 来传递

job.getJobDataMap().put("test", "jobDataMap");

2.3 创建 trigger  设置 执行时间规则
比如:每周末 23:59:00 执行

CronTrigger trigger = newTrigger().withIdentity("trigger1", "export-group")
.withSchedule(cronSchedule("0 59 23 ? * SUN")).build();

2.4 把创建好的 jobDetail 与 trigger  加入到 schedule 中
sched.scheduleJob(job, trigger);
2.5 启动 schedule
// 开始执行，start()方法被调用后，计时器就开始工作，计时调度中允许放入N个Job
sched.start();

我在项目中使用的 cron 表达式为:
周报: String weekCronStr = "0 59 23 ? * SUN";

月报: String monthCronStr = "0 55 23 L * ?";

季报: String monthCronStr = "0 55 23 L * ?";

年报: String yearCronStr = "0 58 23 31 12 ?";

ps:其中季报 我是按照 月报来,只是在 执行之前 先判断 本月的月份 是不是 为 3 6 9  12 

常用的 cron (格林)表达式 总结:

这些星号由左到右按顺序代表 ：     *    *     *     *    *     *   *     

                                          格式： [秒] [分] [小时] [日] [月] [周] [年] 

序号 说明 

  是否必填  允许填写的值 允许的通配符 

1  秒  是  0-59    , - * / 

2  分  是  0-59 

   , - * / 

3 小时  是  0-23   , - * / 

4  日  是  1-31   , - * ? / L W 

5  月  是  1-12 or JAN-DEC   , - * / 

6  周  是  1-7 or SUN-SAT   , - * ? / L # 

7  年  否  empty 或 1970-2099  , - * / 

通配符说明: 

* 表示所有值. 例如:在分的字段上设置 "*",表示每一分钟都会触发。 

? 表示不指定值。使用的场景为不需要关心当前设置这个字段的值。例如:要在每月的10号触发一个操作，但不关心是周几，所以需要周位置的那个字段设置为"?" 具体设置为 0 0 0 10 * ? 

- 表示区间。例如 在小时上设置 "10-12",表示 10,11,12点都会触发。 

, 表示指定多个值，例如在周字段上设置 "MON,WED,FRI" 表示周一，周三和周五触发 

/ 用于递增触发。如在秒上面设置"5/15" 表示从5秒开始，每增15秒触发(5,20,35,50)。在月字段上设置'1/3'所示每月1号开始，每隔三天触发一次。 

L 表示最后的意思。在日字段设置上，表示当月的最后一天(依据当前月份，如果是二月还会依据是否是润年[leap]), 在周字段上表示星期六，相当于"7"或"SAT"。如果在"L"前加上数字，则表示该数据的最后一个。例如在周字段上设置"6L"这样的格式,则表示“本月最后一个星期五" 

W 表示离指定日期的最近那个工作日(周一至周五). 例如在日字段上设置"15W"，表示离每月15号最近的那个工作日触发。如果15号正好是周六，则找最近的周五(14号)触发, 如果15号是周未，则找最近的下周一(16号)触发.如果15号正好在工作日(周一至周五)，则就在该天触发。如果指定格式为 "1W",它则表示每月1号往后最近的工作日触发。如果1号正是周六，则将在3号下周一触发。(注，"W"前只能设置具体的数字,不允许区间"-"). 

小提示 

'L'和 'W'可以一组合使用。如果在日字段上设置"LW",则表示在本月的最后一个工作日触发(一般指发工资 ) 

# 序号(表示每月的第几个周几)，例如在周字段上设置"6#3"表示在每月的第三个周六.注意如果指定"#5",正好第五周没有周六，则不会触发该配置(用在母亲节和父亲节再合适不过了) 

小提示 

周字段的设置，若使用英文字母是不区分大小写的 MON 与mon相同. 

常用示例: 

0 0 12 * * ? 每天12点触发 

0 15 10 ? * * 每天10点15分触发 

0 15 10 * * ? 每天10点15分触发 

0 15 10 * * ? * 每天10点15分触发 

0 15 10 * * ? 2005 2005年每天10点15分触发 

0 * 14 * * ? 每天下午的 2点到2点59分每分触发 

0 0/5 14 * * ? 每天下午的 2点到2点59分(整点开始，每隔5分触发) 

0 0/5 14,18 * * ? 每天下午的 2点到2点59分(整点开始，每隔5分触发) 

每天下午的 18点到18点59分(整点开始，每隔5分触发) 

0 0-5 14 * * ? 每天下午的 2点到2点05分每分触发 

0 10,44 14 ? 3 WED     3月分每周三下午的 2点10分和2点44分触发 （特殊情况，在一个时间设置里，执行两次或                                                             两次以上的情况） 

0 59 2 ? * FRI    每周5凌晨2点59分触发； 

0 15 10 ? * MON-FRI 从周一到周五每天上午的10点15分触发 

0 15 10 15 * ? 每月15号上午10点15分触发 

0 15 10 L * ? 每月最后一天的10点15分触发 

0 15 10 ? * 6L 每月最后一周的星期五的10点15分触发 

0 15 10 ? * 6L 2002-2005 从2002年到2005年每月最后一周的星期五的10点15分触发 

0 15 10 ? * 6#3 每月的第三周的星期五开始触发 

0 0 12 1/5 * ? 每月的第一个中午开始每隔5天触发一次 

0 11 11 11 11 ? 每年的11月11号 11点11分触发(光棍节)