如何在SpringBoot中优雅的实现定时任务

大家好,我是架构君,一个会写代码吟诗的架构师。今天说一说在SpringBoot中优雅的实现定时任务,希望能够帮助大家进步!!! https://javajgs.com/archives/27921
在日常的项目开发中,往往会涉及到一些需要做到定时执行的代码,例如自动将超过24小时的未付款的单改为取消状态,自动将超过14天客户未签收的订单改为已签收状态等等,那么为了在Spring Boot中实现此类需求,我们要怎么做呢?
Spring Boot早已考虑到了这类情况,先来看看要怎么做。第一种方式是比较简单的,先搭建好Spring Boot微服务,加上这个注解 <strong>@EnableScheduling </strong>:
<div>
<pre><code>
/**

  • @author yudong

  • @date 2019/8/24
    */
    @EnableCaching // 启用缓存功能
    @EnableScheduling // 开启定时任务功能
    @ComponentScan(basePackages = "org.javamaster.b2c")
    @EnableTransactionManagement
    @SpringBootApplication
    public class ScheduledApplication {
    private static Logger logger = LoggerFactory.getLogger(ScheduledApplication.class);

    public static void main(String[] args) {
    SpringApplication.run(ScheduledApplication.class, args);
    logger.info("定时任务页面管理地址:{}", "http://localhost:8089/scheduled/task/taskList");
    }

}</code></pre></div>
<p>然后编写定时任务类:</p>
<div><pre><code>/**

  • @author yudong

  • @date 2019/8/24
    */
    @Component
    public class FixedPrintTask {
    private Logger logger = LoggerFactory.getLogger(getClass());
    private int i;

    @Scheduled(cron = "*/15 * * * * ?")
    public void execute() {
    logger.info("thread id:{},FixedPrintTask execute times:{}", Thread.currentThread().getId(), ++i);
    }

}</code></pre></div>
<p>@Scheduled(cron ="*/15 * * * * ?")注解表明这是一个需要定时执行的方法,里面的cron属性接收的是一个cron表达式,这里我给的是 */15 * * * * ? ,这个的意思是每隔15秒执行一次方法,对cron表达式不熟悉的同学可以百度一下用法。项目跑起来后可以看到方法被定时执行了:</p>

<p>这种方式有个缺点,那就是执行周期写死在代码里了,没有办法动态改变,要想改变只能修改代码在重新部署启动微服务。其实Spring也考虑到了这个,所以给出了另外的解决方案,就是我下面说的第二种方式。</p>
<p>第二种方式需要用到数据库,先来建立一个定时任务表并插入三条定时任务记录:</p>
<div><pre><code>drop table if exists spring_scheduled_cron;
create table spring_scheduled_cron (
cron_id int primary key auto_increment
comment '主键id',
cron_key varchar(128) not null unique
comment '定时任务完整类名',
cron_expression varchar(20) not null
comment 'cron表达式',
task_explain varchar(50) not null default ''
comment '任务描述',
status tinyint not null default 1
comment '状态,1:正常;2:停用',
unique index cron_key_unique_idx(cron_key)
)
ENGINE = InnoDB
DEFAULT CHARSET = utf8mb4
COMMENT = '定时任务表';

