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/

 当StateWorking时表示任务正常执行

 当StatePending/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)开始执行时间最好在系统操作不频繁时间段(在服务平台和山东大学我用的是310

(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();
posted @ 2016-06-22 14:44  王延领  阅读(3535)  评论(12编辑  收藏  举报