Quartz.NET作為一個(gè)開(kāi)源的作業(yè)調(diào)度庫(kù)，廣泛應(yīng)用于.NET應(yīng)用程序中，以實(shí)現(xiàn)復(fù)雜的定時(shí)任務(wù)，本次記錄利用Quartz.NET實(shí)現(xiàn)HTTP作業(yè)調(diào)度，通過(guò)自定義HTTP作業(yè)，實(shí)現(xiàn)對(duì)外部API的定時(shí)調(diào)用和如何管理這些作業(yè)，包括創(chuàng)建、修改、暫停、恢復(fù)和刪除作業(yè)。

public class HttpJob : IJob
{
    public static readonly Dictionary<string, HttpJobInfo> Delegates = new();


    public async Task Execute(IJobExecutionContext context)
    {
        var delegateKey = context.JobDetail.JobDataMap.GetString("delegateKey");
        if (delegateKey != null && Delegates.TryGetValue(delegateKey, out var func))
        {
            var requestBody = new RestRequest();
            if (func.Headers != null)
            {
                foreach (var header in func.Headers)
                {
                    requestBody.AddHeader(header.Key, header.Value);
                }
            }


            var content = HttpHelper.HttpRequest(func.Url, func.Request, requestBody);
            JobLogHelper.AddJobLog(new JobLog() { JobName = context.JobDetail.Key.Name, GroupName = context.JobDetail.Key.Group, RunTime = DateTime.Now, RunResult = content });
            UpdateLastExecutionTime(context.JobDetail.Key.Name, context.JobDetail.Key.Group, DateTime.Now);
        }
        await Task.CompletedTask;
    }
}

2.作業(yè)信息的持久化：為了持久化作業(yè)信息，定義了JobInfo類(lèi)來(lái)存儲(chǔ)作業(yè)的基本信息，如名稱(chēng)、組名、Cron表達(dá)式等，并將這些信息保存在本地的JSON文件中。

public class JobInfo
{
    public required string JobName { get; set; }
    public required string GroupName { get; set; }
    public required string CronExpression { get; set; }
    public DateTime LastExecutionTime { get; set; }
    public JobStatus Status { get; set; }
    public required HttpJobInfo HttpJob { get; set; }
}

3.實(shí)現(xiàn)了QuartzHelper類(lèi)，用于管理作業(yè)的生命周期。這包括加載作業(yè)信息、創(chuàng)建作業(yè)、調(diào)度作業(yè)、暫停/恢復(fù)作業(yè)以及刪除作業(yè)等功能。

