Skip to content

定时任务 ​

INF-JOB-01 | 模块 infra | 在界面上维护 Cron 表达式与执行类,不必改配置重启。

1. 使用角色与场景 ​

角色:管理员、开发者

  • 每天凌晨清理临时文件
  • 每 5 分钟同步一次外部数据

2. 接口与权限点 ​

方法路径权限点摘要代码行
POST/infra/job/createinfra:job:create创建定时任务JobController#L44
PUT/infra/job/updateinfra:job:update更新定时任务JobController#L52
PUT/infra/job/update-statusinfra:job:update更新定时任务的状态JobController#L61
DELETE/infra/job/deleteinfra:job:delete删除定时任务JobController#L74
DELETE/infra/job/delete-listinfra:job:delete批量删除定时任务JobController#L84
PUT/infra/job/triggerinfra:job:trigger触发定时任务JobController#L94
POST/infra/job/syncinfra:job:create同步定时任务JobController#L103
GET/infra/job/getinfra:job:query获得定时任务JobController#L111
GET/infra/job/pageinfra:job:query获得定时任务分页JobController#L120
GET/infra/job/export-excelinfra:job:export导出定时任务 ExcelJobController#L128
GET/infra/job/get_next_timesinfra:job:query获得定时任务的下 n 次执行时间JobController#L141

3. 代码定位 ​

层位置
Controllermodules/infra/src/main/java/com/pmforge/module/infra/controller/admin/job/JobController.java#L44
DOmodules/infra/src/main/java/com/pmforge/module/infra/dal/dataobject/job/JobDO.java

4. 数据表 ​

表DO
infra_jobJobDO

5. 机制与配置 ​

  • Quartz 调度,JobHandler 由 Spring 容器按 beanName 取用
  • 支持暂停/恢复/立即执行一次

6. 常见问题与排查 ​

  • 集群部署要配 Quartz 集群模式,否则任务会重复执行
  • Cron 表达式不合法时保存即报错

7. 关联 ​