Galosys.Foundation.AspNetCore.Quartz 26.5.20.1

Galosys.Foundation.AspNetCore.Quartz

成熟度: 🟡 可用 — 功能完整，测试或文档可能不完善

简介

Galosys.Foundation.AspNetCore.Quartz 是 ASP.NET Core 集成的 Quartz 定时任务调度模块，提供 RESTful API 接口来管理定时任务的生命周期，支持动态暂停、恢复、触发和调度更新。

功能特性

• 任务管理 API - 通过 HTTP 接口管理定时任务
• 暂停/恢复 - 动态暂停和恢复任务执行
• 立即触发 - 手动触发任务执行一次
• 调度更新 - 动态修改 Cron 表达式
• 任务删除 - 移除不需要的任务
• 任务列表 - 查询所有已注册的任务

安装

<PackageReference Include="Galosys.Foundation.AspNetCore.Quartz" Version="x.x.x" />

使用

注册服务

// Program.cs
services.AddQuartz(); // 注册 Quartz 调度服务

创建定时任务

using Quartz;

public class DataSyncJob : QuartzJob
{
 public DataSyncJob(ILoggerFactory loggerFactory) : base(loggerFactory) { }

 protected override async Task ExecuteAsync(IJobExecutionContext context)
 {
 // 同步数据逻辑
 await Task.Delay(1000);
 }
}

配置任务（appsettings.json）

{
 "Job": {
 "Configs": [
 {
 "Id": "1",
 "Type": "DataSyncJob",
 "Assembly": "MyApp.Jobs",
 "Name": "数据同步任务",
 "Cron": "0 0/5 * * * ?"
 }
 ]
 }
}

REST API 接口

模块自动注册 QuartzService 控制器，提供以下接口：

暂停任务

POST /api/quartz/pause
Content-Type: application/json

{
 "jobName": "MyApp.Jobs.DataSyncJob"
}

恢复任务

POST /api/quartz/resume
Content-Type: application/json

{
 "jobName": "MyApp.Jobs.DataSyncJob"
}

立即触发

POST /api/quartz/runonce
Content-Type: application/json

{
 "jobName": "MyApp.Jobs.DataSyncJob"
}

更新调度

POST /api/quartz/reschedule
Content-Type: application/json

{
 "jobName": "MyApp.Jobs.DataSyncJob",
 "cron": "0 0/10 * * * ?"
}

核心类

依赖项目

• Galosys.Foundation.AspNetCore
• Galosys.Foundation.AspNetCore.DynamicApi
• Galosys.Foundation.Quartz

目录结构

Galosys.Foundation.AspNetCore.Quartz/
├── Base/
│ └── Application/
│ └── QuartzService.cs # REST API 控制器
├── Galosys.Foundation.AspNetCore.Quartz.csproj
└── README.md

注意事项

• 任务名称格式为 {Assembly}.{TypeName}
• Cron 表达式遵循 Quartz 标准格式
• API 接口默认允许匿名访问
• 任务执行日志通过 ILogger 记录