gtimer
是一个并发安全的高性能定时器,类似于Java的Timer
。gtimer
组件旧版本采用的是分层时间轮(Hierarchical Timing Wheel
)设计,从goframe v1.16版本开始,采用了优先级队列(PriorityQueue
)实现。
使用场景:
任何定时任务场景,大批量定时任务/延迟任务的场景,超时控制/频率控制的业务场景,对于定时时间准确度要求不高的业务场景。
注意事项:
任何的定时任务都是有误差的,在定时间隔比较大,或者并发量大,负载较高的系统中尤其明显,具体请参考:https://github.com/golang/go/issues/14410
使用方式:
import "github.com/gogf/gf/v2/os/gtimer"
接口文档:
https://pkg.go.dev/github.com/gogf/gf/v2/os/gtimer
简要说明:
New
方法用于创建自定义的任务定时器对象,并可在创建时通过interval
的TimerOptions
参数指定定时器的最小tick
时间间隔。Add
方法用于添加定时任务,其中:interval
参数用于指定方法的执行的时间间隔。job
参数为需要执行的任务方法。AddEntry
方法添加定时任务,支持更多参数的控制。 AddSingleton
方法用于添加单例定时任务,即同时只能有一个该任务正在运行。 AddOnce
方法用于添加只运行一次的定时任务,当运行一次数后该定时任务自动销毁。 AddTimes
方法用于添加运行指定次数的定时任务,当运行times
次数后该定时任务自动销毁。 Search
方法用于根据名称进行定时任务搜索(返回定时任务*Entry
对象指针)。 Start
方法用于启动定时器(使用New
创建定时器时会自动启动)。 Stop
方法用于停止定时器。 Close
方法用于关闭定时器。 大部分的场景下使用默认的定时器即可。使用gtimer
的默认定时器时,默认的间隔时间为100ms,因此理论的时间间隔误差范围为0~100ms。可以使用以下两种方式修改默认的定时器参数:
gf.gtimer.interval=50
: 修改默认的时间刻度为50毫秒GF_GTIMER_INTERVAL=50
备案信息: 粤ICP备15087711号-2
Copyright © 2008-2024 啊嘎哇在线工具箱 All Rights.
本站所有资料来源于网络,版权归原作者所有,仅作学习交流使用,如不慎侵犯了您的权利,请联系我们。