基于 dotnet standard 2.0 的定时任务组件 Light.Cron

MIT
C#
跨平台
2019-07-22
aquilahkj

Light.Cron是一个使用简单的基于dotnet standard 2.0的定时任务组件, 通过执行对象和对执行方法的Attribute进行定时任务配置

nuget 安装

PM> Install-Package Light.Cron

使用配置

[CrontabJob]
public class CrontabObject
{
    [CrontabSchedule("crontab1", "* * * * *")]
    public void DoSomeThing()
    {
        // Todo
    }
}

执行对象需要标记CrontabJobAttribute, 执行方法需要标记CrontabScheduleAttribute

CrontabScheduleAttribute

属性 说明
Name 指定Crontab方法的唯一名称
Schedule 调度计划, 如* * * * *
AllowConcurrentExecution 允许并发执行, 如上一次执行还没结束, 下一次执行时间已到, 允许同时执行
RunImmediately 启用时不判断Schedule是否符合, 马上执行
AutoEnable CrontabService启动时自动启用

系统会通过使用依赖注入方式生成一个SingletonCrontabService对象进行定时任务调度.

通过使用IServiceCollection.AddCrontabJob依赖注入配置, 再使用IApplicationBuilder.UseCrontabJob启动CrontabService.

    public class Startup
    {
        public Startup(IConfiguration configuration)
        {
            Configuration = configuration;
        }

        public IConfiguration Configuration { get; }

        public void ConfigureServices(IServiceCollection services)
        {
            services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2);
            services.AddCrontabJob();
        }

        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            app.UseCrontabJob();
            app.UseMvc();
        }
    }

CrontabService默认会扫描EntryAssembly程序集中的有CrontabJobAttribute的类以及该类中有CrontabScheduleAttribute的方法, 如要扫描其他程序集, 可以在AddCrontabJob中可以使用CrontabOptionsBuilder进行配置

属性/方法 说明
ScanAllAssembly 扫描所有程序集
SetAssembly 扫描指定的程序集

调度命令格式

Light.Cron完全兼容Linux Crontab时间格式, 如下

*  *  *  *  *
分 时 日 月 周

第1列表示分钟0~59 第2列表示小时0~23 第3列表示日期1~31 新增e标记作为月末最后一天 第4列表示月份1~12 第5列标识号星期0~7(0和7表示星期天)

每天早上6点 
0 6 * * *

每天10点至16点 
0 10-16 * * *

每隔两个小时 
0 */2 * * *

每月1日,15日和最后1日的早上5点
0 5 1,15,e * * 

跨时间段

当时间段格式出现结束时间小于开始时间, 则代表由开始时间到下一级时间的开始时间, 如

每月1号22点到2号4点之间的时间段
* 22-4 1 * * 
每周一至周五晚上22点到次日4点之间的时间段, 里面包含周六的0点-4点, 不包含周一的0点-4点
* 22-4 * * 1-5

月末日期

日期格式中增加新增e标记作为月末最后一天, 并且可以通过e+数字代表最后一天再往前倒数天数, 如当月共31天, 则e=31, e1=30, e2=29, e3=28. 当月共30天, 则e=30, e1=29, e2=28, e3=27. 该语法同样支持范围

0 0 e3-e1 * * 

时间范围

Light.Cron可以通过新语法HH:mm-HH:mm将时分结合, 替换原有的时分设置, 如

每日9点30分至15点0分, 每隔一分钟执行一次
09:30-15:00 * * *
每日21点30分至次日的5点30分, 每隔5分钟执行一次
21:30-05:30/5 * * *

多组调度计划

Light.Cron可以通过|符号支持多组调度计划, 如

0点至11点, 每分钟执行一次, 12点至23点, 每5分钟执行一次
* 0-11 * * *|*/5 12-23 * * *

简略写法

如下一级及其以之后的时间范围都是*, 可以简略不写, 如

* * * * * = *
30 9 * * * = 30 9
09:30-15:00 * * * = 09:30-15:00
0 0 1 * * = 0 0 1
0 0 1 2-5 * = 0 0 1 2-5
的码云指数为
超过 的项目
加载中

评论(0)

暂无评论

暂无资讯

暂无问答

一张图看懂Kettle

Pentaho Kettle , 强大的PDI (ETL)工具。

2014/03/25 10:32
3.4K
0
/var/log目录下的20个Linux日志文件功能详解

如果愿意在Linux环境方面花费些时间,就应该知道日志文件的所在位置以及它们包含的内容。在系统运行正常的情况下学习了解这些不同的日志文件有助于你在遇到紧急情况时从容找出问题并加以解决...

2014/08/14 11:13
22
0
关于quartz的那些事

一般用到定时调度要么用到jdk的timer要么用spring栈的quartz,今天就总结一下网上的博客,一般的quartz的简单实现也不用怎么说了,网上例子一大把,就想看看关于分布式调度系统是怎么实用quartz实...

2017/08/27 17:49
32
0
/var/log目录下的20个Linux日志文件功能详解

如果愿意在Linux环境方面花费些时间,首先就应该知道日志文件的所在位置以及它们包含的内容。在系统运行正常的情况下学习了解这些不同的日志文件有助于你在遇到紧急情况时从容找出问题并加以...

2015/03/19 10:46
18
0
java jvm

java jvm

2014/01/17 14:47
27
0
24、10 配置管理计划任务

master上vi /srv/salt/cron_test.sls //加入如下内容 cron_test: cron.present: - name: /bin/touch /tmp/111.txt - user: root - minute: '*' - hour: 20 - daymonth: '*' - month: '*' - ...

2018/12/07 09:58
2
0
文件描述符再述之 initscript 和 systemd

“too many open files”,跟了我这么多年,辛苦了!

2015/11/03 14:58
336
0
Linux 定时任务

做服务端,定时调度,cron 服务简单快捷

2015/12/17 13:53
85
0
LINUX计划任务cron

记录下,转的

2016/03/11 11:00
32
1
Linux cron运行原理

1. 前言 本文介绍的是由Paul Vixie开发的运行在SuSE Linux上的Cron。可以通过“man cron”进行确认。 2. 示例 # 示例用来配合本文的说明 */1 * * * * echo hello >> /tmp/hello.txt 3. 工作过...

2015/07/24 12:03
1K
0

没有更多内容

加载失败,请刷新页面

返回顶部
顶部