定时任务管理

这两年做的项目和产品几乎多有定时任务管理的需求。常用的场景有:

  • 定时给用户发送一些消息
  • 定时进行一些报表的计算
  • 定时去指定的接口get一些数据
  • 定时降一些报表发送到指定的邮箱当然还有很多,没有必要一一列举

需求

定时任务的需求通常是这样的

  • 1 需要添加一个定时任务,做一些事情。但是什么时候做要我自己配置,而且还想配置一些参数进去,比如我想定时给指定的email发送邮件.
  • 2 可以临时禁用一个任务。
  • 3 看定时任务执行的历史日志。

具体用法

material-admin对定时任务管理功能的实现如下。

表结构

material-admin提供了两个表:t_sys_task(任务)和t_sys_task_log(任务执行日志)

  • t_sys_task
  1. CREATE TABLE `t_sys_task` (
  2. `id` bigint(64) NOT NULL AUTO_INCREMENT COMMENT '自增主键',
  3. `name` varchar(50) DEFAULT NULL COMMENT '任务名',
  4. `job_group` varchar(50) DEFAULT NULL COMMENT '任务组',
  5. `job_class` varchar(255) DEFAULT NULL COMMENT '执行类',
  6. `note` varchar(255) DEFAULT NULL COMMENT '任务说明',
  7. `cron` varchar(50) DEFAULT NULL COMMENT '定时规则',
  8. `data` text COMMENT '执行参数',
  9. `exec_at` datetime DEFAULT NULL COMMENT '执行时间',
  10. `exec_result` text COMMENT '执行结果',
  11. `disabled` tinyint(1) DEFAULT NULL COMMENT '是否禁用',
  12. `createtime` datetime DEFAULT NULL,
  13. `creator` bigint(20) DEFAULT NULL,
  14. `concurrent` tinyint(4) DEFAULT '0' COMMENT '是否允许并发',
  15. PRIMARY KEY (`id`)
  16. ) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8;
  • t_sys_task_log
  1. CREATE TABLE `t_sys_task_log` (
  2. `id` bigint(64) NOT NULL AUTO_INCREMENT COMMENT '自增主键',
  3. `name` varchar(50) DEFAULT NULL COMMENT '任务名',
  4. `exec_at` datetime DEFAULT NULL COMMENT '执行时间',
  5. `exec_success` int(11) DEFAULT NULL COMMENT '执行结果(成功:1、失败:0)',
  6. `job_exception` varchar(255) DEFAULT NULL COMMENT '抛出异常',
  7. `id_task` bigint(20) DEFAULT NULL,
  8. PRIMARY KEY (`id`)
  9. ) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8;

创建一个定时任务类

比如我创建一个测试任务类

  1. package cn.enilu.guns.service.task.job;
  2. import cn.enilu.guns.service.task.JobExecuter;
  3. import com.alibaba.fastjson.JSON;
  4. import org.springframework.stereotype.Component;
  5. @Component
  6. public class HelloJob extends JobExecuter {
  7. @Override
  8. public void execute(Map<String, Object> dataMap) throws Exception {
  9. System.out.println("输出配置参数如下 :"+JSON.toJSONString(dataMap));
  10. System.out.println("这里可以编写任意其他业务逻辑");
  11. }
  12. }

页面配置一个定时任务

在任务管理页面可以增上改查一个定时任务,还可以禁用、启用定时任务

  • 添加定时任务task-add

  • 定时任务列表task-list

  • 查看定时任务执行历史日志task-log