隐藏

C#使用Quartz 实现定时任务

发布:2022/8/19 9:58:24作者:管理员 来源:本站 浏览次数:959

Quartz.net 简介

Quartz.net是一个强大、开源、轻量的作业调度框架,可以定时执行一个作业。


Quartz的基本组成部分

调度器:Scheduler

任务:JobDetail

触发器:Trigger,包括SimpleTrigger和CronTrigger

给计划者一个工作,让它在什么时间下执行这个工作。


任务的实现

将要定时执行的任务代码写到Ijob接口实现的Excute方法中,时间到后会自动执行这个任务。


Demo搭建

1.新建控制台应用程序,nuget添加对Quartz.net 的引用。

2.新建类,继承Ijo接口,实现Execute方法,里面的内容就是你要执行的任务。


public class SendMessageJob : IJob {

       /// <summary>

       /// 创建要执行的作业

       /// </summary>

       /// <param name="context"></param>

       /// <returns></returns>

       public async Task Execute(IJobExecutionContext context) {

          await Task.Run(()=> {

             

               Console.WriteLine("你好啊!");

           });

       }

   }


3、创建Schedule,执行任务


   public class ScheduleManage {

     

       public static void Show() {

           //创建调度单元

           Task<IScheduler> tsk = StdSchedulerFactory.GetDefaultScheduler();

           IScheduler scheduler = tsk.Result;

           //2.创建一个具体的作业即job (具体的job需要单独在一个文件中执行)

           IJobDetail job = JobBuilder.Create<SendMessageJob>().WithIdentity("完成").Build();

           //3.创建并配置一个触发器即trigger   1s执行一次

           ITrigger _CronTrigger = TriggerBuilder.Create()

             .WithIdentity("定时确认")

             .WithCronSchedule("0/2 * * * * ?") //秒 分 时 某一天 月 周 年(可选参数)

             .Build()

             as ITrigger;

       

           //4.将job和trigger加入到作业调度池中

           scheduler.ScheduleJob(job, _CronTrigger);

           //5.开启调度

           scheduler.Start();

           Console.ReadLine();

       }

   }


4.调用结果



Cron表达式

1.结构

corn从左到右(用空格隔开):秒 分 小时 月份中的日期 月份 星期中的日期 年份


2.注意事项:


每一个域都使用数字,但还可以出现如下特殊字符,它们的含义是:


(1):表示匹配该域的任意值。假如在Minutes域使用, 即表示每分钟都会触发事件。


(2)?:只能用在DayofMonth和DayofWeek两个域。它也匹配域的任意值,但实际不会。因为DayofMonth和DayofWeek会相互影响。例如想在每月的20日触发调度,不管20日到底是星期几,则只能使用如下写法: 13 13 15 20 * ?, 其中最后一位只能用?,而不能使用*,如果使用*表示不管星期几都会触发,实际上并不是这样。


(3)-:表示范围。例如在Minutes域使用5-20,表示从5分到20分钟每分钟触发一次


(4)/:表示起始时间开始触发,然后每隔固定时间触发一次。例如在Minutes域使用5/20,则意味着5分钟触发一次,而25,45等分别触发一次.


(5),:表示列出枚举值。例如:在Minutes域使用5,20,则意味着在5和20分每分钟触发一次。


(6)L:表示最后,只能出现在DayofWeek和DayofMonth域。如果在DayofWeek域使用5L,意味着在最后的一个星期四触发。


(7)W:表示有效工作日(周一到周五),只能出现在DayofMonth域,系统将在离指定日期的最近的有效工作日触发事件。例如:在 DayofMonth使用5W,如果5日是星期六,则将在最近的工作日:星期五,即4日触发。如果5日是星期天,则在6日(周一)触发;如果5日在星期一到星期五中的一天,则就在5日触发。另外一点,W的最近寻找不会跨过月份 。


(8)LW:这两个字符可以连用,表示在某个月最后一个工作日,即最后一个星期五。


(9)#:用于确定每个月第几个星期几,只能出现在DayofMonth域。例如在4#2,表示某月的第二个星期三。


三、常用表达式例子


(1)0 0 2 1 * ? * 表示在每月的1日的凌晨2点调整任务


(2)0 15 10 ? * MON-FRI 表示周一到周五每天上午10:15执行作业


(3)0 15 10 ? 6L 2002-2006 表示2002-2006年的每个月的最后一个星期五上午10:15执行作


(4)0 0 10,14,16 * * ? 每天上午10点,下午2点,4点


(5)0 0/30 9-17 * * ? 朝九晚五工作时间内每半小时


(6)0 0 12 ? * WED 表示每个星期三中午12点


(7)0 0 12 * * ? 每天中午12点触发


(8)0 15 10 ? * * 每天上午10:15触发


(9)0 15 10 * * ? 每天上午10:15触发


(10)0 15 10 * * ? * 每天上午10:15触发


(11)0 15 10 * * ? 2005 2005年的每天上午10:15触发


(12)0 * 14 * * ? 在每天下午2点到下午2:59期间的每1分钟触发


(13)0 0/5 14 * * ? 在每天下午2点到下午2:55期间的每5分钟触发


(14)0 0/5 14,18 * * ? 在每天下午2点到2:55期间和下午6点到6:55期间的每5分钟触发


(15)0 0-5 14 * * ? 在每天下午2点到下午2:05期间的每1分钟触发


(16)0 10,44 14 ? 3 WED 每年三月的星期三的下午2:10和2:44触发


(17)0 15 10 ? * MON-FRI 周一至周五的上午10:15触发


(18)0 15 10 15 * ? 每月15日上午10:15触发


(19)0 15 10 L * ? 每月最后一日的上午10:15触发


(20)0 15 10 ? * 6L 每月的最后一个星期五上午10:15触发


(21)0 15 10 ? * 6L 2002-2005 2002年至2005年的每月的最后一个星期五上午10:15触发


(22)0 15 10 ? * 6#3 每月的第三个星期五上午10:15触发