1.9 KiB
1.9 KiB
6.16 定时任务管理
:::tip 概述 任务管理页（gin_job + gin_job_log）管理 cron 任务的定义与执行：新建、启停、手动执行、执行日志。调度机制详见 5.19 定时任务调度机制。 :::
功能清单
任务（job）
| 接口 | 说明 |
|---|---|
| Page / List / Detail | 标准查询 |
| Add / Update / Delete / BatchDelete | 任务定义维护（url 字段 = 处理器注册名） |
| RunOnce | GET /api/job/runOnce/:id 立即执行一次（经执行锁防并发，权限码 sys:job:execute） |
| Pause / Resume | GET /api/job/pause/:id、resume/:id 暂停/恢复（cron 摘除/挂载） |
| Status | POST /api/job/status 设置任务状态 |
| DaemonStatus | GET /api/job/daemonStatus 调度器守护状态（登录即可，无需权限码） |
执行日志（job_log）
| 接口 | 说明 |
|---|---|
| Page / List / Detail | 执行记录查询 |
任务记录关键字段
| 字段 | 语义 |
|---|---|
| url | 处理器注册名（与 internal/task 的 RegisterJobHandler 名一致，数据驱动查找） |
| cron_expression | cron 表达式（或 @every 描述符） |
| execute_policy | 执行策略：1-立即执行 2-执行一次 3-放弃执行（字典 job_execute_policy 回填显示名） |
| is_sync | 是否同步执行：0-否 1-是（字典 job_is_sync） |
| params | 任务参数（JSON 字符串，传给处理器） |
| status | 启停状态（字典 job_status） |
url 与处理器注册名不匹配时任务无法执行——新建任务前确认处理器已注册（内置：LogClean / SendSms / HelloWorld）。
执行可靠性
执行锁（job.lockTTLSeconds，执行期自动续期）+ 任务日志（开始/结束/耗时/结果摘要）。
管理界面
monitor/job：任务列表 + 执行日志页签 + 手动执行/启停按钮。