这样使用Quartz，就不怕任务执行失败了！

本是古典何须时尚 2022-01-30 12:21 211阅读 0赞

[ ![Fork me on Gitee][] ][_Fork me on Gitee_]

基于Quartz的可视化任务系统

[ ![springboot-version][] ][_springboot-version_] [ ![Quartz-version][] ][_Quartz-version_] [ ![druid-spring-boot][] ][_druid-spring-boot_] [ ![mybatis-plus-version][] ][_mybatis-plus-version_] [ ![apache][] ][_apache_]

## 功能展示 ##

### 登录 ###

用户需要正常登录后，方可进入系统，若不登陆直接访问列表或日志页面，则会自动跳转至登录页面。每次登录有效时长为30分钟，过期后刷新页面，也会跳转至登录页面。

帐号、密码均使用 RSA 加密，帐号、密码、RSA公钥、私钥可在application.yml中进行配置。

默认帐号、密码均为：admin。

登录接口添加 `参数签名+时间戳` 机制，时间戳用于防止DDOS工具，参数签名防止被抓包恶意修改参数。

![format_png][]

### 任务列表 ###

任务列表显示每个任务的基本信息，可对任务进行`立即执行`、`暂停`、`恢复`、`删除`、`修改`、`日志查询`操作。

对于不会写 cron 表达式的同学，可以点击左上角的 `在线生成Cron` 按钮进行生成。

右上角可以设置页面的自动刷新频率，默认一秒钟刷新一次。

右上角可以退出登录。

![format_png 1][]

![format_png 2][]

### 任务日志 ###

任务日志页面，可以看到对应任务的`执行时间`、`执行结果`、`执行成功或异常信息`。

任务的日志，按执行时间倒序排序。

![format_png 3][]

![format_png 4][]

## 项目结构 ##

下面是整个项目结构，主要类已做注释。

├─java
    │  └─com
    │      └─leigq
    │          └─quartz
    │              │  QuartzApplication.java
    │              │
    │              ├─bean
    │              │  ├─common
    │              │  │      Response.java  -- 统一返回结果
    │              │  │
    │              │  ├─constant
    │              │  │      QuartzTriggerConstant.java
    │              │  │      SysUserConstant.java
    │              │  │
    │              │  ├─dto
    │              │  │      AddQuartzJobDTO.java
    │              │  │      TaskExecuteDTO.java
    │              │  │
    │              │  ├─enumeration
    │              │  │      SysTaskExecResultEnum.java
    │              │  │
    │              │  ├─job
    │              │  │      BaseJob.java
    │              │  │      BaseJobDisallowConcurrent.java
    │              │  │      BaseTaskExecute.java  -- 任务基础抽象类，其他任务继承此类，实现其execute方法执行任务
    │              │  │
    │              │  └─vo
    │              │          AddSysTaskVO.java
    │              │          SysTaskListVO.java
    │              │          SysTaskLogListVO.java
    │              │          SysUserVO.java
    │              │          UpdateSysTaskVO.java
    │              │
    │              ├─controller
    │              │      LoginController.java
    │              │      SysTaskController.java
    │              │      SysTaskLogController.java
    │              │
    │              ├─domain
    │              │  ├─entity
    │              │  │      SysTask.java
    │              │  │      SysTaskLog.java
    │              │  │
    │              │  └─mapper
    │              │          SysTaskLogMapper.java
    │              │          SysTaskMapper.java
    │              │
    │              ├─service
    │              │      QuartzJobService.java
    │              │      SysTaskLogService.java
    │              │      SysTaskService.java
    │              │
    │              ├─task
    │              │      HelloQuartz.java
    │              │
    │              ├─util
    │              │      RSACoder.java  -- RSA加密工具类
    │              │      SpringContextHolder.java
    │              │      ValidUtils.java
    │              │
    │              └─web
    │                  ├─autoconfigure
    │                  │      LiteAutoConfig.java
    │                  │      QuartzAutoConfig.java
    │                  │
    │                  ├─config
    │                  │      MvcConfig.java
    │                  │      MyBatisPlusConfig.java
    │                  │      OrikaConfig.java
    │                  │      QuartzConfig.java  -- Quartz任务配置
    │                  │
    │                  ├─exception
    │                  │      GlobalExceptionHand.java  -- 全局异常处理
    │                  │      ServiceException.java
    │                  │
    │                  ├─interceptor
    │                  │      LoginInterceptor.java  --登录拦截器
    │                  │
    │                  └─properties
    │                          LiteProperties.java
    │                          QuartzProperties.java
    │
    └─resources
        ├─config
        │      application.yml
        │      log4j2-config.xml
        │
        ├─mapper
        │      SysTaskLogMapper.xml
        │      SysTaskMapper.xml
        │
        ├─sql
        │      Quartz官方建表.sql
        │      自定义任务和任务日志表.sql
        │
        ├─static
        │  ├─css
        │  └─js
        │          jsencrypt.min.js
        │          vue-resource.js
        │          vue.js
        │
        └─templates
                login.html         -- 登录页面
                task-log.html      -- 任务日志页面
                task-manager.html  -- 任务列表页面

