Quartz.NET的具体使用

一、什么是quartz.net？

quartz.net 是一个功能齐全的开源作业调度系统，可用于从最小的应用程序到大型企业系统。

quartz.net是纯净的，它是一个.net程序集，是非常流行的java作业调度系统quartz的c#实现。

二、quartz.net可以做什么？

quartz.net很多特征，如：数据库支持，集群，插件，支持cron-like表达式等等，非常适合在平时的工作中，定时轮询数据库同步，定时邮件通知，定时处理数据等。

quartz.net允许开发人员根据时间间隔（或天）来调度作业。它实现了作业和触发器的多对多关系，还能把多个作业与不同的触发器关联。

quartz.net的应用程序可以重用来自不同事件的作业，还可以为一个事件组合多个作业。

我此次选择quartz.net使用的版本是 3.3.3

这里强调一点：3.x的版本与2.x的版本使用方式有一定的差别

quartz.net官方文档：https://www.quartz-scheduler.net/documentation/quartz-3.x/quick-start.html

三、asp.net core如何使用quartz.net？

首先我们需要创建一个asp.net core web的项目，创建的过程就不展示了，我创建的是api项目，使用传统三层架构。

项目创建好后，我们需要在nuget包管理器中安装quartz.aspnetcore和quartz.extensions.dependencyinjection

与2.x的使用方式不同，因为我使用的版本是3.3.3（此时最新版本）。我们就不像传统的创建调度中心类。传统的是定义作业工厂类【resetjobfactory】,控制中心类【schedulercenter】，以及定期工作类【regularwork】（如下图）在这就不过多介绍了。

只需创建一个定期工作类【regularwork】，并且继承quartz.net的ijob接口，i_regularwork_bll能注入到regularwork内需要usemicrosoftdependencyinjectionjobfactory.

 public class regularwork : ijob
    {
    private readonly i_regularwork_bll i_bll;
    public regularwork(i_regularwork_bll ibll)
    {
        i_bll = ibll;
    }
 
    public task execute(ijobexecutioncontext context)
    {
        input_roomtype model = new input_roomtype();
        model.currentpage = 1;
        model.pagesize = 1;
        var result = i_bll.getroomtypelist(model);
 
        return task.run(() =>
        {
            using (streamwriter sw = new streamwriter(@"f:/quartz-net.txt", true, encoding.utf8))
            {
               sw.writeline(datetime.now.tostring("yyyy-mm-dd hh:mm:ss:fff =>") + jsonconvert.serializeobject(result));
            }
        });
    }
}

在startup.cs的configureservices方法内通过services去注册regularwork

//quartz的工作单元
 services.addtransient<regularwork>();

configureservices方法内新增quartz调度中心。quartz.extensions.dependencyinjection提供与microsoft 依赖注入的集成，虽然quartz 为作业工厂提供了两个内置替代方案，可以通过调用usemicrosoftdependencyinjectionjobfactory或usemicrosoftdependencyinjectionscopedjobfactory（已弃用）进行配置。

从 quartz.net 3.3.2 开始，默认作业工厂生成的所有作业都是作用域作业，不应再使用usemicrosoftdependencyinjectionscopedjobfactory。

addjob-新增一个工作单元；startnow表示作业现在就开始执行；

withinterval用于执行时间策略执行规则；

timespan.fromseconds表示执行的时间间隔，秒为单位；repeatforever代表重复工作，可以用withrepeatcount(5)代替repeatforever；withrepeatcount(5)代表执行5次

  //quartz调度中心
    services.addquartz(q =>
    {
        //用于注入
        q.usemicrosoftdependencyinjectionjobfactory();
        // 基本quartz调度器、作业和触发器配置
        var jobkey = new jobkey("regularwork", "regularworkgroup");
        q.addjob<regularwork>(jobkey, j => j
            .withdescription("my regular work")
        );
        q.addtrigger(t => t
            .withidentity("trigger")
            .forjob(jobkey)
            .startnow()
            .withsimpleschedule(x => x.withinterval(timespan.fromseconds(10))//开始秒数 10s
            .repeatforever())//持续工作
            .withdescription("my regular work trigger")
        );
});           

