C#定时任务框架Quartz.NET介绍与用法
什么是定时任务?
最近恰巧有类似的需求, 需要做一个应用程序服务, 每天定时给服务器上传采集的数据。
在没有任务框架的使用前提下, 如果我们想要实现类似的需求,可以自己写一个计时器, 然后24小时运行,达到指定的时间就运行。但是这样不仅扩展性差, 而且不易于维护。
在定时任务这块, 也有非常的多的框架支持,开箱即用, 那么下面将主要介绍一下Quartz.NET框架
Quartz.NET介绍
Quartz.NET是一个Github开源项目,用于创建一个免费商业用途的作业调度框架。
注:支持 .NET Core/.NET Standard 2.0 和 .NET 框架 4.6.1 及更晚版本。
Quartz.NET入门
在我们使用定时任务框架的之前, 首先我们需要确定的是, 它大概具备哪些内容。
- 灵活的指定某项任务
- 灵活的启动时间配置
- 传递参数并且监听
了解了这些基础概念之后, 我们便开始学习如何在Quartz.NET当中使用这些功能。
1.创建一个任务
任务是一个抽象的概念, 实际来说它应该指的是某种任务, 例如: 想要每3秒输入一个字符串, 那么我们就可以这样做。
- 下面演示创建了一个类, 它继承于IJob接口, 实现了Execute方法, 任务就是输出一个字符串。
public class TestJob : IJob { public async Task Execute(IJobExecutionContext context) { await Console.Out.WriteLineAsync($"{DateTime.Now}:Hello!"); } }
- 创建任务
//创建一个工作 IJobDetail job = JobBuilder.Create<TestJob>() .WithIdentity("TestJob", "Test") .Build();
2.配置任务的参数
为任务配置一个触发条件及相关的参数。当该配置的参数一旦达到了条件, 上面的任务将被触发。
//创建一个触发条件 ITrigger trigger = TriggerBuilder.Create() .WithIdentity("TestJobTrigger", "Test") .WithSimpleSchedule(x => { x.WithIntervalInSeconds(3).RepeatForever(); }) .Build();
3.启动任务
创建一个任务调度器, 将任务和配置参数添加到调度器当中。
StdSchedulerFactory factory = new StdSchedulerFactory(); //创建任务调度器 IScheduler scheduler = await factory.GetScheduler(); //启动任务调度器 scheduler.Start(); //将创建的任务和触发器条件添加到创建的任务调度器当中 scheduler.ScheduleJob(job, trigger);
4.实际效果
在上面的代码中,我们创建了一个任务输出一段字符串, 然后为该任务创建了一个配置, 每3秒执行一次, 那么实际效果会每间隔3秒输出:
更多配置
- 特定时间触发,重复触发,单次触发, 触发次数,开始时间, 结束时间。 这些在框架当中都有该功能
- 触发器表达式 ,例如: 每周一上午, 或每周一、周三、周五等等
下面是一些表达式及其含义的示例示例 1 - 创建每 5 分钟触发一次的触发器的表达式
"0 0/5 * * * ?"
示例 2 - 创建每 5 分钟触发一次的触发器的表达式,在分钟后 10 秒(即上午 10:00:10、上午 10:05:10 等)。
"10 0/5 * * * ?"
示例 3 - 用于创建触发器的表达式,该触发器在每个星期三和周五的 10:30、11:30、12:30 和 13:30 触发。
"0 30 10-13 ? * WED,FRI"
示例 4 - 创建触发器的表达式,在每月 5 日到 20 日上午 8 点到上午 10 点之间每半小时触发一次。请注意,触发器不会于上午 10:00 触发,只是在 8:00、8:30、9:00 和 9:30
"0 0/30 8-9 5,20 * ?"
- 监听器: 可以检测你的任务执行状态: 是否工作, 是否错误,是否已完成等
关于具体的使用方法, 在文档中有详细的介绍:
到此这篇关于C#定时任务框架Quartz.NET介绍与用法的文章就介绍到这了。希望对大家的学习有所帮助,也希望大家多多支持我们。