主题
定时任务
INF-JOB-01 | 模块
infra| 在界面上维护 Cron 表达式与执行类,不必改配置重启。
1. 使用角色与场景
角色:管理员、开发者
- 每天凌晨清理临时文件
- 每 5 分钟同步一次外部数据
2. 接口与权限点
| 方法 | 路径 | 权限点 | 摘要 | 代码行 |
|---|---|---|---|---|
| POST | /infra/job/create | infra:job:create | 创建定时任务 | JobController#L44 |
| PUT | /infra/job/update | infra:job:update | 更新定时任务 | JobController#L52 |
| PUT | /infra/job/update-status | infra:job:update | 更新定时任务的状态 | JobController#L61 |
| DELETE | /infra/job/delete | infra:job:delete | 删除定时任务 | JobController#L74 |
| DELETE | /infra/job/delete-list | infra:job:delete | 批量删除定时任务 | JobController#L84 |
| PUT | /infra/job/trigger | infra:job:trigger | 触发定时任务 | JobController#L94 |
| POST | /infra/job/sync | infra:job:create | 同步定时任务 | JobController#L103 |
| GET | /infra/job/get | infra:job:query | 获得定时任务 | JobController#L111 |
| GET | /infra/job/page | infra:job:query | 获得定时任务分页 | JobController#L120 |
| GET | /infra/job/export-excel | infra:job:export | 导出定时任务 Excel | JobController#L128 |
| GET | /infra/job/get_next_times | infra:job:query | 获得定时任务的下 n 次执行时间 | JobController#L141 |
3. 代码定位
| 层 | 位置 |
|---|---|
| Controller | modules/infra/src/main/java/com/pmforge/module/infra/controller/admin/job/JobController.java#L44 |
| DO | modules/infra/src/main/java/com/pmforge/module/infra/dal/dataobject/job/JobDO.java |
4. 数据表
| 表 | DO |
|---|---|
infra_job | JobDO |
5. 机制与配置
- Quartz 调度,JobHandler 由 Spring 容器按 beanName 取用
- 支持暂停/恢复/立即执行一次
6. 常见问题与排查
- 集群部署要配 Quartz 集群模式,否则任务会重复执行
- Cron 表达式不合法时保存即报错
7. 关联
- 需求原件:02-03-定时任务
- 相关卡片:INF-JOB-02