insert into spring_scheduled_cron
values (1, 'org.javamaster.b2c.scheduled.task.DynamicPrintTask', '/5 * * * * ?', '定时任务描述', 1);
insert into spring_scheduled_cron
values (2, 'org.javamaster.b2c.scheduled.task.DynamicPrintTask1', '
/5 * * * * ?', '定时任务描述1', 1);
insert into spring_scheduled_cron
values (3, 'org.javamaster.b2c.scheduled.task.DynamicPrintTask2', '/5 * * * * ?', '定时任务描述2', 1);</code></pre></div>
<p>编写一个配置类:</p>
<div><pre><code>@Configuration
public class ScheduledConfig implements SchedulingConfigurer {
@Autowired
private ApplicationContext context;
@Autowired
private SpringScheduledCronRepository cronRepository;
@Override
public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
for (SpringScheduledCron springScheduledCron : cronRepository.findAll()) {
Class<?> clazz;
Object task;
try {
clazz = Class.forName(springScheduledCron.getCronKey());
task = context.getBean(clazz);
} catch (ClassNotFoundException e) {
throw new IllegalArgumentException("spring_scheduled_cron表数据" + springScheduledCron.getCronKey() + "有误", e);
} catch (BeansException e) {
throw new IllegalArgumentException(springScheduledCron.getCronKey() + "未纳入到spring管理", e);
}
Assert.isAssignable(ScheduledOfTask.class, task.getClass(), "定时任务类必须实现ScheduledOfTask接口");
// 可以通过改变数据库数据进而实现动态改变执行周期
taskRegistrar.addTriggerTask(((Runnable) task),
triggerContext -> {
String cronExpression = cronRepository.findByCronKey(springScheduledCron.getCronKey()).getCronExpression();
return new CronTrigger(cronExpression).nextExecutionTime(triggerContext);
}
);
}
}
@Bean
public Executor taskExecutor() {
return Executors.newScheduledThreadPool(10);
}
}</code></pre></div>
<p>这里我为了做到可以灵活处理,自定义了一个接口ScheduledOfTask:</p>
<div><pre><code>/
*

  • @author yudong
  • @date 2019/5/11
    /
    public interface ScheduledOfTask extends Runnable {
    /
    *
    • 定时任务方法
      /
      void execute();
      /
      *
    • 实现控制定时任务启用或禁用的功能
      /
      @Override
      default void run() {
      SpringScheduledCronRepository repository = SpringUtils.getBean(SpringScheduledCronRepository.class);
      SpringScheduledCron scheduledCron = repository.findByCronKey(this.getClass().getName());
      if (StatusEnum.DISABLED.getCode().equals(scheduledCron.getStatus())) {
      // 任务是禁用状态
      return;
      }
      execute();
      }
      }</code></pre></div>
      <p>所有定时任务类只需要实现这个接口并相应的在数据库插入一条记录,那么在微服务启动的时候,就会被自动注册到Spring的定时任务里,也就是这行代码所起的作用:</p>
      <div><pre><code> // 可以通过改变数据库数据进而实现动态改变执行周期
      taskRegistrar.addTriggerTask(((Runnable) task),
      triggerContext -> {
      String cronExpression = cronRepository.findByCronKey(springScheduledCron.getCronKey()).getCronExpression();
      return new CronTrigger(cronExpression).nextExecutionTime(triggerContext);
      }
      );</code></pre></div>
      <p>具体的定时任务类(一共有三个,这里我只列出一个):</p>
      <div><pre><code>/
      *
  • @author yudong
  • @date 2019/5/10
    */
    @Component
    public class DynamicPrintTask implements ScheduledOfTask {
    private Logger logger = LoggerFactory.getLogger(getClass());
    private int i;
    @Override
    public void execute() {
    logger.info("thread id:{},DynamicPrintTask execute times:{}", Thread.currentThread().getId(), ++i);
    }

}</code></pre></div>
<p>项目跑起来后,可以看到类被定时执行了:</p>

<p>那么,要如何动态改变执行周期呢,没有理由去手工改动数据库吧?开发测试环境可以这么搞,生产环境就不可以了,所以为了做到动态改变数据库数据,很简单,提供一个Controller类供调用:</p>
<div><pre><code>/**

  • 管理定时任务(需要做权限控制),具体的业务逻辑应
  • 该写在Service里,良好的设计是Controller本身
  • 只处理很少甚至不处理工作,业务逻辑均委托给
  • Service进行处理,这里我偷一下懒,都写在Controller
  • @author yudong
  • @date 2019/5/10
    /
    @Controller
    @RequestMapping("/scheduled/task")
    public class TaskController {
    @Autowired
    private ApplicationContext context;
    @Autowired
    private SpringScheduledCronRepository cronRepository;
    /
    *
    • 查看任务列表
      /
      @RequestMapping("/taskList")
      public String taskList(Model model) {
      model.addAttribute("cronList", cronRepository.findAll());
      return "task-list";
      }
      /
      *
    • 编辑任务cron表达式
      /
      @ResponseBody
      @RequestMapping("/editTaskCron")
      public Result<Void> editTaskCron(String cronKey, String newCron) {
      if (!CronUtils.isValidExpression(newCron)) {
      throw new IllegalArgumentException("失败,非法表达式:" + newCron);
      }
      cronRepository.updateCronExpressionByCronKey(newCron, cronKey);
      return new Result<>(AppConsts.SUCCESS, "更新成功");
      }
      /
      *
    • 执行定时任务
      /
      @ResponseBody
      @RequestMapping("/runTaskCron")
      public Result<Void> runTaskCron(String cronKey) throws Exception {
      ((ScheduledOfTask) context.getBean(Class.forName(cronKey))).execute();
      return new Result<>(AppConsts.SUCCESS, "执行成功");
      }
      /
      *
    • 启用或禁用定时任务
      */
      @ResponseBody
      @RequestMapping("/changeStatusTaskCron")
      public Result<Void> changeStatusTaskCron(Integer status, String cronKey) {
      cronRepository.updateStatusByCronKey(status, cronKey);
      return new Result<>(AppConsts.SUCCESS, "操作成功");
      }
      }</code></pre></div>
      <p>这里我为了方便调用Controller接口,使用thymeleaf技术写了一个简易的html管理页面:</p>

<p>网页效果是这样的:</p>

<p>可以做到查看任务列表,修改任务cron表达式(也就实现了动态改变定时任务执行周期),暂停定时任务,以及直接执行定时任务。</p>

                    </div><blockquote><p>本文使用 <a href="https://www.jianshu.com/p/5709df6fb58d" class="internal">文章同步助手</a> 同步</p></blockquote>
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,772评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,458评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,610评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,640评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,657评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,590评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,962评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,631评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,870评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,611评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,704评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,386评论 4 319
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,969评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,944评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,179评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,742评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,440评论 2 342

推荐阅读更多精彩内容