quartz.net任务调度:源码及使用文档
目录:
1.quartz.net任务调度:源码及使用文档
2.quartz.net插件类库封装
前言
前段时间把自己封装quartz.net 类库的过程总结到博客园,有网友想要看一下源码,所以就把源码传到github上去了,今天把地址分享给大家,程序中单元测试,写的太丑,所以就没网上传,故此我把使用文档在这也分享给大家一下,有什么问题,请点击我园子中的qq与我联系。
源码地址:https://github.com/kmonkey9006/Quatrz.Task
目的:
方便任务调度 的创建,删除,暂停与继续操作;提高任务在系统的可维护性与可扩展性。
使用流程:
1.web.config设置时间间隔与开始时间(便于维护)
<!--自动任务执行时间间隔(秒)by wyl--> <add key="ReDoPaySchedulerTimeBySeconds" value="86400" /> <!--自动任务执行 by wyl--> <add key="ReDoPaySchedulerStartTime" value="3:10"/>
2.在使用处调用类库方法:
2.1获取任务调度执行时间间隔与开始执行时间(这些值可以在代码中直接赋值)
static int times = Convert.ToInt32(Synjones.Common.Config.Config.AppSettings("ReDoPaySchedulerTimeBySeconds")); static DateTime startTime = Convert.ToDateTime(Synjones.Common.Config.Config.AppSettings("ReDoPaySchedulerStartTime")).AddDays(1);
2.2创建任务调度
new QJob("standardsd", "jobid", "轮询缴费", "XX").Handle(DoRePay).Start(startTime, times, 0);
注:standardsd:系统编码(syscode)
Jobid:任务id(jobid)
轮询缴费:任务名称(name)
山东大学:任务群组名称(group)
DoRePay:任务调度触发动作。(action)
startTime:任务开始时间(starttime)
times:任务间隔时间(internaltimes)
0:最大执行次数(0表示无限次)(maxtimes)
3.在不停止服务端的情况下暂停与继续任务
修改任务持久化文件,默认地址为~/Files/jobs/
当State为Working时表示任务正常执行
当State为Pending/Empty时表示任务正常执行(注意大小写,写错则按Working执行)
调用说明:
调用说明 |
|
对象初始化 |
New QJob(string syscode, string id, string name = "", string group = "") |
参数说明 |
Syscode:系统编码 Id:jobid Name:任务名称 Group:任务群组
|
其他说明 |
Syscode+jobid:标志者任务的唯一性 Name,group:可为空但建议写上,以便于更容易操作任务持久化文件 StartTime:开始时间默认为 DateTime.Now.AddMinutes(1) Maxtimes:最大执行次数默认为0 Internaltimes:时间间隔默认为1个小时 |
持久化文件存放地址赋值 |
JobFactory.Instance.SetPath(string path)
|
参数说明 |
文件路径必须以@“\”结尾,不进行赋值默认地址为~\File\jobs\ |
任务触发动作 |
Handle(Action handler)和Handle(Action<IQJob> handler) |
参数说明 |
两者参数的却别在于一个有回调参数(IQJOB),一个没有参数 |
创建任务(1) |
Start(DateTime starttime, int internaltimes , int maxtimes) |
参数说明 |
Starttime:开始时间 internaltimes :任务执行间隔 maxtimes :最大执行次数
|
创建任务(2) |
Start() |
参数说明 |
直接执行创建job任务调度 |
移除任务 |
IQJob.Remove() |
说明 |
根据IQJob进行删除(syscoed与jobid确定其唯一性) |
暂停任务 |
IQJob.Pause() |
说明 |
根据IQJob进行暂停(syscoed与jobid确定其唯一性) |
继续任务 |
IQJob.Resume() |
说明 |
根据IQJob进行Resume(syscoed与jobid确定其唯一性) |
修改任务触发动作 |
JobFactory.Instance.Trigger(string system_code, Action action) JobFactory.Instance.Trigger(string system_code, Action<IQJob> action) |
参数说明 |
system_code:系统编码 Action:触发动作 |
持久化操作 |
JobFactory.Instance.Initialize(); |
说明 |
获取持久化文件,进行反序列化,然后把对象进行任务调度创建。 |
注意:
(1)系统编码和任务id组合必须唯一。
(2)开始执行时间最好在系统操作不频繁时间段(在服务平台和山东大学我用的是3:10)
(3)创建任务调度时,如果当前时间大于开始时间,任务在没创建之前就会事先执行一次。所以希望在创建任务的时候开始时间不要用datetime.now。用指定时间或者用DateTime.Now.AddMinutes(1)
(4)基于(3)的说明,开始时间如果指定为2016-06-06 3:10 ,当在这时间之后如果服务器down掉,重新启动系统时,不管是不是在3:10之后,系统均会执行一次
案例:
(1) new QJob("syscode", "jobid", "name", "group").Handle(job_handler).Start(DateTime.Now.AddSeconds(30), 2, 10); (2) new QJob("syscode", "jobid", "name", "group").Handle(job_detail_handler).Start(); (3) new QJob("syscode", "jobid", "name", "group").Remove(); (4) new QJob("syscode", "jobid").Remove(); (5) new QJob("syscode", "jobid", "name", "group").Pause(); (6) new QJob("syscode", "jobid").Pause(); (7) new QJob("syscode", "jobid", "name", "group").Resume(); (8) new QJob("syscode", "jobid").Resume();