SpringBoot中的定时任务与Quartz的整合
springboot集成quartz
定时任务quartz : 就是在指定的时间执行一次或者循环执行,在项目的开发中有时候会需要的, 还是很有用的.
springboot内置的定时
- 添加依赖
<dependency> <groupid>org.springframework.boot</groupid> <artifactid>spring-boot-starter</artifactid> </dependency>
- 启动类上添加注解
@springbootapplication @enablescheduling public class springbootquartzapplication { }
- 创建定时执行的任务类(两种方式)
方式一:
@component public class schedulertask { private int count = 0; /** * @author smith * @description 设置没6秒执行一次 * @date 14:23 2019/1/24 * @param * @return void **/ @scheduled(cron = "*/6 * * * * ?") private void process(){ system.out.println("this is scheduler task running " + (count++)); } }
方式二:
@component public class schedulertask2 { private static final simpledateformat dateformat = new simpledateformat("hh:mm:ss"); /** * @author smith * @description 设置没6秒执行一次 * @date 14:22 2019/1/24 * @param * @return void **/ @scheduled(fixedrate = 6000) private void process(){ system.out.println("now time is " + dateformat.format(new date())); } }
参数说明
@scheduled 参数可以接受两种定时的设置,一种是我们常用的 cron="/6 * * * ?",一种是 fixedrate = 6000,两种都可表示固定周期执行定时任务。
fixedrate说明
- @scheduled(fixedrate = 6000):上一次开始执行时间点之后 6 秒再执行。
- @scheduled(fixeddelay = 6000):上一次执行完毕时间点之后 6 秒再执行。
- @scheduled(initialdelay=1000, fixedrate=6000):第一次延迟 1 秒后执行,之后按 fixedrate 的规则每 6 秒执行一次。
cron说明
cron一定有七位数,最后一位是年,springboot定时方案只需要设置六位即可:
- 第一位, 表示秒, 取值是0 ~ 59
- 第二位, 表示分. 取值是0 ~ 59
- 第三位, 表示小时, 取值是0 ~ 23
- 第四位, 表示天/日, 取值是0 ~ 31
- 第五位, 表示月份, 取值是1 ~ 12
- 第六位, 表示星期, 取值是1 ~ 7, 星期一,星期二..., 还有 1 表示星期日
- 第七位, 年份, 可以留空, 取值是1970 ~ 2099
cron中,还有一些特殊的符号,含义如下:
- (*) 星号,可以理解为每的意思,每秒、每分、每天、每月、每年...。
- (?)问号,问号只能出现在日期和星期这两个位置,表示这个位置的值不确定,每天 3 点执行,因此第六位星期的位置,是不需要关注的,就是不确定的值;同时,日期和星期是两个相互排斥的元素,通过问号来表明不指定值,比如 1 月 10 日是星期一,如果在星期的位置另指定星期二,就前后冲突矛盾了。
- (-)减号,表达一个范围,如在小时字段中使用“10 - 12”,则表示从 10 到 12 点,即 10、11、12。
- (,)逗号,表达一个列表值,如在星期字段中使用“1,2,4”,则表示星期一、星期二、星期四。
- (/)斜杠,如 x/y,x 是开始值,y 是步长,比如在第一位(秒),0/15 就是从 0 秒开始,每隔 15 秒执行一次,最后就是 0、15、30、45、60,另 */y,等同于 0/y。
举几个例子熟悉一下:
- 0 0 3 * * ? :每天 3 点执行;
- 0 5 3 * * ?:每天 3 点 5 分执行;
- 0 5 3 ? * *:每天 3 点 5 分执行,与上面作用相同;
- 0 5/10 3 * * ?:每天 3 点的 5 分、15 分、25 分、35 分、45 分、55分这几个时间点执行;
- 0 10 3 ? * 1:每周星期天,3 点 10 分执行,注,1 表示星期天;
- 0 10 3 ? * 1#3:每个月的第三个星期,星期天执行,# 号只能出现在星期的位置。
基本上springboot自带的定时就是这么简单了.
quartz
建议写代码的时候下载下代码来看看目录结构
quartz有四个核心概念:
- job:是一个接口,只定义一个方法 execute(jobexecutioncontext context),在实现接口的 execute 方法中编写所需要定时执行的 job(任务),jobexecutioncontext 类提供了调度应用的一些信息;job 运行时的信息保存在 jobdatamap 实例中。
- jobdetail:quartz 每次调度 job 时,都重新创建一个 job 实例,因此它不接受一个 job 的实例,相反它接收一个 job 实现类(jobdetail,描述 job 的实现类及其他相关的静态信息,如 job 名字、描述、关联监听器等信息),以便运行时通过 newinstance() 的反射机制实例化 job。
- rigger:是一个类,描述触发 job 执行的时间触发规则,主要有 simpletrigger 和 crontrigger 这两个子类。当且仅当需调度一次或者以固定时间间隔周期执行调度,simpletrigger 是最适合的选择;而 crontrigger 则可以通过 cron 表达式定义出各种复杂时间规则的调度方案:如工作日周一到周五的 15:00 ~ 16:00 执行调度等。
- scheduler:调度器就相当于一个容器,装载着任务和触发器,该类是一个接口,代表一个 quartz 的独立运行容器,trigger 和 jobdetail 可以注册到 scheduler 中,两者在 scheduler 中拥有各自的组及名称,组及名称是 scheduler 查找定位容器中某一对象的依据,trigger 的组及名称必须唯一,jobdetail 的组和名称也必须唯一(但可以和 trigger 的组和名称相同,因为它们是不同类型的)。scheduler 定义了多个接口方法,允许外部通过组及名称访问和控制容器中 trigger 和 jobdetail。
job 为作业的接口,为任务调度的对象;jobdetail 用来描述 job 的实现类及其他相关的静态信息;trigger 做为作业的定时管理工具,一个 trigger 只能对应一个作业实例,而一个作业实例可对应多个触发器;scheduler 做为定时任务容器,是 quartz 最上层的东西,它提携了所有触发器和作业,使它们协调工作,每个 scheduler 都存有 jobdetail 和 trigger 的注册,一个 scheduler 中可以注册多个 jobdetail 和多个 trigger。
整合
- 引入依赖:
<dependency> <groupid>org.springframework.boot</groupid> <artifactid>spring-boot-starter-quartz</artifactid> </dependency>
- 定时输出helloworld(使用scheduler 启动)
首先定义一个job
public class samplejob extends quartzjobbean { private string name; public void setname(string name) { this.name = name; } @override protected void executeinternal(jobexecutioncontext jobexecutioncontext) throws jobexecutionexception { system.out.println("quartz ----> hello, " + this.name); } }
构建jobdetail:
@configuration public class samplescheduler { @bean public jobdetail samplejobdetail() { // 链式编程,可以携带多个参数,在job类中声明属性 + setter方法 return jobbuilder.newjob(samplejob.class).withidentity("samplejob") .usingjobdata("name","world").storedurably().build(); } @bean public trigger samplejobtrigger(){ // 每隔两秒执行一次 simpleschedulebuilder schedulebuilder = simpleschedulebuilder.simpleschedule().withintervalinseconds(2).repeatforever(); return triggerbuilder.newtrigger().forjob(samplejobdetail()).withidentity("sampletrigger") .withschedule(schedulebuilder).build(); } }
- jobbuilder 无构造函数,只能通过 jobbuilder 的静态方法 newjob(class jobclass)生成 jobbuilder 实例。
- withidentity 方法可以传入两个参数 withidentity(string name,string group) 来定义 triggerkey,也可以不设置,像上文示例中会自动生成一个独一无二的 triggerkey 用来区分不同的 trigger。
- cronschedule方式
cronschedule可以设置更灵活的方式,定时设置与springboot自带的表达式相同.
同理,先定义两个个job,与scheduledjob相同,不过实现job接口,如下:
第一个job:
public class scheduledjob implements job { private string name; public void setname(string name) { this.name = name; } @override public void execute(jobexecutioncontext jobexecutioncontext) throws jobexecutionexception { simpledateformat dateformat = new simpledateformat("hh:mm:ss"); system.out.println("cron ----> schedule job1 is running ... + " + name + " ----> " + dateformat.format(new date())); } }
第二个job
public class scheduledjob2 implements job { private string name; public void setname(string name) { this.name = name; } @override public void execute(jobexecutioncontext jobexecutioncontext) throws jobexecutionexception { simpledateformat dateformat = new simpledateformat("hh:mm:ss"); system.out.println("cron ----> schedule job2 is running ... + " + name + " ----> " + dateformat.format(new date())); } }
构建schedule来执行任务:
@component public class cronschedulerjob { @autowired private schedulerfactorybean schedulerfactorybean; private void schedulejob1(scheduler scheduler) throws schedulerexception { jobdetail jobdetail = jobbuilder.newjob(scheduledjob.class) .withidentity("job1", "group1").build(); // 6的倍数秒执行 也就是 6 12 18 24 30 36 42 .... cronschedulebuilder schedulebuilder = cronschedulebuilder.cronschedule("0/6 * * * * ?"); crontrigger crontrigger = triggerbuilder.newtrigger().withidentity("trigger1", "group1") .usingjobdata("name","王智1").withschedule(schedulebuilder).build(); scheduler.schedulejob(jobdetail,crontrigger); } private void schedulejob2(scheduler scheduler) throws schedulerexception{ jobdetail jobdetail = jobbuilder.newjob(scheduledjob2.class) .withidentity("job2", "group2").build(); // 12秒的倍数执行 12 24 36 48 60 cronschedulebuilder schedulebuilder = cronschedulebuilder.cronschedule("0/12 * * * * ?"); crontrigger crontrigger = triggerbuilder.newtrigger().withidentity("trigger2", "group2") .usingjobdata("name","王智2").withschedule(schedulebuilder).build(); scheduler.schedulejob(jobdetail,crontrigger); } /** * @author smith * @description 同时启动两个定时任务 * @date 16:31 2019/1/24 * @param * @return void **/ public void schedulejobs() throws schedulerexception { scheduler scheduler = schedulerfactorybean.getscheduler(); schedulejob1(scheduler); schedulejob2(scheduler); } }
触发定时任务有两种方式:
第一种是项目启动时执行:
@component public class mystartuprunner implements commandlinerunner { @autowired public cronschedulerjob schedulejobs; @override public void run(string... args) throws exception { schedulejobs.schedulejobs(); system.out.println(">>>>>>>>>>>>>>>定时任务开始执行<<<<<<<<<<<<<"); } }
第二种是定时执行:
@configuration @enablescheduling @component public class schedulerlistener { @autowired public cronschedulerjob schedulejobs; @scheduled(cron="0 47 16 24 1 ?") public void schedule() throws schedulerexception { schedulejobs.schedulejobs(); system.out.println(">>>>>>>>>>>>>>>定时任务开始执行<<<<<<<<<<<<<"); } }
两种启动方案,在项目中选择一种使用即可,否则会导致重复启动定时任务而报错。 所以在测试某一个启动时,将另一个类上的注解注释掉就可以了.
我刚开始工作,所以暂时还没遇到定时任务方面需求,但是总感觉这个以后会用,提前学习一下,而且自我感觉这个定时任务也是挺有意思. 在springboot自带的定时器中我不知道能不能传递参数,但是quartz是可以,所以说如果需要传递参数的话就是用quartz绝对没问题.
源码: https://github.com/misswanglove/springboot
上一篇: Java初学者容易犯的代码错误