Quartz.NET 任务调度配置文件说明

默认的quartz任务配置文件为quartz_jobs.xml，在quartz服务的根目录下

quartz_jobs.xml可以配置为简单任务触发器和cron复杂任务触发器两种方式：

简单的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>HouseSecondTask</name>
<group>HouseSecondTaskGroup</group>
<description>二手房对比作业</description>
<job-type>Quartz.Server.Monitor.HouseSecondTask, Quartz.Server</job-type>
<durable>true</durable>
<recover>false</recover>
</job>
<trigger>
<simple>
<name>HouseSecondTaskTrigger</name>
<group>HouseSecondTaskTriggerGroup</group>
<description></description>
<job-name>HouseSecondTask</job-name>
<job-group>HouseSecondTaskGroup</job-group>
<misfire-instruction>SmartPolicy</misfire-instruction>
<repeat-count>1</repeat-count>
<repeat-interval>1800000</repeat-interval>
</simple>
</trigger>
</schedule>
</job-scheduling-data>

参数说明 ：

这个节点是用来定义每个具体的任务的，多个任务请创建多个job节点即可

name(必填) 任务名称，同一个group中多个job的name不能相同，若未设置group则所有未设置group的job为同一个分组，如:<name>sampleJob</name>

group(选填) 任务所属分组，用于标识任务所属分组，如:<group>sampleGroup</group>

description(选填) 任务描述，用于描述任务具体内容，如:<description>Sample job for Quartz Server</description>

job-type(必填) 任务类型，任务的具体类型及所属程序集，格式：实现了IJob接口的包含完整命名空间的类名,程序集名称，如:<job-type>Quartz.Server.SampleJob, Quartz.Server</job-type>

durable(选填) 具体作用不知，官方示例中默认为true，如:<durable>true</durable>

recover(选填) 具体作用不知，官方示例中默认为false，如:<recover>false</recover>

trigger 任务触发器，用于定义使用何种方式出发任务(job)，同一个job可以定义多个trigger ，多个trigger 各自独立的执行调度，每个trigger 中必须且只能定义一种触发器类型(calendar-interval、simple、cron)

calendar-interval 一种触发器类型，使用较少，此处略过

simple 简单任务的触发器，可以调度用于重复执行的任务

name(必填) 触发器名称，同一个分组中的名称必须不同

group(选填) 触发器组

description(选填) 触发器描述

job-name(必填) 要调度的任务名称，该job-name必须和对应job节点中的name完全相同

job-group(选填) 调度任务(job)所属分组，该值必须和job中的group完全相同

start-time(选填) 任务开始执行时间utc时间，北京时间需要+08:00，如：<start-time>2012-04-01T08:00:00+08:00</start-time>表示北京时间2012年4月1日上午8:00开始执行，注意服务启动或重启时都会检测此属性，若没有设置此属性或者start-time设置的时间比当前时间较早，则服务启动后会立即执行一次调度，若设置的时间比当前时间晚，服务会等到设置时间相同后才会第一次执行任务，一般若无特殊需要请不要设置此属性

repeat-count(必填) 任务执行次数，如:<repeat-count>-1</repeat-count>表示无限次执行，<repeat-count>10</repeat-count>表示执行10次

repeat-interval(必填) 任务触发间隔(毫秒)，如:<repeat-interval>10000</repeat-interval> 每10秒执行一次

cron复杂任务触发器--使用cron表达式定制任务调度（强烈推荐)示例：

<job>
<name>HouseSecondTask</name>
<group>HouseSecondTaskGroup</group>
<description>二手房对比作业</description>
<job-type>Quartz.Server.Monitor.HouseSecondTask, Quartz.Server</job-type>
<durable>true</durable>
<recover>false</recover>
</job>
<trigger>
<cron>
<name>HouseSecondTaskTrigger</name>
<group>HouseSecondTaskTriggerGroup</group>
<job-name>HouseSecondTask</job-name>
<job-group>HouseSecondTaskGroup</job-group>
<cron-expression>0 45 8,12,16,21 * * ? </cron-expression>
</cron>
</trigger>
</schedule>

cron复杂任务触发器和简单任务触发器的差异主要是<trigger>节，不同，具体参数说明：

name(必填) 触发器名称，同一个分组中的名称必须不同

group(选填) 触发器组

description(选填) 触发器描述

job-name(必填) 要调度的任务名称，该job-name必须和对应job节点中的name完全相同

job-group(选填) 调度任务(job)所属分组，该值必须和job中的group完全相同

start-time(选填) 任务开始执行时间utc时间，北京时间需要+08:00，如：<start-time>2012-04-01T08:00:00+08:00</start-time>表示北京时间2012年4月1日上午8:00开始执行，注意服务启动或重启时都会检测此属性，若没有设置此属性，服务会根据cron-expression的设置执行任务调度；若start-time设置的时间比当前时间较早，则服务启动后会忽略掉cron-expression设置，立即执行一次调度，之后再根据cron-expression执行任务调度；若设置的时间比当前时间晚，则服务会在到达设置时间相同后才会应用cron-expression，根据规则执行任务调度，一般若无特殊需要请不要设置此属性

cron-expression(必填) cron表达式，如:<cron-expression>0/10 * * * * ?</cron-expression>每10秒执行一次

具体CRON表达式的意义可参数网上内容。

cron配置简要说明

CronTrigger配置格式:

格式: [秒] [分] [小时] [日] [月] [周] [年]

序号	说明	是否必填	允许填写的值	允许的通配符
1	秒	是	0-59	, - * /
2	分	是	0-59	, - * /
3	小时	是	0-23	, - * /
4	日	是	1-31	, - * ? / L W
5	月	是	1-12 or JAN-DEC	, - * /
6	周	是	1-7 or SUN-SAT	, - * ? / L #
7	年	否	empty 或 1970-2099	, - * /

常用示例:

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 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分触发(光棍节)