• .NET Core 实现后台任务(定时任务)Longbow.Tasks 组件(三)


    原文链接:https://www.cnblogs.com/ysmc/p/16512309.html

      在上两篇文章中,简单介绍了怎么使用 IHostedService 与 BackgroundService 实现定时任务,除此以外,我们还可以借助一些第三方的组件实现定时任务,如大家比较熟悉的 Quartz,今天给大家介绍另外一个轻量级的定时任务组件 Longbow.Tasks,Longbow.Tasks 同样是也是继承了 IHostedService 噢,支持cron,该组件在 Gitee 上开源,感兴趣的小伙伴可以去看看,传送门

      值得一提的是,该组件同时支持 .NET Framework 与 .Net Core,下面看看官方说明:


    Task 任务管理

    任务服务管理是 BootstrapAdmin 内置的轻量级多线程安全的定时后台任务模块,功能均内置于 Longbow.Tasks.dll 组件库内,支持 NETFramework 4.5+ 与 NETCore 2.0+

    设置

    NETCore 容器注入

    public void ConfigureServices(IServiceCollection services)
    {
        services.AddTaskServices();
    }

    NETFramework 4.5+

    // 程序入口调用
    TaskServicesManager.Init();

    组成

    ITaskServicesFactory

    后台任务服务工厂接口,内部实现类为 TaskServicesFactory 也继承了 IHostedService 所以组件通过 services.AddTaskServices(); 将任务服务注入到 NETCore 容器中

    IScheduler

    后台任务调度接口,内部实现类为 DefaultScheduler 负责管理任务的调度

    ITrigger

    后台任务触发器接口,内部内置三个实现类分别为 (默认触发器仅触发一次)DefaultTrigger (周期性定时触发器)RecurringTrigger (Cron表达式触发器)CronTrigger 可以通过实现 ITrigger 接口根据实际业务需要自行扩展触发器,组件默认提供 TriggerBuilder 负责创建任务触发器

    ITask

    后台任务业务类接口,仅一个 Task Execute(CancellationToken cancellationToken); 方法,后台任务具体实现

    TaskServicesOptions

    后台任务服务配置类

    TaskServicesManager:

    后台任务服务人机交互操作类,提供所有后台任务操作相关 API


     

      首先我们需要安装这个组件包,搜索 Longbow.Tasks 并安装

       注册该组件服务,然后就可以愉快的使用了;

    builder.Services.AddTaskServices();

    1、创建一个类,并且继承 ITask,实现接口,写上需要执行的任务代码:

    复制代码
    public class TasksDemo : ITask
    {
        public Task Execute(CancellationToken cancellationToken)
        {
            Console.WriteLine($"{DateTime.Now}");
    
            return Task.CompletedTask;
        }
    }
    复制代码

    2、在你需要启动定时任务的地方,加上以下代码,按照自己的需要选择中意的任务执行方式呗

    复制代码
     1 //立即执行,仅执行一次
     2 TaskServicesManager.GetOrAdd("任务唯一标识");
     3 
     4 //周期性任务 (1 分钟后间隔 5 秒执行2次任务)
     5 var trigger = TriggerBuilder.Default.WithInterval(TimeSpan.FromSeconds(5)).WithRepeatCount(2).WithStartTime(DateTimeOffset.Now.AddMinutes(1)).Build();
     6 
     7 TaskServicesManager.GetOrAdd("任务唯一标识", trigger);
     8 
     9 //支持cron表达式,间隔 5 秒循环执行任务
    10 TaskServicesManager.GetOrAdd("任务唯一标识", TriggerBuilder.Build("*/5 * * * * *"));
    复制代码

      值得一提的是,这里的 Cron 表达式并不支持年,下面我们看看 Longbow.Tasks 的官方说明:


    Cron 格式说明

    cron 表达式是用于定义固定时间、日期和间隔的掩码。掩码由秒(可选)、分钟、小时、日、月和星期字段组成。所有字段都允许指定多个值,如果所有字段都包含匹配的值,则任何给定的日期/时间都将满足指定的 cron 表达式。

                                        Allowed values    Allowed special characters   Comment
    
    ┌───────────── second (optional)       0-59              * , - /                      
    │ ┌───────────── minute                0-59              * , - /                      
    │ │ ┌───────────── hour                0-23              * , - /                      
    │ │ │ ┌───────────── day of month      1-31              * , - / L W ?                
    │ │ │ │ ┌───────────── month           1-12 or JAN-DEC   * , - /                      
    │ │ │ │ │ ┌───────────── day of week   0-6  or SUN-SAT   * , - / # L ?                Both 0 and 7 means SUN
    │ │ │ │ │ │
    * * * * * *


      有小伙伴可能要问了,那我怎么停止定时任务的执行呢,在我们启动任务的时候,是需要输入一个任务的唯一标识的,我们可以通过这个标识,找到我们任务的执行器,并对其进行启动、暂停、停止等操作:

    var task = TaskServicesManager.Get("任务唯一标识");

      获取实例后,我们来看看都提供了一些什么样的操作吧

    复制代码
     1 public interface IScheduler
     2 {
     3     /// 
     4     /// 获得 任务调度名称
     5     /// 
     6     string Name { get; }
     7 
     8     /// 
     9     /// 获得/设置 调度器状态
    10     /// 
    11     SchedulerStatus Status { get; set; }
    12 
    13     /// 
    14     /// 获得 下一次运行时间 为空时表示不再运行
    15     /// 
    16     DateTimeOffset? NextRuntime { get; }
    17 
    18     /// 
    19     /// 获得 上一次运行时间 为空时表示未运行
    20     /// 
    21     DateTimeOffset? LastRuntime { get; }
    22 
    23     /// 
    24     /// 获得 上一次任务运行结果
    25     /// 
    26     TriggerResult LastRunResult { get; }
    27 
    28     /// 
    29     /// 获得 上一次运行异常
    30     /// 
    31     Exception? Exception { get; }
    32 
    33     /// 
    34     /// 获得 调度器创建时间
    35     /// 
    36     DateTimeOffset CreatedTime { get; }
    37 
    38     /// 
    39     /// 获得 调度器相关触发器
    40     /// 
    41     IEnumerable Triggers { get; }
    42 
    43     /// 
    44     /// 获得 调度器相关联任务
    45     /// 
    46     ITask? Task { get; }
    47 }
    复制代码

      好了,这次的介绍就到这,下一篇将会使用 Longbow.Tasks 进行实战介绍【手动狗头】

    写在最后

    Bootstrap Blazor 官网地址:https://www.blazor.zone

      希望大佬们看到这篇文章,能给项目点个star支持下,感谢各位!

    star流程:

    1、访问点击项目链接:BootstrapBlazor   star

    2、点击star,如下图,即可完成star,关注项目不迷路:

     

    另外还有两个GVP项目,大佬们方便的话也点下star呗,非常感谢:

      BootstrapAdmin 项目地址:star
      https://gitee.com/LongbowEnterprise/BootstrapAdmin

      SliderCaptcha 项目地址:star
      https://gitee.com/LongbowEnterprise/SliderCaptcha

     

    交流群(QQ)欢迎加群讨论

           BA & Blazor ①(795206915)          BA & Blazor ②(675147445)

     

  • 相关阅读:
    JavaWeb过滤器(Filter)详解,是时候该把过滤器彻底搞懂了(万字说明)
    ZZNUOJ_C语言1027:判断水仙花数(完整代码)
    PTA 编程题(C语言)-- 连续因子
    OpenCL编程指南-11.1OpenCL嵌入式简档
    滚雪球学Java(44):掌握Java编程的关键:深入解析System类
    Oracle 踩坑记录
    MATLAB关于polt3d函数的问题求解
    Java 栈帧的一个面试题
    跨境电商ozon自养号测评有什么优势?
    在ubuntu安装nvidia驱动 (亲测有效,这是方法二)
  • 原文地址:https://www.cnblogs.com/ysmc/p/16512309.html