public class QuartzHelper
 {
     private IScheduler scheduler;
     private List<JobInfo> jobInfos;


     private string filePath = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "jobs.json");


     /// <summary>
     /// 構(gòu)造函數(shù)，初始化定時(shí)任務(wù)管理器
     /// </summary>
     public QuartzHelper()
     {
         ISchedulerFactory schedulerFactory = new StdSchedulerFactory();
         scheduler = schedulerFactory.GetScheduler().Result;
         scheduler.Start().Wait();
         LoadJobInfosApi().Wait();


     }
     /// <summary>
     /// 保存作業(yè)信息到本地 JSON 文件
     /// </summary>
     private void SaveJobInfos()
     {
         string json = JsonConvert.SerializeObject(jobInfos);
         File.WriteAllText(filePath, json);
     }


     /// <summary>
     /// 加載本地 JSON 文件中的作業(yè)信息
     /// </summary>
     private async Task LoadJobInfosApi()
     {
         if (File.Exists(filePath))
         {
             string json = File.ReadAllText(filePath);
             jobInfos = JsonConvert.DeserializeObject<List<JobInfo>>(json) ?? new List<JobInfo>();
             foreach (var jobInfo in jobInfos)
             {
                
                 // 創(chuàng)建委托的唯一鍵
                 var delegateKey = Guid.NewGuid().ToString();
                 // 將委托存儲(chǔ)在靜態(tài)字典中
                 HttpJob.Delegates[delegateKey] = jobInfo.HttpJob;


                 // 創(chuàng)建并調(diào)度作業(yè)
                 IJobDetail job = JobBuilder.Create<HttpJob>()
                     .WithIdentity(jobInfo.JobName, jobInfo.GroupName).UsingJobData("delegateKey", delegateKey) // 將委托的鍵添加到JobDataMap
                     .Build();


                 ITrigger trigger = TriggerBuilder.Create()
                     .WithIdentity(jobInfo.JobName, jobInfo.GroupName)
                     .WithCronSchedule(jobInfo.CronExpression)
                     //.StartNow()
                     .Build();


                 await scheduler.ScheduleJob(job, trigger);


                 // 根據(jù)任務(wù)狀態(tài)恢復(fù)或暫停任務(wù)
                 if (jobInfo.Status == JobStatus.正常運(yùn)行)
                 {
                     await ResumeJob(jobInfo.JobName, jobInfo.GroupName);
                 }
                 else
                 {
                     await PauseJob(jobInfo.JobName, jobInfo.GroupName);
                 }
             }
         }
         else
         {
             jobInfos = new List<JobInfo>();
         }
     }






     #region 執(zhí)行普通任務(wù)時(shí)使用，傳委托時(shí)可以參考此方法
     ///// <summary>
     ///// 新建任務(wù)并立即執(zhí)行
     ///// </summary>
     //[Obsolete("執(zhí)行普通任務(wù)時(shí)使用，可以傳委托使用")]
     //public async Task AddJob(string jobName, string groupName, string cronExpression, Func<bool> func, string description = "")
     //{
     //    if (jobInfos.Any(c => c.JobName == jobName && c.GroupName == groupName))
     //    {
     //        return;
     //    }


     //    // 創(chuàng)建委托的唯一鍵
     //    var delegateKey = Guid.NewGuid().ToString();
     //    // 將委托存儲(chǔ)在靜態(tài)字典中
     //   // MyJobClass.Delegates[delegateKey] = func;


     //    // 創(chuàng)建作業(yè)信息并保存到列表  需要將func 加入到j(luò)obInfo 中做作業(yè)持久化!!!!
     //    var jobInfo = new JobInfo { JobName = jobName, GroupName = groupName, CronExpression = cronExpression, Status = JobStatus.正常運(yùn)行, Description = description, JobCreateTime = DateTime.Now };
     //    jobInfos.Add(jobInfo);
     //    SaveJobInfos();


     //    // 創(chuàng)建Quartz作業(yè)和觸發(fā)器
     //    IJobDetail job = JobBuilder.Create<MyJobClass>()
     //        .WithIdentity(jobName, groupName)
     //        .UsingJobData("delegateKey", delegateKey) // 將委托的鍵添加到JobDataMap
     //        .Build();


     //    ITrigger trigger = TriggerBuilder.Create()
     //        .WithIdentity(jobName + "Trigger", groupName)
     //        .StartNow()
     //        .WithCronSchedule(cronExpression).WithDescription(description)
     //        .Build();


     //    await scheduler.ScheduleJob(job, trigger);


     //}


     #endregion


     /// <summary>
     /// 新建任務(wù)并立即執(zhí)行
     /// </summary>       
   
     public async Task AddJobApi(string jobName, string groupName, string cronExpression, HttpJobInfo httpJobInfo, string description = "")
     {
         if (jobInfos.Any(c => c.JobName == jobName && c.GroupName == groupName))
         {
             return;
         }


         // 創(chuàng)建委托的唯一鍵
         var delegateKey = Guid.NewGuid().ToString();
         // 將委托存儲(chǔ)在靜態(tài)字典中
         HttpJob.Delegates[delegateKey] = httpJobInfo;


         // 創(chuàng)建作業(yè)信息并保存到列表  需要將func 加入到j(luò)obInfo 中做作業(yè)持久化!!!!
         var jobInfo = new JobInfo { JobName = jobName, GroupName = groupName, CronExpression = cronExpression, HttpJob = httpJobInfo, Status = JobStatus.正常運(yùn)行, Description = description, JobCreateTime = DateTime.Now };
         jobInfos.Add(jobInfo);
         SaveJobInfos();


         // 創(chuàng)建Quartz作業(yè)和觸發(fā)器
         IJobDetail job = JobBuilder.Create<HttpJob>()
             .WithIdentity(jobName, groupName)
             .UsingJobData("delegateKey", delegateKey) // 將委托的鍵添加到JobDataMap
             .Build();


         ITrigger trigger = TriggerBuilder.Create()
             .WithIdentity(jobName + "Trigger", groupName)
             .StartNow()
             .WithCronSchedule(cronExpression).WithDescription(description)
             .Build();


         await scheduler.ScheduleJob(job, trigger);


     }




     /// <summary>
     /// 暫停任務(wù)
     /// </summary>
     public async Task PauseJob(string jobName, string groupName)
     {
         await scheduler.PauseJob(new JobKey(jobName, groupName));
         var job = jobInfos.FirstOrDefault(j => j.JobName == jobName && j.GroupName == groupName);
         if (job != null)
         {
             job.Status = JobStatus.暫停;
             SaveJobInfos();
         }
     }


     /// <summary>
     /// 開(kāi)啟任務(wù)
     /// </summary>
     public async Task ResumeJob(string jobName, string groupName)
     {
         await scheduler.ResumeJob(new JobKey(jobName, groupName));
         var job = jobInfos.FirstOrDefault(j => j.JobName == jobName && j.GroupName == groupName);
         if (job != null)
         {
             job.Status = JobStatus.正常運(yùn)行;
             SaveJobInfos();
         }
     }


     /// <summary>
     /// 立即執(zhí)行任務(wù)
     /// </summary>
     public async Task TriggerJob(string jobName, string groupName)
     {
         await scheduler.TriggerJob(new JobKey(jobName, groupName));
         var job = jobInfos.FirstOrDefault(j => j.JobName == jobName && j.GroupName == groupName);
         if (job != null)
         {
             job.LastExecutionTime = DateTime.Now;
             SaveJobInfos();
         }
     }




     /// <summary>
     /// 修改任務(wù)
     /// </summary>
     public async Task ModifyJob(string jobName, string groupName, string cronExpression, HttpJobInfo httpJobInfo, string description = "")
     {
         await DeleteJob(jobName, groupName);
         await AddJobApi(jobName, groupName, cronExpression, httpJobInfo, description);
     }
     /// <summary>
     /// 刪除任務(wù)
     /// </summary>
     public async Task DeleteJob(string jobName, string groupName)
     {
         await scheduler.DeleteJob(new JobKey(jobName, groupName));
         jobInfos.RemoveAll(j => j.JobName == jobName && j.GroupName == groupName);
         SaveJobInfos();
     }


     /// <summary>
     /// 獲取當(dāng)前所有任務(wù)列表
     /// </summary>
     public List<JobInfo> GetAllJobs()
     {
         if (File.Exists(filePath))
         {
             string json = File.ReadAllText(filePath);
             jobInfos = JsonConvert.DeserializeObject<List<JobInfo>>(json) ?? new List<JobInfo>();
             return jobInfos;
         }
         else
             return null;
         
     }




 }


