Quartz.Net 有两类配置文件,
1. Quartz.系统级别配置, 默认配置文件名为 quartz.config , 是java properties 格式的配置文件, 用来设定 quartz 整体行为, 比如 scheduler instance id, 线程池大小, jobstore类型, DB jobstore的数据库地址, quartz 的插件(比如有长时间作业自动 interrupt 插件), 以及定义 job/trigger的配置文件路径
2. job/trigger的配置文件, 默认名称为 quartz_jobs.xml, 用来配置 job 和 trigger 定义信息
对于Quartz.系统级的配置, 可以直接用代码设置, 可以放到quartz.config, 也可以 Quartz.Net 也支持定义在 C#项目的 app.config 文件中, 这样就不需要单独再引入 quartz.config 文件.
下面是写代码的方式设定Quartz.系统级配置的示例:
var factory = new StdSchedulerFactory(new System.Collections.Specialized.NameValueCollection()
{
{"quartz.plugin.xml.fileNames","~/quartz_jobs.xml" },
{"quartz.plugin.xml.type","Quartz.Plugin.Xml.XMLSchedulingDataProcessorPlugin,Quartz"},
{"quartz.plugin.triggHistory.type","Quartz.Plugin.History.LoggingJobHistoryPlugin,Quartz"},
});
IScheduler scheduler = factory.GetScheduler();
scheduler.Start();
定义在 C#项目 app.config 的示例:
<quartz>
<add key="quartz.scheduler.instanceName" value="QuartzScheduler" />
<!-- Configure Thread Pool -->
<add key="quartz.threadPool.type" value="Quartz.Simpl.SimpleThreadPool, Quartz" />
<add key="quartz.threadPool.threadCount" value="10" />
<add key="quartz.threadPool.threadPriority" value="Normal" />
<!-- Configure Job Store -->
<add key="quartz.jobStore.type" value="Quartz.Simpl.RAMJobStore, Quartz" />
<add key="quartz.plugin.xml.type" value="Quartz.Plugin.Xml.XMLSchedulingDataProcessorPlugin, Quartz" />
<add key="quartz.plugin.xml.fileNames" value="~/quartz_jobs.xml" />
<add key="quartz.plugin.xml.scanInterval" value="10" />
<add key="quartz.plugin.xml.failOnFileNotFound" value="true" />
</quartz>
注意:
1. V2 版本的插件 quartz.plugin.xml 和 V3 版的quartz.plugin.jobInitializer 是一个东西, v2 插件放在主包中, v3 分离到 Quartz.Plugins 包中了.
2. quartz.plugin.xml.scanInterval 参数可以设置定时几秒自动加载job/trigger定义文件, 取值为0表示禁止自动加载job文件.
3. xml 文件定义的job 只需要调用 scheduler.Start() 即可自动调度 ; 但使用代码build 的job, 需要额外调用 scheduler.ScheduleJob() 方法才能被调度.
4. quartz.net Version 3之后开始支持异步, 我使用的是quart 2.6.2, 即v2的最后一个版本, 还是传统的代码写法.
5. 如果没有空余线程, job将会等到腾出空余线程才会执行, 但是等待时间如果超过 misfireThreshold 设置时间将放弃本次执行.
具体可以参考
https://stackoverflow.com/questions/10952240/quartz-net-job-type-configuration-issues
https://github.com/castleproject/Windsor.Quartz/blob/master/docs/configuration.md
https://jalena.bcsytv.com/archives/1994
https://www.cnblogs.com/skychen1218/p/7765823.html
下面部分转载自 https://jalena.bcsytv.com/archives/1994
Quartz.NET 3.x 例子
最近写项目需要用到定时任务,所以就找到了Quartz.NET,但网上的例子都是到处抄袭的,完全没有适合Quartz.NET 3.x 的有用信息,这里就将自己的使用例子帖一下。
- IDE:VS2017
- .Net : 4.5.2
写在前面
Quartz.NET 在3.x已经将插件分离了,所以如果要从xml直接加载文件,需要引入插件包
配置
app.config
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<configSections>
<section name="quartz" type="System.Configuration.NameValueSectionHandler, System, Version=1.0.5000.0,Culture=neutral, PublicKeyToken=b77a5c561934e089" />
</configSections>
<quartz>
<add key="quartz.scheduler.instanceName" value="QuartzScheduler"/>
<add key="quartz.threadPool.type" value="Quartz.Simpl.SimpleThreadPool, Quartz"/>
<add key="quartz.threadPool.threadCount" value="10"/>
<!--******************************Plugin配置*********************************************-->
<add key="quartz.plugin.jobInitializer.type" value="Quartz.Plugin.Xml.XMLSchedulingDataProcessorPlugin, Quartz.Plugins"/>
<add key="quartz.plugin.jobInitializer.fileNames" value="quartz_jobs.xml"/>
</quartz>
<startup>
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5.2"/>
</startup>
</configuration>
quartz_jobs.xml
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file contains job definitions in schema version 2.0 format -->
<job-scheduling-data xmlns="http://quartznet.sourceforge.net/JobSchedulingData" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.0">
<processing-directives>
<overwrite-existing-data>true</overwrite-existing-data>
</processing-directives>
<schedule>
<!--开始执行一个调度-->
<job>
<name>jldwjob</name>
<group>kelun</group>
<description>计量单位</description>
<job-type>Kelun.JldwJob, Kelun</job-type><!--格式:实现了IJob接口的包含完整命名空间的类名,程序集名称-->
<durable>true</durable>
<recover>false</recover>
</job>
<trigger>
<cron>
<name>jlwd</name>
<group>kelun</group>
<job-name>jldwjob</job-name>
<job-group>kelun</job-group>
<!--<start-time>2018-01-22T00:00:00+08:00</start-time>-->
<cron-expression>0/1 * * * * ?</cron-expression><!--每3秒执行一次-->
</cron>
</trigger>
</schedule>
</job-scheduling-data>
接口实现
using Kelun.Log4Net;
using Quartz;
using System.Reflection;
using System.Threading.Tasks;
namespace Kelun
{
class JldwJob : IJob
{
private static readonly IMyLog Logger = MyLogManager.GetLogger(MethodBase.GetCurrentMethod().DeclaringType);
public Task Execute(IJobExecutionContext context)
{
return Task.Run(() =>
{
Logger.Info("定时任务执行");
});
}
}
}
启动Quartz
public MainForm()
{
InitializeComponent();
RunProgramAsync().GetAwaiter().GetResult();
}
private static async Task RunProgramAsync()
{
try
{
StdSchedulerFactory factory = new StdSchedulerFactory();
IScheduler scheduler = await factory.GetScheduler();
//开启调度器
await scheduler.Start();
//创建一个作业
//IJobDetail job = JobBuilder.Create<JldwJob>().WithIdentity("myJob", "group1").Build();
//ITrigger trigger = TriggerBuilder.Create()
// .WithIdentity("myTrigger", "group1")
// .StartNow() //现在开始
// .WithSimpleSchedule(x => x
// .WithIntervalInSeconds(1) //触发时间,1秒一次
// .RepeatForever())
// .Build();
//把作业,触发器加入调度器。
//await scheduler.ScheduleJob(job, trigger);
//await scheduler.Shutdown();
}
catch (SchedulerException se)
{
Logger.Error("执行错误", se);
}
}
禁用Quartz.NET日志输出
<logger name="Quartz">
<level value="OFF" />
</logger>