结构很简单就不多说了。

建议直接把源码克隆下来运行，源码里面注释很清晰，然后结合下面的几篇文章看，就可以很快理解了。

## 运行项目 ##

1.  新建一个数据库或在已存在的数据库中，执行项目中 resource/sql 下面的SQL语句，先执行 `Quartz官方建表.sql`，再执行 `自定义任务和任务日志表.sql`。
2.  将项目中 `application.yml` 中的 `datasource.password` 、 `datasource.url`、`datasource.username` 改为对应你自己的。
3.  可以在 `application.yml` 中配置登录帐号、密码，不配置则默认均为：admin，RSA的公钥、私钥也可在此配置。
4.  运行项目，项目启动后，在浏览器输入：[http://localhost:8080/login.html][http_localhost_8080_login.html] 即可进入登录页面。
5.  此时是一个任务都没有的，项目的 src\\main\\java\\com\\leigq\\quartz\\task 目录下有一个任务示例，你可以把他添加进去看看效果。
6.  怎么集成到已存在的系统中？？目前有两种方法：
    
    1.  把项目源码拉下来，将核心实现类，复制到已存在的系统中，根据自己的项目改改，就能用了。
    2.  按照上面说的步骤，将此项目作为一个单独的系统进行部署，将执行任务所需的Mapper，Service从已有系统复制进此项目，然后就可以编写任务相关代码了。这样做的好处是：当主系统停止运行，也不影响任务系统的运行。
    3.  如果你的项目是用的SpringCloud，那你可以自己把此项目改成Cloud版本，执行任务就得去用 Feign 调用其他服务的接口了。
    4.  后面会考虑将此项目做成一个Starter。。。

## 其它资料 ##

### 入门教程 ###

*  [Quartz 入门详解][Quartz]
 *  [Quartz使用总结][Quartz 1]

### 参考 ###

*  [Spring Boot集成持久化Quartz定时任务管理和界面展示][Spring Boot_Quartz]
 *  [guns-lite][]

### 源码 ###

*  码云：[https://gitee.com/leiguoqing/springboot-quartz-lite][_Fork me on Gitee_]
 *  Github：[https://github.com/MRLEILOVE/springboot-quartz-lite.git][https_github.com_MRLEILOVE_springboot-quartz-lite.git]

### 其它 ###

*  [Quartz集群原理及配置应用][Quartz 2]

[Fork me on Gitee]: /images/20220130/ddb2cbc1d763444e95431d01628c25f6.png
[_Fork me on Gitee_]: https://gitee.com/leiguoqing/springboot-quartz-lite
[springboot-version]: https://img.shields.io/badge/SpringBoot-2.0.8.RELEASE-orange
[_springboot-version_]: https://spring.io/projects/spring-boot
[Quartz-version]: https://img.shields.io/badge/Quartz-2.3.0-blue
[_Quartz-version_]: http://www.quartz-scheduler.org/
[druid-spring-boot]: https://img.shields.io/badge/Druid-1.1.10-green
[_druid-spring-boot_]: http://druid.apache.org/
[mybatis-plus-version]: https://img.shields.io/badge/MybatisPlus-3.2.0-lightgrey?link=http://left&link=http://right
[_mybatis-plus-version_]: https://mp.baomidou.com/
[apache]: https://img.shields.io/badge/license-Apache2-red?link=http://left&link=http://right
[_apache_]: https://www.apache.org/licenses/LICENSE-2.0
[format_png]: /images/20220130/6634e3d016dd47c9b9bd84b22c8e309f.png
[format_png 1]: /images/20220130/c61623321c744cedb5e4c4aa74158355.png
[format_png 2]: /images/20220130/c81bc9a472104451aa29f4e10f7a3e9b.png
[format_png 3]: /images/20220130/ec393de1122144eab288a08b2e2f1270.png
[format_png 4]: /images/20220130/771818f5329243e596b2f19fa14e49dc.png
[http_localhost_8080_login.html]: http://localhost:8080/login.html
[Quartz]: http://www.importnew.com/22890.html
[Quartz 1]: https://www.cnblogs.com/drift-ice/p/3817269.html
[Spring Boot_Quartz]: https://www.cnblogs.com/dekevin/p/8716596.html
[guns-lite]: https://gitee.com/enilu/guns-lite
[https_github.com_MRLEILOVE_springboot-quartz-lite.git]: https://github.com/MRLEILOVE/springboot-quartz-lite.git
[Quartz 2]: https://www.cnblogs.com/zhenyuyaodidiao/p/4755649.html