QuartzHelper

4.為了跟蹤作業(yè)的執(zhí)行情況，設(shè)計(jì)了JobLog類(lèi)和JobLogHelper類(lèi)，用于記錄和查詢(xún)作業(yè)執(zhí)行日志。

public class JobLogHelper
{
    private static string _filePath;


    /// <summary>
    /// 根據(jù)作業(yè)名稱(chēng)和組名稱(chēng)獲取當(dāng)日的作業(yè)執(zhí)行日志
    /// </summary>
    /// <param name="jobName"></param>
    /// <param name="groupName"></param>
    /// <returns></returns>
    public static List<JobLog> GetJobLog(string jobName, string groupName)
    {
        _filePath = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, $"jobsLog-{DateTime.Now:yyyyMMdd}.json");


        // 檢查文件是否存在
        if (!File.Exists(_filePath))
        {
            return new List<JobLog>();
        }
        var jsonText = $"[{File.ReadAllText(_filePath)}]";
        var list = JsonConvert.DeserializeObject<List<JobLog>>(jsonText);
        if (list != null)
        {
            var result = list.Where(c => c.JobName == jobName && groupName == c.GroupName).OrderByDescending(c => c.RunTime).ToList();
            return result;
        }


        return null;
    }
    /// <summary>
    ///獲取所有的 作業(yè)執(zhí)行日志  //可以從這里拓展其他查詢(xún)條件
    /// </summary>
    /// <returns></returns>
    public static List<JobLog> GetAllLogs()
    {
        List<JobLog> jobLogs = new List<JobLog>();
        var logFilePaths = Directory.GetFiles(AppDomain.CurrentDomain.BaseDirectory, "jobsLog-*.json");
        logFilePaths.ToList().ForEach(c =>
        {
            var jsonText = $"[{File.ReadAllText(_filePath)}]";
            var list = JsonConvert.DeserializeObject<List<JobLog>>(jsonText);
            if (list != null) jobLogs.AddRange(list);
        });
        return jobLogs;
    }
    /// <summary>
    /// 添加作業(yè)執(zhí)行日志
    /// </summary>
    /// <param name="jobLog"></param>
    public static void AddJobLog(JobLog jobLog)
    {
        _filePath = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, $"jobsLog-{DateTime.Now:yyyyMMdd}.json");
        string json = JsonConvert.SerializeObject(jobLog) + ",\n";
        File.AppendAllText(_filePath, json);
    }
}