configureservices方法内新增添加quartz服务

// asp.net核心托管-添加quartz服务器
 services.addquartzserver(options =>
 {
     // 关闭时，我们希望作业正常完成
     options.waitforjobstocomplete = false;
 });

完整代码

//quartz的工作单元
    services.addtransient();
    //quartz调度中心
    services.addquartz(q =>
    {
        //用于注入
        q.usemicrosoftdependencyinjectionjobfactory();
        // 基本quartz调度器、作业和触发器配置
        var jobkey = new jobkey("regularwork", "regularworkgroup");
        q.addjob(jobkey, j => j
            .withdescription("my regular work")
        );
        q.addtrigger(t => t
            .withidentity("trigger")
            .forjob(jobkey)
            .startnow()
            .withsimpleschedule(x => x.withinterval(timespan.fromseconds(10))//开始秒数 10s
            .withrepeatcount(5))//持续工作
            .withdescription("my regular work trigger")
        );
});
// asp.net核心托管-添加quartz服务
services.addquartzserver(options =>
{
    // 关闭时，我们希望作业正常完成
    options.waitforjobstocomplete = false;
});

这时候我们启动项目,定期工作开始执行。这时候的注入是有效的，查询数据后结果打印在f盘下的quartz-net.txt文件内（如下图）。

四、quartz的cron表达式

官方的文档介绍：https://www.quartz-scheduler.net/documentation/quartz-2.x/tutorial/crontrigger.html

由7段构成：秒 分 时 日 月 星期 年（可选）
"-" ：表示范围 mon-wed表示星期一到星期三
"," ：表示列举 mon,web表示星期一和星期三
"*" ：表是“每”，每月，每天，每周，每年等
"/" :表示增量：0/15（处于分钟段里面） 每15分钟，在0分以后开始，3/20 每20分钟，从3分钟以后开始
"?" :只能出现在日，星期段里面，表示不指定具体的值
"l" :只能出现在日，星期段里面，是last的缩写，一个月的最后一天，一个星期的最后一天（星期六）
"w" :表示工作日，距离给定值最近的工作日
"#" :表示一个月的第几个星期几，例如："6#3"表示每个月的第三个星期五（1=sun...6=fri,7=sat）

expression	meaning
0 0 12 * * ?	每天中午12点触发
0 15 10 ? * *	每天上午10:15触发
0 15 10 * * ?	每天上午10:15触发
0 15 10 * * ? *	每天上午10:15触发
0 15 10 * * ? 2005	2005年的每天上午10:15触发
0 * 14 * * ?	在每天下午2点到下午2:59期间的每1分钟触发
0 0/5 14 * * ?	在每天下午2点到下午2:55期间的每5分钟触发
0 0/5 14,18 * * ?	在每天下午2点到2:55期间和下午6点到6:55期间的每5分钟触发
0 0-5 14 * * ?	在每天下午2点到下午2:05期间的每1分钟触发
0 10,44 14 ? 3 wed	每年三月的星期三的下午2:10和2:44触发
0 15 10 ? * mon-fri	周一至周五的上午10:15触发
0 15 10 15 * ?	每月15日上午10:15触发
0 15 10 l * ?	每月最后一日的上午10:15触发
0 15 10 l-2 * ?	fire at 10:15am on the 2nd-to-last last day of every month
0 15 10 ? * 6l	每月的最后一个星期五上午10:15触发
0 15 10 ? * 6l	fire at 10:15am on the last friday of every month
0 15 10 ? * 6l 2002-2005	2002年至2005年的每月的最后一个星期五上午10:15触发
0 15 10 ? * 6#3	每月的第三个星期五上午10:15触发
0 0 12 1/5 * ?	fire at 12pm (noon) every 5 days every month, starting on the first day of the month.
0 11 11 11 11 ?	fire every november 11th at 11:11am.

到此这篇关于quartz.net的具体使用的文章就介绍到这了,更多相关quartz.net使用内容请搜索以前的文章或继续浏览下面的相关文章希望大家以后多多支持！