ASP.NET MVC5 实现基于Quartz.NET任务调度
工作之余。技术?。记是不可能记住的。 只有写点东西 才能维持得了生活这样子的。好早就像写一篇关于任务调度的文章。终究是太懒了
一、Quartz.NET介绍
Quartz.NET是一个强大、开源、轻量的作业调度框架,是 OpenSymphony 的 Quartz API 的.NET移植,用C#改写,可用于winform和asp.net应用中。它灵活而不复杂。你能够用它来为执行一个作业而创建简单的或复杂的作业调度。它有很多特征,如:数据库支持,集群,插件,支持cron-like表达式等等。
官网:http://www.quartz-scheduler.net/
源码:https://github.com/quartznet/quartznet
二、Quartz.NET用途
一,可以定时发邮件通知。
二 , 电商网站的定时打折活动。(比如规定11月11日 淘宝购买女朋友打八折)
三, 定时对数据更新 或者添加。
四,自己朋友生日。 可以定时发生日祝福。 等等 (我也不一一举例了)
三、Quartz.NET安装
我使用的VS版本是2015的 选择工具 - NuGet包管理 - 管理解决方案的NuGet包 输入 Quartz.NET 安装
还可以通过NuGet控制台 通过安装命令
Install-Package Quartz
四、Quartz.NET实现思路
一,继承并实现IJob接口,在Execute 方法中写你要做的事情(切记 )
二,使用Quartz 中的API 定义好 工作 触发器 以及工厂
三,加入可视化(远程管理)
四,建立配置的通讯。
五,在全局类(Global.asax)Application_Start注册并开启定时任务
五、上代码
其中JobWork 是我的定义的工作文件 里面有你要执行的工作已经对应的触发器(一个工作对应一个触发器)
首先 我写了一个向文本文件中插入文字的方法已经触发器 (注意 必须继承IJob 要做的事情写在 Execute 中)
public class AddMassagejob : IJob
{ public void Execute(IJobExecutionContext context) { var reportDirectory = string.Format("~/text/{0}/", DateTime.Now.ToString("yyyy-MM-ssss")); reportDirectory = System.Web.Hosting.HostingEnvironment.MapPath(reportDirectory); if (!Directory.Exists(reportDirectory)) { Directory.CreateDirectory(reportDirectory); } var dailyReportFullPath = string.Format("{0}text_{1}.log", reportDirectory, DateTime.Now.Day); var logContent = string.Format("{0}-{1}-{2}", DateTime.Now, "滴 滴滴", Environment.NewLine); if (logContent == null) { JobExecutionException jobex = new JobExecutionException("写入失败");
} File.AppendAllText(dailyReportFullPath, logContent); } }
public class AddMasagerTriggerServer { public ITrigger AddMasagerTrigger() { var trigger = TriggerBuilder.Create() .WithIdentity("添加消息到日志", "作业触发器") .WithSimpleSchedule(x => x //.WithIntervalInSeconds(5) // .WithIntervalInHours(5) .WithIntervalInMinutes(5) //每五分钟执行一次 .RepeatForever()) .Build(); return trigger; } }
我这里设置的是5分钟执行一次。 你也可以让他5秒 5小时执行一次。
关于时间配置
官方一些常用的实例
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分每分触发
0 0/5 14 * * ? 每天下午的 2点到2点59分(整点开始,每隔5分触发)
0 0/5 14,18 * * ? 每天下午的 2点到2点59分(整点开始,每隔5分触发)
每天下午的 18点到18点59分(整点开始,每隔5分触发)
0 0-5 14 * * ? 每天下午的 2点到2点05分每分触发
0 10,44 14 ? 3 WED 3月分每周三下午的 2点10分和2点44分触发 (特殊情况,在一个时间设置里,执行两次或 两次以上的情况)
0 59 2 ? * FRI 每周5凌晨2点59分触发;
0 15 10 ? * MON-FRI 从周一到周五每天上午的10点15分触发
0 15 10 15 * ? 每月15号上午10点15分触发
0 15 10 L * ? 每月最后一天的10点15分触发
0 15 10 ? * 6L 每月最后一周的星期五的10点15分触发
0 15 10 ? * 6L 2002-2005 从2002年到2005年每月最后一周的星期五的10点15分触发
0 15 10 ? * 6#3 每月的第三周的星期五开始触发
0 0 12 1/5 * ? 每月的第一个中午开始每隔5天触发一次
0 11 11 11 11 ? 每年的11月11号 11点11分触发(光棍节)
有兴趣的朋友可以了解 具体含义规范
然后就是创建一个作业 这里我用的是泛型去创建
public class JobServer<T> where T : IJob { public string JobName { get; set; } public string JobGroup { get; set; } public IJobDetail CrateJob() { IJobDetail job1 = JobBuilder.Create<T>() //创建一个作业 .WithIdentity(JobName, JobGroup) //JobName 代表你要执行的这个任务的名称。 JobGroup任务分组 .Build(); return job1; } }
接下来就是一些 Quartz 的配置(线程配置 远程配置等) 当然 你也可以选择写在配置文件 或者XML文件中
public class JobBase { public static IScheduler Scheduler { get { var properties = new NameValueCollection(); // 设置线程池 properties["quartz.threadPool.type"] = "Quartz.Simpl.SimpleThreadPool, Quartz"; //设置线程池的最大线程数量 properties["quartz.threadPool.threadCount"] = "5"; //设置作业中每个线程的优先级 properties["quartz.threadPool.threadPriority"] = ThreadPriority.Normal.ToString(); // 远程输出配置 properties["quartz.scheduler.exporter.type"] = "Quartz.Simpl.RemotingSchedulerExporter, Quartz"; properties["quartz.scheduler.exporter.port"] = "1996"; //配置端口号 properties["quartz.scheduler.exporter.bindName"] = "QuartzScheduler"; properties["quartz.scheduler.exporter.channelType"] = "tcp"; //协议类型 //创建一个工厂 var schedulerFactory = new StdSchedulerFactory(properties); //启动 var scheduler = schedulerFactory.GetScheduler(); return scheduler; } } public static void AddSchedule<T>(JobServer<T> jobServer,ITrigger trigger, string jobName, string jobGroup) where T : IJob { jobServer.JobName = jobName; jobServer.JobGroup = jobGroup; Scheduler.ScheduleJob(jobServer.CrateJob(), trigger);
} }
绑定trigger和job
然后就工作层 也就是任务的声明调用处
public class JobManager { public static void State() { //开启调度 JobBase.Scheduler.Start(); // 第一个参数是你要执行的工作(job) 第二个参数是这个工作所对应的触发器(Trigger)(例如:几秒或几分钟执行一次) JobBase.AddSchedule(new JobServer<AddMassagejob>(), new AddMasagerTriggerServer().AddMasagerTrigger(),"每隔五分钟向文本中写入文字","消息工作"); JobBase.AddSchedule(new JobServer<DiscountedShopJob>(), new DiscountedShopTriggerServer().GoodsDisCountTrigger(),"每月的最后一天10.15开启打折活动","折扣活动"); } }
在全局类中加入下面代码 开启工作
public class MvcApplication : System.Web.HttpApplication { protected void Application_Start() { AreaRegistration.RegisterAllAreas(); RouteConfig.RegisterRoutes(RouteTable.Routes); JobManager.State(); } }
代码部分已经完成了 接下来就是如何使用
首先 安装一个远程管理 也就是可视化操作 (你不需要写任何代码)
安装步骤一样。
在控制台 执安装命令
PM> Install-Package CrystalQuartz.Remote
安装之后你会在web.config 中发现这样的代码
其中下方红色框起来的部分 其中SchedulerHost 对应的端口号和远程名称 都要对应上方代码中配置。 一旦保持一致 意味着达成了通讯。共通了
然后启动项目在路由加上/CrystalQuartzPanel.axd
好了。 该看看效果了
由于个人英语实在有限。 命名有误 。请各位看官多多担待 谢谢大家