作業(yè)執(zhí)行日志

5.最后，通過(guò)ASP.NET Core的Controller提供了一系列Web API接口，以便于通過(guò)HTTP請(qǐng)求管理作業(yè)。這些接口包括獲取作業(yè)列表、添加作業(yè)、修改作業(yè)、刪除作業(yè)、暫停作業(yè)、恢復(fù)作業(yè)和立即執(zhí)行作業(yè)等。

[Route("api/[controller]")]
 [ApiController]
 public class QuartzController : ControllerBase
 {
     private readonly QuartzHelper _quartzHelper;
     public QuartzController(QuartzHelper quartzHelper)
     {
         _quartzHelper = quartzHelper;
     }


     [HttpGet]
     [Route("job/GetJobs")]
     public object GetJobs()
     {
         return Ok(new {code=200,data = _quartzHelper.GetAllJobs() });
     }


     [HttpGet]
     [Route("job/GetJobLog")]
     public object GetJobLog(string jobName, string groupName)
     {
         return Ok(new { code = 200, data = JobLogHelper.GetJobLog(jobName, groupName) });         
     }
     [HttpGet]
     [Route("job/GetJobLogs")]
     public object GetJobLogs()
     {
         return Ok(new { code = 200, data = JobLogHelper.GetAllLogs() });
     }




     [HttpPost]
     [Route("job/AddJob")]
     public async Task<object> Add(JobInfo jobInfo)
     {
         try
         {
             await _quartzHelper.AddJobApi(jobInfo.JobName, jobInfo.GroupName, jobInfo.CronExpression, jobInfo.HttpJob, jobInfo.Description);
             return Ok(new { code = 200, msg = "創(chuàng)建成功！" });
         }
         catch (Exception ex)
         {
             return Ok(new { code = 500, msg = ex.Message });
         }
     }


     [HttpPost]
     [Route("job/ModifyJob")]
     public async Task<object> Edit(JobInfo jobInfo)
     {
         try
         {
             await _quartzHelper.ModifyJob(jobInfo.JobName, jobInfo.GroupName, jobInfo.CronExpression, jobInfo.HttpJob, jobInfo.Description);
             return Ok(new { code = 200, msg = "修改成功！" });
         }
         catch (Exception ex)
         {
             return Ok(new { code = 500, msg = ex.Message });
         }
     }


     [HttpGet]
     [Route("job/DeleteJob")]
     public async Task<object> Delete(string jobName, string groupName)
     {
         try
         {
             await _quartzHelper.DeleteJob(jobName, groupName);
             return Ok(new { code = 200, msg = "刪除成功！" });
         }
         catch (Exception ex)
         {
             return Ok(new { code = 500, msg = ex.Message });
         }
     }


     [HttpGet]
     [Route("job/PauseJob")]
     public async Task<object> PauseJob(string jobName, string groupName)
     {
         try
         {
             await _quartzHelper.PauseJob(jobName, groupName);
             return Ok(new { code = 200, msg = "暫停成功！" });
         }
         catch (Exception ex)
         {
             return Ok(new { code = 500, msg = ex.Message });
         }
     }


     [HttpGet]
     [Route("job/ResumeJob")]
     public async Task<object> ResumeJob(string jobName, string groupName)
     {
         try
         {
             await _quartzHelper.ResumeJob(jobName, groupName);
             return Ok(new { code = 200, msg = "開(kāi)啟任務(wù)成功！" });
         }
         catch (Exception ex)
         {
             return Ok(new { code = 500, msg = ex.Message });
         }
     }
     [HttpGet]
     [Route("job/TriggerJob")]
     public async Task<object> TriggerJob(string jobName, string groupName)
     {
         try
         {
             await _quartzHelper.TriggerJob(jobName, groupName);
             return Ok(new { code = 200, msg = "立即執(zhí)行任務(wù)命令已執(zhí)行！" });
         }
         catch (Exception ex)
         {
             return Ok(new { code = 500, msg = ex.Message });
         }
     }
 }


Web API接口

源碼地址：https://github.com/yycb1994/Quartz.Net

轉(zhuǎn)自：https://www.cnblogs.com/INetIMVC/p/18281699