Skip to content

二、配置与任务 ​

菜单入口:基础设施 → 配置管理 / 数据源配置 / 定时任务。

本章介绍系统运行参数、多数据源与定时任务的配置管理,属于系统上线与运维阶段的高频操作入口。

2.1 配置管理 ​

菜单入口:基础设施 → 配置管理。

管理系统运行所需的键值对参数(如用户初始密码等),业务代码按"参数键名"读取"参数键值"。

页面操作:

  • 查询:支持按参数名称、参数键名、系统内置、创建时间筛选。
  • 新增:填写参数名称、参数分类、参数键名、参数键值、是否可见、系统内置(新增的参数均为自定义类型)、备注。
  • 编辑:修改参数键值等,保存后新值即时生效,无需重启服务。
  • 删除 / 批量删除:移除自定义参数;系统内置的参数不允许删除(后端强制拦截)。
  • 导出:将当前查询结果导出为 Excel。

业务规则:

规则项说明
参数键名唯一新增/编辑时校验键名不能与已有参数重复
系统内置系统预置参数标记为内置,不可删除,仅可修改键值
是否可见控制该参数是否允许前端读取;敏感参数(如密码类)应设为不可见

数据变动:参数写入 infra_config 表;修改保存后即时生效,业务读取参数时获取最新键值。

2.2 数据源配置 ​

菜单入口:基础设施 → 数据源配置。

配置除主库之外的额外数据库连接(如报表库、历史库),供代码生成器导入表、业务代码多数据源切换使用。

页面操作:

  • 查询:列表展示主键编号、数据源名称、数据源连接、用户名、创建时间。
  • 新增:填写数据源名称、数据源连接(JDBC URL)、用户名、密码。
  • 编辑:修改连接信息(如库地址迁移、账号变更)。
  • 删除 / 批量删除:移除不再使用的数据源配置,删除前请确认无业务引用。

业务规则:

  • 配置好的数据源会出现在代码生成器"导入"的数据源下拉中,可直接从其他库选表生成代码。
  • 业务代码中通过 @DS("数据源名称") 注解切换到对应数据源访问。
  • 数据源连接串包含账号等敏感信息,请控制本页面的操作权限。

数据源配置

数据变动:数据源配置写入 infra 模块表;新增/修改后立即对代码生成器的数据源下拉生效。

2.3 定时任务 ​

菜单入口:基础设施 → 定时任务。

定时任务的统一管理入口:新建任务、调整调度周期、手动触发、查看每次执行结果。

页面操作:

  • 查询:支持按任务名称、任务状态、处理器的名字筛选。
  • 新增:填写任务名称、处理器的名字(Spring Bean 名)、处理器的参数、CRON 表达式、初始任务状态。
  • 修改:调整任务参数、CRON 表达式等。
  • 开启 / 暂停:行内按钮,按当前状态切换,暂停后不再调度。
  • 删除 / 批量删除:移除任务定义。
  • 导出:导出任务清单 Excel。
  • 执行日志:进入日志页查看每次执行的时间、耗时、结果与报错信息。
  • 执行一次(行内"更多"菜单):忽略 CRON 立即手动触发一次,用于验证处理器是否正常。
  • 任务详细 / 调度日志(行内"更多"菜单):查看单条任务详情与对应调度日志。

业务规则:

规则项说明
处理器的名字必须是对应任务处理器的 Spring Bean 名,写错任务将无法执行
处理器的参数传给处理器的业务参数(可为空)
CRON 表达式控制执行周期,如 0 0/5 * * * ? 每 5 分钟一次
任务状态开启状态才参与调度,暂停状态不触发
排查路径任务未按预期执行时,先看状态与 CRON,再到执行日志看报错详情

⚠️ Cloud 版本说明:PointLion Cloud 版本的定时任务调度同时提供 XXL-Job 调度中心方案;若本页面接口返回"Cloud 版本使用 XXL-Job"提示,请按提示以 XXL-Job 调度中心(参考部署文档)管理任务。

定时任务

数据变动:任务定义与调度记录写入 infra 模块表;执行一次/周期执行均产生执行日志,供事后审计与排障。

📖 相关文档 ​