一.简介
Spring Task 是 Spring 框架提供的一种任务调度和异步处理的解决方案。可以按照约定的时间自动执行某个代码逻辑它可以帮助开发者在 Spring 应用中轻松地实现定时任务、异步任务等功能,提高应用的效率和可维护性。
二.实现
一.基于注解***@Scheduled***
1.通过@Scheduled注释结合cron表达式实现
cron表达式:
cron表达式是一种用于设置定时任务的语法规则。它由6个字段组成,分别表示秒、分、小 时、日期、月份和星期几。每个字段都可以设置一个数字、一组数字(用逗号分隔)、一段数字范围(用短横线分隔)、通配符(表示任意值)或者特定的字符(如星期几的英文缩写)
语法规则:
Cron表达式的详细用法 - 简书
示例:
0 0 0 * * ?:每天的零点整执行任务。
0 0 */2 * * ?:每隔2小时执行一次任务。
0 0 12 * * ?:每天中午12点执行任务。
0 15 10 * * ?:每天上午10点15分执行任务。
0 0 6,18 * * ?:每天的早上6点和晚上6点执行任务。
0 0/30 8-18 * * ?:每天的上午8点到下午6点之间,每隔30分钟执行一次任务。
0 0 0 1 1 ?:每年的1月1日零点整执行任务。
0 0 0 * * 2:每周的星期二零点整执行任务。
0 0 0 ? * 6#3:每月的第三个星期六零点整执行任务。
0 0 0 L * ?:每个月的最后一天零点整执行任务。
————————————————
结合@Scheduled:
@Scheduled(cron ="*/6 * * * * ?")
public void sayHello() {
System.out.println("hello"); }
输出结果:
注:启动类需要能扫描到定时任务类,否则定时任务启动不起来。
除了cron表达式外,还支持(感兴趣可以进一步了解)
1.fixedRate:控制方法执行的间隔时间,是以上一次方法执行完开始算起,如上一次方法执行阻塞住了,那么直到上一次执行完,并间隔给定的时间后,执行下一次。
2.initialDelay:initialDelay = 10000 表示在容器启动后,延迟10秒后再执行一次定时器。
优缺点:
优:添加注解即可,使用方便。
缺:1.@Scheduled作用在方法上,方法不能有参数
2.@Scheduled注解只能在开始就写好,无法动态定义
3.spring支持的springtask的cron语句无法识别年份,也就是定时任务以固定频率执行,无法做到只执行一次。
二.基于接口方式SchedulingConfigurer:
为了实现动态定义定时任务
一.创建数据库表和相应字段存放cron语句
drop table if exists scheduled;
create table scheduled (
cron_id varchar(30) NOT NULL primary key,
cron_name varchar(30) NULL,
cron varchar(30) NOT NULL
);
insert into scheduled values ('1','定时器任务一','0/6 * * * * ?');
二.新增mapper类获取数据库存放的cron表达式
@Select("select cron from cron_demo where cron_id=#{id}")
public String getCronById(int id);
三.新建task类执行定时任务
public class TaskDemo implements SchedulingConfigurer {
@Override
public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
taskRegistrar.addTriggerTask();//or: addCronTask...
}
private void process(){
System.out.println("cron执行");
}//要执行的逻辑
}
注意实现SchedulingConfigurer接口
用于添加定时任务的方法在这里很多很灵活,如addTriggerTask,addCronTask,并且方法重载也较多,建议查看源码学习
这里介绍常用api:addTriggerTask,和addCronTask
addTriggerTask:
![](https://i-blog.csdnimg.cn/blog_migrate/85080b6227b4a6551d0aedc78f5466e5.png)
第一个方法实际是调用第二个方法
Runable task为要执行的逻辑(想要定时实现的方法),Trigger trigger为使用某种方式封装的cron语句,介绍一个简单易懂好用的实现类---CronTrigger
![](https://i-blog.csdnimg.cn/blog_migrate/7ad0a78b27e4940745ac3ec94da06fbc.png)
expression为cron表达式,zonid为代表时区(不用管,会调用系统默认时区),默认使用第一个构造方法即可
第二种:
![](https://i-blog.csdnimg.cn/blog_migrate/c9a512ec2e26bb20d7066fbf188e8fc1.png)
CronTask是TriggerTask的子类,其成员可谓非常人性化,expression即为cron表达式,构造方法再传入runable执行内容即可
示例:
public class TaskDemo implements SchedulingConfigurer {
@Override
public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
taskRegistrar.addCronTask(this::process,cronMapper.getCronByid(1)))
}//要执行的逻辑
private void process(){
System.out.println("cron执行");
}
}
从上示例看出,当用addTriggetTask时,如果用Crontask,用法和addCronTask差不多,这两个的底层都是调用了一个叫add的方法
扩展:Runnable runnabke的写法
注:Runable是线程的知识点,由于本人目前没有学习java线程部分,无法讲解其底层原理,只介绍在实现定时任务时的用法
Runable只是一个接口,内部只有一个void的run方法
![](https://i-blog.csdnimg.cn/direct/070c5f7dcd0e42b9b4cb4efebab31f01.png)
需要定义实现类,如下在纳新大作业中的实现:
private class TaskRunnable implements Runnable{
private final Cron cron;
public TaskRunnable(Cron cron) {
this.cron = cron;
}
@Override
public void run() {
//定义任务要做的事,即把visibility字段设为0表示可见,
// 同时把时间设为设定的发送时间
// (如果设为当前时间由于定时任务管理器CronManageTask扫面时间间隔问题会导致实际执行时间与预期发送时间不一致)
mailboxService.lambdaUpdate()
.set(Email::getVisibility,(short)0)
.set(Email::getSendTime,cron.getExecuteTime())
.eq(Email::getId,cron.getEmailId())
.update();
}
}
这里的cron为从外传入的参数,可以通过构造方法将cron传入对象中,这就解决了@Secheduled无法传递参数的问题,
示例:
@RequiredArgsConstructor
public class TaskDemo implements SchedulingConfigurer {
private final CronMapper cronMapper;
@Override
public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
Runnable task =this::process;
CronTask cronTask = new CronTask(task,cronMapper.getCronById(1));
taskRegistrar.addTriggerTask(cronTask);
}
private void process(){
System.out.println("cron执行");
}//要执行的逻辑
}
还有一个在查找博客时看到的示例,方法基本上一样只不过使用了lambda表达式,但是匿名内部类我只了解一点点,还请大佬help:
@Autowired
protected CronMapper cronMapper;
@Override
public void configureTasks(ScheduledTaskRegistrar scheduledTaskRegistrar) {
scheduledTaskRegistrar.addTriggerTask(() -> process(),
triggerContext -> {
String cron = cronMapper.getCron(1);
if (cron.isEmpty()) {
System.out.println("cron is null");
}
return new CronTrigger(cron).nextExecutionTime(triggerContext);
});
}
private void process() {
System.out.println("基于接口定时任务");
}
三.基于ThreadPoolTaskScheduler轻量级多线程定时任务框架
上述基于接口的方法解决了基于注解无法实现的动态定义cron表达式和方法传入参数的问题,但示例无法实现根据传入的年份指定在某一年特定日期执行定时任务,下面介绍一种实现方式
一.简介:
- springboot中有一个bean,ThreadPoolTaskScheduler,可以很方便的对重复执行的任务进行调度管理;相比于通过java自带的周期性任务线程池
- ScheduleThreadPoolExecutor,此bean对象支持根据cron表达式创建周期性任务。
- 当然,ThreadPoolTaskScheduler其实底层使用也是java自带的线程池。
二.常用api介绍
ThreadPoolTaskScheduler 内部方法非常丰富,本文实现的是一种corn表达式,周期执行
- schedule(Runnable task, Trigger trigger) corn表达式,周期执行
- schedule(Runnable task, Date startTime) 定时执行
- scheduleAtFixedRate(Runnable task, Date startTime, long period) 定时周期间隔时间执行。间隔时间单位 TimeUnit.MILLISECONDS
- scheduleAtFixedRate(Runnable task, long period) 间隔时间执行。单位毫秒
三.上实战
1.新建实现类cron(随便取的名)这里直接使用lambda注解
@Data
@AllArgsConstructor
@NoArgsConstructor
@TableName("thread_cron")
public class cron {
private String title;
private LocalDate startTime;//起始时间
private LocalDate deadTime;//结束时间
private LocalDateTime executeTime;//运行时间
}
解释:startTime为任务启动年份第一天,deadTime为任务启动年份最后一天(指定年份执行,也可以根据需求调整),executeTime为任务执行时间
2.创建对应的service接口和实现类
public interface ThreadService extends IService<Cron> {
void startCron(Cron cron);//启动定时任务
void stopCron(Cron cron);//停止定时任务
void changeCron(Cron cron);//更新定时任务
}
实现类的具体逻辑:
1.每个任务有一个执行期限,就是cron类中的startTime和deadTime,这里一般存储年份信息,将任务限定在某年执行,在启动定时任务也就是调用startCron方法时,需要判断当前时间是否在期限内
2.同一任务可能被多次启动,这显然是多余的,因此需要将已经启动过的定时任务放入一个集合中,在调用startCron时检查当前任务是否在集合中。执行定时任务的方法是ThreadPoolTaskScheduler中的public ScheduledFuture schedule(Runnable task, Trigger trigger)这个方法,可以看到,方法参数在上面基于接口处讲过,方法返回值ScheduledFuture包含执行的任务的详细信息,停止任务也需要调用其中的boolean cancel(boolean mayInterruptIfRunning)方法,因此,可以用此类型的集合来存放执行中的定时任务
示例:
准备:
private final ThreadPoolTaskScheduler threadPoolTaskScheduler;
private final Map<Integer, ScheduledFuture<?>> futureMap = new HashMap<>();
@Bean
public ThreadPoolTaskScheduler threadPoolTaskScheduler() {
return new ThreadPoolTaskScheduler();
}
startCron:
public void startCron(Cron cron) {
//1.判断cron是否被执行过
if(futureMap.containsKey(cron.getId())){log.info("定时任务存在 id={}",cron.getId());return;}
//2.判断是否还没过执行时间
//在springTask中,cron表达式无法对年进行定时,故使用startTime和deadTime来限制定时任务要执行的年份
if(LocalDate.now().isEqual(cron.getStartTime()) || LocalDate.now().isEqual(cron.getDeadTime()) ||
(LocalDate.now().isAfter(cron.getStartTime()) && LocalDate.now().isBefore(cron.getDeadTime()))){
//提取执行时间
LocalDateTime executeTime = cron.getExecuteTime();
//组装cron表达式
DateTimeFormatter cronFormatter = DateTimeFormatter.ofPattern("s m H d M");
String cronExp = cronFormatter.format(executeTime)+" ?";
//执行scheduled任务
ScheduledFuture<?> future = threadPoolTaskScheduler.schedule(new TaskRunnable(cron), new CronTrigger(cronExp));
//将future传入futureMap集合表示任务启动,避免任务重复启动
futureMap.put(cron.getId(),future);
//输出日志
log.info("任务启动,id:{},executeTime:{}",cron.getId(),cron.getExecuteTime());
}
}
stopCron:
public void stopCron(Cron cron) {
ScheduledFuture<?> future = futureMap.get(cron.getId());
if (future != null) {
future.cancel(true);
futureMap.remove(cron.getId());
log.info("任务停止,id:{}",cron.getId());
}
}
changeCron:
public void changeCron(Cron cron) {
startCron(cron);
stopCron(cron);
}
TaskRunnable类:
private class TaskRunnable implements Runnable{
private final Cron cron;
public TaskRunnable(Cron cron) {
this.cron = cron;
}
@Override
public void run() {
//定义任务要做的事
System.out.println("定时任务执行,id:"+cron.getId());
}
}
3.创建cronTaskManager类
注:cronTaskManager类上加注解@Compoment
上述解决了基于注解的三个问题,但是还存在一个问题,定时任务制定后被启用需要保持服务器或应用程序一直被启动,如果关闭应用程序,定时任务也将失效,因此需要一个类来管理定时任务,基本思路是:在应用启动时每隔一段时间扫描一边数据库存放的定时任务,将其启动或停止。
public class cronTaskManager {
@Lazy
private final ThreadService threadService;
//每半个小时扫描一次
@Scheduled(cron = "0 0/30 * * * ?")
public void cronManage() {
log.info("定时任务启动");
List<Cron> list = threadService.list();
list.forEach(cron -> {
if (LocalDate.now().isAfter(cron.getDeadTime())) {
threadService.stopCron(cron);
threadService.removeById(cron.getId());
log.info("任务过期删除,id:{},executeTime:{}",cron.getId(),cron.getExecuteTime());
} else {
log.info("尝试启动任务,id:{},executeTime:{}",cron.getId(),cron.getExecuteTime());
threadService.startCron(cron);
}
});
}
}
启动应用定时启动ronManager方法扫描数据库存在的定时任务,如果任务过期则删除,否则尝试启动。
参考博客:
Spring boot开启定时任务的三种方式_springboot 定时任务-CSDN博客
在 SpringBoot 中使用 ThreadPoolTaskScheduler 实现定时任务-CSDN博客
SpringBoot实现用户定制的定时任务(动态定时任务)_怎么调用serviceimpl里面的定时任务-CSDN博客
ThreadPoolTaskScheduler轻量级多线程定时任务框架-阿里云开发者社区
SpringBoot基于SchedulingConfigurer接口实现动态定时任务(二)_schedulingconfigurer 实时刷新-CSDN博客
版权归原作者 cold__liang 所有, 如有侵权,请联系我们删除。