C#中Quartz的简单易懂定时任务实现

转载地址:https://www.cnblogs.com/wendj/archive/2018/09/18/9670412.html 

作为一个优秀的开源调度框架,Quartz 具有以下特点:

  1. 强大的调度功能,例如支持丰富多样的调度方法,可以满足各种常规及特殊需求;
  2. 灵活的应用方式,例如支持任务和调度的多种组合方式,支持调度数据的多种存储方式;
  3. 分布式和集群能力,Terracotta 收购后在原来功能基础上作了进一步提升。

      另外,作为 Spring 默认的调度框架,Quartz 很容易与 Spring 集成实现灵活可配置的调度功能。

    quartz调度核心元素:

  1. Scheduler:任务调度器,是实际执行任务调度的控制器。在spring中通过SchedulerFactoryBean封装起来。
  2. Trigger:触发器,用于定义任务调度的时间规则,有SimpleTrigger,CronTrigger,DateIntervalTrigger和NthIncludedDayTrigger,其中CronTrigger用的比较多,本文主要介绍这种方式。CronTrigger在spring中封装在CronTriggerFactoryBean中。
  3. Calendar:它是一些日历特定时间点的集合。一个trigger可以包含多个Calendar,以便排除或包含某些时间点。
  4. JobDetail:用来描述Job实现类及其它相关的静态信息,如Job名字、关联监听器等信息。在spring中有JobDetailFactoryBean和 MethodInvokingJobDetailFactoryBean两种实现,如果任务调度只需要执行某个类的某个方法,就可以通过MethodInvokingJobDetailFactoryBean来调用。
  5. Job:是一个接口,只有一个方法void execute(JobExecutionContext context),开发者实现该接口定义运行任务,JobExecutionContext类提供了调度上下文的各种信息。Job运行时的信息保存在JobDataMap实例中。实现Job接口的任务,默认是无状态的,若要将Job设置成有状态的,在quartz中是给实现的Job添加@DisallowConcurrentExecution注解(以前是实现StatefulJob接口,现在已被Deprecated),在与spring结合中可以在spring配置文件的job detail中配置concurrent参数。

我这里简单记录使用过程及代码:

1:首先引用Quartz组件

2:using Quartz;using Quartz.Impl;

注:在本地新建一个控制台项目,将以下代码copy过去即可用,只需要重写Execute方法即可。Quartz3.0及以上的版本是采用的异步,3.0以下的版本没有采用异步,使用方法是一样的

主函数入口文件:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
using  BackgroundTask.job;
using  log4net;
using  Quartz;
using  Quartz.Impl;
using  System;
using  System.Collections.Generic;
using  System.Linq;
using  System.Text;
using  System.Threading.Tasks;
 
namespace  BackgroundTask
{
     class  Program
     {
         private  static  readonly  ILog _log = LogManager.GetLogger( typeof (Program));
 
         private  static  readonly  string  tiggerName =  "TestJobTrigger" ;
         private  static  readonly  string  gropName =  "TestJobTriggerGrop" ;
         private  static  readonly  string  jobName =  "TestJob" ;
         //从工厂中获取一个调度器实例化
         private  static  IScheduler scheduler =  null ;
 
 
         static  void  Main( string [] args)
         {
             Console.WriteLine( "开始任务...." );
             _log.Debug( "开始任务...." );
             Start();
 
         }
 
         private  static  async  void  Start()
         {
             //从工厂中获取一个调度器实例化
             scheduler = await StdSchedulerFactory.GetDefaultScheduler();
             await scheduler.Start();
 
 
             //创建一个作业
             IJobDetail job1 = JobBuilder.Create<TestJob>()
              .WithIdentity(jobName, gropName)
              .UsingJobData( "key" , "value" ) // 传递参数 在Execute方法中获取(以什么类型值传入,取值就用相应的类型方法取值)
              .Build();
 
             // 创建触发器
             ITrigger trigger1 = TriggerBuilder.Create()
                                         .WithIdentity(tiggerName, gropName)
                                         .StartNow()                         //现在开始
                                         .WithSimpleSchedule(x => x          //触发时间,10秒一次。
                                             .WithIntervalInSeconds(10)
                                             .RepeatForever())               //不间断重复执行
                                         .Build();
 
 
             await scheduler.ScheduleJob(job1, trigger1);       //把作业,触发器加入调度器。
 
             Console.ReadKey();
 
             // 清除任务和触发器
             ClearJobTrigger();
         }
 
         /// <summary>
         /// 清除任务和触发器
         /// </summary>
         private  static  void  ClearJobTrigger()
         {
             TriggerKey triggerKey =  new  TriggerKey(tiggerName, gropName);
             JobKey jobKey =  new  JobKey(jobName, gropName);
             if  (scheduler !=  null )
             {
                 scheduler.PauseTrigger(triggerKey);
                 scheduler.UnscheduleJob(triggerKey);
                 scheduler.DeleteJob(jobKey);
                 scheduler.Shutdown(); // 关闭
             }
 
         }
 
     }
 
}

  

实现IJob 接口的任务文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
using  log4net;
using  Quartz;
using  System;
using  System.Collections.Generic;
using  System.Linq;
using  System.Text;
using  System.Threading.Tasks;
 
namespace  BackgroundTask.job
{
     public  class  TestJob : IJob
     {
         private  readonly  ILog _log = LogManager.GetLogger( typeof (TestJob));
         /// <summary>
         /// 测试作业
         /// </summary>
         /// <param name="context"></param>
         /// <returns></returns>
         public  async Task Execute(IJobExecutionContext context)
         {

        JobDataMap dataMap = context.JobDetail.JobDataMap;
        string k = dataMap.GetString("key");//获取参数(可根据传递的类型使用GetInt、GetFloat、GetString.....)

1
2
3
4
5
6
7
8
             _log.Debug( "run TestJob debug" );
             _log.Error( "run TestJob error" );
             _log.Info( "run TestJob info" );
             // 在这里处理你的任务
             
         }
     }
}<br><br>

猜你喜欢

转载自www.cnblogs.com/blogsaspx/p/10995947.html
今日推荐