C# Quartz.Net 定时任务的简单使用
最近做了一个定时执行任务的软件。
执行任务时,会使用log4net记录日志,如果执行任务有异常,则发送邮件给指定的对象。
我做的是每天的9点和16点执行一次任务,以此记录:
首先,获得Quartz.Net,
其实可以使用vs2015的Nuget管理器,下载。
我做了一个QuartzHelper,但是在主程序中,还是需要其他代码的。
这是QuartzHelper的代码:
1 using Quartz;
2 using Quartz.Impl;
3
4 namespace Cong.Utility
5 {
6 public class QuartzHelper
7 {
8 /// <summary>
9 /// 时间间隔执行任务
10 /// </summary>
11 /// <typeparam name="T">任务类,必须实现IJob接口</typeparam>
12 /// <param name="seconds">时间间隔(单位:毫秒)</param>
13 public static void ExecuteInterval<T>(int seconds) where T : IJob
14 {
15 ISchedulerFactory factory = new StdSchedulerFactory();
16 IScheduler scheduler = factory.GetScheduler();
17
18 //IJobDetail job = JobBuilder.Create<T>().WithIdentity("job1", "group1").Build();
19 IJobDetail job = JobBuilder.Create<T>().Build();
20
21 ITrigger trigger = TriggerBuilder.Create()
22 .StartNow()
23 .WithSimpleSchedule(x => x.WithIntervalInSeconds(seconds).RepeatForever())
24 .Build();
25
26 scheduler.ScheduleJob(job, trigger);
27
28 scheduler.Start();
29 }
30
31 /// <summary>
32 /// 指定时间执行任务
33 /// </summary>
34 /// <typeparam name="T">任务类,必须实现IJob接口</typeparam>
35 /// <param name="cronExpression">cron表达式,即指定时间点的表达式</param>
36 public static void ExecuteByCron<T>(string cronExpression) where T : IJob
37 {
38 ISchedulerFactory factory = new StdSchedulerFactory();
39 IScheduler scheduler = factory.GetScheduler();
40
41 IJobDetail job = JobBuilder.Create<T>().Build();
42
43 //DateTimeOffset startTime = DateBuilder.NextGivenSecondDate(DateTime.Now.AddSeconds(1), 2);
44 //DateTimeOffset endTime = DateBuilder.NextGivenSecondDate(DateTime.Now.AddYears(2), 3);
45
46 ICronTrigger trigger = (ICronTrigger)TriggerBuilder.Create()
47 //.StartAt(startTime).EndAt(endTime)
48 .WithCronSchedule(cronExpression)
49 .Build();
50
51 scheduler.ScheduleJob(job, trigger);
52
53 scheduler.Start();
54
55 //Thread.Sleep(TimeSpan.FromDays(2));
56 //scheduler.Shutdown();
57 }
58 }
59
60 #region 任务执行例
61 //public class MyJob : IJob
62 //{
63 // public void Execute(IJobExecutionContext context)
64 // {
65 // Console.WriteLine("executed..." + DateTime.Now.ToString("yyyy/MM/dd HH:mm:ss"));
66 // }
67 //}
68 #endregion
69 }
大概的过程是这样的:
通过ISchedulerFactory实例化一个计划工厂对象,并使用工厂实例化一个scheduler计划对象,
然后实例化一个任务对象job,也就是定义任务内容的对象,需要传入一个实现IJob接口的类,这里我使用了泛型,
接着,需要一个能触发任务的对象,这里有两种,
一种是ITrigger,这是用于规格时间间隔,计划开始后,会根据间隔的时间值,触发执行任务;
另一种是ICronTrigger,这是通过Cron表达式规格执行的时间,计划开始后,如果时间符合规定时间,就触发执行任务。
最后,把job和trigger都传入计划scheduler,计划开始。
最下方的任务执行例是一个例子,
必须实现IJob接口和Execute方法。
如果需要在Execute方法内,调用类外部的数据,我是通过在项目中定义静态类的方法,供MyJob调用的。
程序开始计划的代码:
string cronExpression = "0 0 9,16 * * ? "; =>这是指每天的9点和16点执行任务
QuartzHelper.ExecuteByCron<MyJob>(cronExpression); =>这是调用Cron计划方法
简单说一下Cron表达式吧,
"0 0 9,16 * * ? ",
顺序从左到右
0:秒
0:分
9,16:小时,逗号分隔
如果需要更详细的说明,可以百度。