基本介绍

使用场景：

任何定时任务场景，大批量定时任务/延迟任务的场景，超时控制/频率控制的业务场景，对于定时时间准确度要求不高的业务场景。

  1. 任何的定时任务都是有误差的，在定时间隔比较大，或者并发量大，负载较高的系统中尤其明显，具体请参考：
  2. 定时间隔不会考虑任务的执行时间。例如，如果一项工作需要3分钟才能执行完成，并且计划每隔5分钟运行一次，那么每次任务之间只有2分钟的空闲时间。
  3. 需要注意的是单例模式运行的定时任务，任务的执行时间会影响该任务下一次执行的开始时间。例如：一个每间隔1秒执行的任务，运行耗时为1秒，那么在第1秒开始运行后，下一次任务将会在第3秒开始执行。因为中间有一次运行检查时发现有当前任务正在进行，因此退出等待下一次执行检查。

使用方式：

接口文档：

简要说明：

  1. New方法用于创建自定义的任务定时器对象，并可在创建时通过的TimerOptions参数指定定时器的最小tick时间间隔。
  2. AddEntry方法添加定时任务，支持更多参数的控制。
  3. AddSingleton方法用于添加单例定时任务，即同时只能有一个该任务正在运行。
  4. AddOnce方法用于添加只运行一次的定时任务，当运行一次数后该定时任务自动销毁。
  5. AddTimes方法用于添加运行指定次数的定时任务，当运行times次数后该定时任务自动销毁。
  6. Search方法用于根据名称进行定时任务搜索(返回定时任务对象指针)。
  7. Stop方法用于停止定时器。
  8. Close方法用于关闭定时器。

默认定时器

大部分的场景下使用默认的定时器即可。使用gtimer的默认定时器时，默认的间隔时间为100ms，因此理论的时间间隔误差范围为0~100ms。可以使用以下两种方式修改默认的定时器参数：

  1. 使用启动参数
    • gf.gtimer.interval=50: 修改默认的时间刻度为50毫秒
  2. 使用环境变量
    • GF_GTIMER_INTERVAL=50

与gcron区别

相关文档