grapeTimerR时间调度器

联合创作 · 2023-09-30 19:29

grapeTimerR是一款粗粒度的时间调度器,可以帮你通过一些字符串快速并简单的创建时间任务,同时也是grapeTimer的Rust版本,提供相同功能以及相同类型的服务。

功能 Feature

  • 通过命令格式创建std::chrono::Datetime(Created by date format)
  • 简洁的Api格式,轻度且可拆分的函数库(Simple Api, light and detachable library)
  • 快速创建调度器(Quickly create a scheduler)
  • 可控的调度器时间粒度[需要提前指定](Controllable scheduler time granularity [Need to specify in advance])
  • 多线程调度模式(Multi-thread scheduling mode)
  • 时间周期,次数多模式可控[支持每天、每周、每月](Time period, multi-mode controllable number of times [support daily, weekly, monthly])
  • 可以获取下一次执行时间[Chrono Datetime](Can get the string of the next execution time)
  • 自定义起始TimerId的种子(Customize the seed of the starting TimerId)
  • 自定义TimerId的生成函数[自生成ID请注意并发场景下的线程争抢](Custom TimerId generation trait [Self-generated ID, please pay attention to thread contention in concurrent scenarios])
  • TimerId扩展为i64,支持大ID和timestampId生成器(TimerId is i64, supporting large Id and timestampId generator correspondence)

日期格式 Date Format

The scheduler has a light date pattern analysis system, which can provide daily, weekly, and monthly time and date generation methods

调度器有轻度的日期模式分析体系,可提供每日,每周,每月的时间日期生成方式,具体格式如下:

关键字 Key 格式 Format 说明 Description
Day Day 00:00:00 生成每日的日期时间
Week Week 1 00:00:00 生成每周的日期时间, 0~6 分别代表周日到周六
Month Month 1 00:00:00 生成每月该日期的时间,建议不要使用28日之后的日期
Key Format Description
Day Day 00:00:00 Generate daily date and time
Week Week 1 00:00:00 Generate weekly date and time, 0~6 represent Sunday to Saturday
Month Month 1 00:00:00 The time when the date of the month was generated, it is recommended not to use the date after the 28th

Examples

parser date format

use grapeTimerR::parsers;
// get next tick Datetime
let next_day = parsers::parser_next("Day 05::00:00").unwrap();
// get next timestamp
let next_dayTime = parsers::parser_timestamp("Day 05::00:00").unwrap();

// utc
let next_dayUtc = parsers::parser_nextUtc("Day 05::00:00").unwrap();
let next_dayTimeUtc = parsers::parser_timestampUtc("Day 05::00:00").unwrap();

add ticker

    fn executer_task(id:u64) {
        println!("on function mode:{}",chrono::Local::now().to_rfc2822());
    }
    // 使用函数方式执行代码 Use function to execute code
    timer::spwan_ticker(time::Duration::from_millis(5000),2,executer_task);
    // 使用闭包模式 Use closure function
    timer::spwan_ticker(time::Duration::from_millis(5000),2,|x| {
        println!("on ticker:{}",chrono::Local::now().to_rfc2822());
    });

add ticker by trait mode

struct ExempleAction {}

// 首先我们定义一个结构体
//First we define a struct
impl TaskAction for ExempleAction {
    // 实际执行的代码段
    // Code snippet executed
    fn execute(&self, id: u64) {
        println!("on trait struct:{}",chrono::Local::now().to_rfc2822());
    }

    // 不使用的话,返回一个空字符串
    // If not used, return an empty string,like ""
    fn date_format(&self) -> &str {
        return ""
    }

    // 如果你不使用date_format,就必须使用这个参数,否则异常。
    // If you don't use date_format, you must use this parameter, otherwise it is panic.
    // 时间单位 毫秒 ,time unit is millisecond
    fn tick(&self) -> u64 {
        return 5000;
    }

    // 这里需要自定义ID或将其设置为一个组的ID,所以停止任务会停止这个组
    // Here you need to customize the ID or set it to the GroupId or TaskType Id,
    // so stopping the task will stop the group
    fn id(&self) -> u64 {
        return 18888;
    }

    // 循环的次数
    fn loop_count(&self) -> i32 {
       return 15;
    }
}

    // 使用trait任务,可以简化部分实际逻辑
    // Using trait tasks can simplify part of the actual logic
    timer::spwan_trait(Arc::new(ExempleAction{}));

add date

timer::spwan_date("day 19:21:50",1,|id| {
    println!("on date:{}",chrono::Local::now().to_rfc2822());
});

鸣谢(Thanks)

Use Jetbrains Ide for project

saythanks Generic badge Generic badge

浏览 16
点赞
评论
收藏
分享

手机扫一扫分享

编辑 分享
举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

编辑 分享
举报