Go cron定时任务的用法
cron是什么cron的意思就是:计划任务,说白了就是定时任务。我和系统约个时间,你在几点几分几秒或者每隔几分钟跑一个任务(job),就那么简单。cron表达式cron表达式是一个好东西,这个东西不仅Java的quartZ能用到,Go语言中也可以用到。我没有用过Linux的cron,但网上说Linux也是可以用crontab -e 命令来配置定时任务。Go语言和Java中都是可以精确到秒的,但是Linux中不行。cron表达式代表一个时间的集合,使用6个空格分隔的字段表示:字段名是否必须允许的值 允许的特定字符秒(Seconds)是0-59* / , -分(Minute)是0-59* / , -时(Hours)是0-23* / , -日(Day of month)是1-31* / , - ?月(Month)是1-12 或 JAN-DEC* / , -星期(Day of week)否0-6 或 SUM-SAT* / , - ?注:1.月(Month)和星期(Day of week)字段的值不区分大小写,如:SUN、Sun 和 sun 是一样的。2.星期(Day of week)字段如果没提供,相当于是 *
# ┌───────────── min (0 - 59) # │ ┌────────────── hour (0 - 23) # │ │ ┌─────────────── day of month (1 - 31) # │ │ │ ┌──────────────── month (1 - 12) # │ │ │ │ ┌───────────────── day of week (0 - 6) (0 to 6 are Sunday to # │ │ │ │ │ Saturday, or use names; 7 is also Sunday) # │ │ │ │ │ # │ │ │ │ │ # * * * * * command to execute
cron特定字符说明1)星号(*)表示 cron 表达式能匹配该字段的所有值。如在第5个字段使用星号(month),表示每个月2)斜线(/)表示增长间隔,如第1个字段(minutes) 值是 3-59/15,表示每小时的第3分钟开始执行一次,之后每隔 15 分钟执行一次(即 3、18、33、48 这些时间点执行),这里也可以表示为:3/153)逗号(,)用于枚举值,如第6个字段值是 MON,WED,FRI,表示 星期一、三、五 执行4)连字号(-)表示一个范围,如第3个字段的值为 9-17 表示 9am 到 5pm 直接每个小时(包括9和17)5)问号(?)只用于 日(Day of month) 和 星期(Day of week),表示不指定值,可以用于代替 *6)L,W,#Go中没有L,W,#的用法,下文作解释。cron举例说明每隔5秒执行一次:*/5 * * * * ?每隔1分钟执行一次:0 */1 * * * ?每天23点执行一次:0 0 23 * * ?每天凌晨1点执行一次:0 0 1 * * ?每月1号凌晨1点执行一次:0 0 1 1 * ?在26分、29分、33分执行一次:0 26,29,33 * * * ?每天的0点、13点、18点、21点都执行一次:0 0 0,13,18,21 * * ?下载安装控制台输入 go get github.com/robfig/cron 去下载定时任务的Go包,前提是你的 $GOPATH 已经配置好源码解析文件目录讲解
1 constantdelay.go #一个最简单的秒级别定时系统。与cron无关 2 constantdelay_test.go #测试 3 cron.go #Cron系统。管理一系列的cron定时任务(Schedule Job) 4 cron_test.go #测试 5 doc.go #说明文档 6 LICENSE #授权书 7 parser.go #解析器,解析cron格式字符串城一个具体的定时器(Schedule) 8 parser_test.go #测试 9 README.md #README10 spec.go #单个定时器(Schedule)结构体。如何计算自己的下一次触发时间11 spec_test.go #测试
cron.go结构体:
1 // Cron keeps track of any number of entries, invoking the associated func as 2 // specified by the schedule. It may be started, stopped, and the entries may 3 // be inspected while running. 4 // Cron保持任意数量的条目的轨道,调用相关的func时间表指定。它可以被启动,停止和条目,可运行的同时进行检查。 5 type Cron struct { 6 entries []*Entry // 任务 7 stop chan struct{} // 叫停止的途径 8 add chan *Entry // 添加新任务的方式 9 snapshot chan []*Entry // 请求获取任务快照的方式10 running bool // 是否在运行11 ErrorLog *log.Logger // 出错日志(新增属性)12 location *time.Location // 所在地区(新增属性) 13 }
1 // Entry consists of a schedule and the func to execute on that schedule. 2 // 入口包括时间表和可在时间表上执行的func 3 type Entry struct { 4 // 计时器 5 Schedule Schedule 6 // 下次执行时间 7 Next time.Time 8 // 上次执行时间 9 Prev time.Time10 // 任务11 Job Job12 }
关键方法:
1 // 开始任务 2 // Start the cron scheduler in its own go-routine, or no-op if already started. 3 func (c *Cron) Start() { 4 if c.running { 5 return 6 } 7 c.running = true 8 go c.run() 9 }10 // 结束任务11 // Stop stops the cron scheduler if it is running; otherwise it does nothing.12 func (c *Cron) Stop() {13 if !c.running {14 return15 }16 c.stop <- struct{}{}17 c.running = false18 }19 20 // 执行定时任务21 // Run the scheduler.. this is private just due to the need to synchronize22 // access to the 'running' state variable.23 func (c *Cron) run() {24 // Figure out the next activation times for each entry.25 now := time.Now().In(c.location)26 for _, entry := range c.entries {27 entry.Next = entry.Schedule.Next(now)28 }29 // 无限循环30 for {31 //通过对下一个执行时间进行排序,判断那些任务是下一次被执行的,防在队列的前面.sort是用来做排序的32 sort.Sort(byTime(c.entries))33 34 var effective time.Time35 if len(c.entries) == 0 || c.entries[0].Next.IsZero() {36 // If there are no entries yet, just sleep - it still handles new entries37 // and stop requests.38 effective = now.AddDate(10, 0, 0)39 } else {40 effective = c.entries[0].Next41 }42 43 timer := time.NewTimer(effective.Sub(now))44 select {45 case now = <-timer.C: // 执行当前任务46 now = now.In(c.location)47 // Run every entry whose next time was this effective time.48 for _, e := range c.entries {49 if e.Next != effective {50 break51 }52 go c.runWithRecovery(e.Job)53 e.Prev = e.Next54 e.Next = e.Schedule.Next(now)55 }56 continue57 58 case newEntry := <-c.add: // 添加新的任务59 c.entries = append(c.entries, newEntry)60 newEntry.Next = newEntry.Schedule.Next(time.Now().In(c.location))61 62 case <-c.snapshot: // 获取快照63 c.snapshot <- c.entrySnapshot()64 65 case <-c.stop: // 停止任务66 timer.Stop()67 return68 }69 70 // 'now' should be updated after newEntry and snapshot cases.71 now = time.Now().In(c.location)72 timer.Stop()73 }74 }
spec.go结构体及关键方法:
1 // SpecSchedule specifies a duty cycle (to the second granularity), based on a 2 // traditional crontab specification. It is computed initially and stored as bit sets. 3 type SpecSchedule struct { 4 // 表达式中锁表明的,秒,分,时,日,月,周,每个都是uint64 5 // Dom:Day of Month,Dow:Day of week 6 Second, Minute, Hour, Dom, Month, Dow uint64 7 } 8 9 // bounds provides a range of acceptable values (plus a map of name to value).10 // 定义了表达式的结构体11 type bounds struct {12 min, max uint13 names map[string]uint14 }15 16 17 // The bounds for each field.18 // 这样就能看出各个表达式的范围19 var (20 seconds = bounds{0, 59, nil}21 minutes = bounds{0, 59, nil}22 hours = bounds{0, 23, nil}23 dom = bounds{1, 31, nil}24 months = bounds{1, 12, map[string]uint{25 "jan": 1,26 "feb": 2,27 "mar": 3,28 "apr": 4,29 "may": 5,30 "jun": 6,31 "jul": 7,32 "aug": 8,33 "sep": 9,34 "oct": 10,35 "nov": 11,36 "dec": 12,37 }}38 dow = bounds{0, 6, map[string]uint{39 "sun": 0,40 "mon": 1,41 "tue": 2,42 "wed": 3,43 "thu": 4,44 "fri": 5,45 "sat": 6,46 }}47 )48 49 const (50 // Set the top bit if a star was included in the expression.51 starBit = 1 << 6352 )
看了上面的东西肯定有人疑惑为什么秒分时这些都是定义了unit64,以及定义了一个常量starBit = 1 << 63这种写法,这是逻辑运算符。表示二进制1向左移动63位。原因如下:cron表达式是用来表示一系列时间的,而时间是无法逃脱自己的区间的 , 分,秒 0 - 59 , 时 0 - 23 , 天/月 0 - 31 , 天/周 0 - 6 , 月0 - 11 。 这些本质上都是一个点集合,或者说是一个整数区间。 那么对于任意的整数区间 , 可以描述cron的如下部分规则。* | ? 任意 , 对应区间上的所有点。 ( 额外注意 日/周 , 日 / 月 的相互干扰。)纯数字 , 对应一个具体的点。/ 分割的两个数字 a , b, 区间上符合 a + n * b 的所有点 ( n >= 0 )。- 分割的两个数字, 对应这两个数字决定的区间内的所有点。L | W 需要对于特定的时间特殊判断, 无法通用的对应到区间上的点。至此, robfig/cron为什么不支持 L | W的原因已经明了了。去除这两条规则后, 其余的规则其实完全可以使用点的穷举来通用表示。 考虑到最大的区间也不过是60个点,那么使用一个uint64的整数的每一位来表示一个点便很合适了。所以定义unit64不为过下面是go中cron表达式的方法:
/* ------------------------------------------------------------ 第64位标记任意 , 用于 日/周 , 日 / 月 的相互干扰。 63 - 0 为 表示区间 [63 , 0] 的 每一个点。 ------------------------------------------------------------ 假设区间是 0 - 63 , 则有如下的例子 : 比如 0/3 的表示如下 : (表示每隔两位为1) * / ? +---+--------------------------------------------------------+ | 0 | 1 0 0 1 0 0 1 ~~ ~~ 1 0 0 1 0 0 1 | +---+--------------------------------------------------------+ 63 ~ ~ ~~ 0 比如 2-5 的表示如下 : (表示从右往左2-5位上都是1) * / ? +---+--------------------------------------------------------+ | 0 | 0 0 0 0 ~ ~ ~~ ~ 0 0 0 1 1 1 1 0 0 | +---+--------------------------------------------------------+ 63 ~ ~ ~~ 0 比如 * 的表示如下 : (表示所有位置上都为1) * / ? +---+--------------------------------------------------------+ | 1 | 1 1 1 1 1 ~ ~ ~ 1 1 1 1 1 1 1 1 1 | +---+--------------------------------------------------------+ 63 ~ ~ ~~ 0 */
parser.go将字符串解析为SpecSchedule的类。
1 package cron 2 3 import ( 4 "fmt" 5 "math" 6 "strconv" 7 "strings" 8 "time" 9 ) 10 11 // Configuration options for creating a parser. Most options specify which 12 // fields should be included, while others enable features. If a field is not 13 // included the parser will assume a default value. These options do not change 14 // the order fields are parse in. 15 type ParseOption int 16 17 const ( 18 Second ParseOption = 1 << iota // Seconds field, default 0 19 Minute // Minutes field, default 0 20 Hour // Hours field, default 0 21 Dom // Day of month field, default * 22 Month // Month field, default * 23 Dow // Day of week field, default * 24 DowOptional // Optional day of week field, default * 25 Descriptor // Allow descriptors such as @monthly, @weekly, etc. 26 ) 27 28 var places = []ParseOption{ 29 Second, 30 Minute, 31 Hour, 32 Dom, 33 Month, 34 Dow, 35 } 36 37 var defaults = []string{ 38 "0", 39 "0", 40 "0", 41 "*", 42 "*", 43 "*", 44 } 45 46 // A custom Parser that can be configured. 47 type Parser struct { 48 options ParseOption 49 optionals int 50 } 51 52 // Creates a custom Parser with custom options. 53 // 54 // // Standard parser without descriptors 55 // specParser := NewParser(Minute | Hour | Dom | Month | Dow) 56 // sched, err := specParser.Parse("0 0 15 */3 *") 57 // 58 // // Same as above, just excludes time fields 59 // subsParser := NewParser(Dom | Month | Dow) 60 // sched, err := specParser.Parse("15 */3 *") 61 // 62 // // Same as above, just makes Dow optional 63 // subsParser := NewParser(Dom | Month | DowOptional) 64 // sched, err := specParser.Parse("15 */3") 65 // 66 func NewParser(options ParseOption) Parser { 67 optionals := 0 68 if options&DowOptional > 0 { 69 options |= Dow 70 optionals++ 71 } 72 return Parser{options, optionals} 73 } 74 75 // Parse returns a new crontab schedule representing the given spec. 76 // It returns a descriptive error if the spec is not valid. 77 // It accepts crontab specs and features configured by NewParser. 78 // 将字符串解析成为SpecSchedule 。 SpecSchedule符合Schedule接口 79 80 func (p Parser) Parse(spec string) (Schedule, error) { 81 // 直接处理特殊的特殊的字符串 82 if spec[0] == '@' && p.options&Descriptor > 0 { 83 return parseDescriptor(spec) 84 } 85 86 // Figure out how many fields we need 87 max := 0 88 for _, place := range places { 89 if p.options&place > 0 { 90 max++ 91 } 92 } 93 min := max - p.optionals 94 95 // cron利用空白拆解出独立的items。 96 fields := strings.Fields(spec) 97 98 // 验证表达式取值范围 99 if count := len(fields); count < min || count > max {100 if min == max {101 return nil, fmt.Errorf("Expected exactly %d fields, found %d: %s", min, count, spec)102 }103 return nil, fmt.Errorf("Expected %d to %d fields, found %d: %s", min, max, count, spec)104 }105 106 // Fill in missing fields107 fields = expandFields(fields, p.options)108 109 var err error110 field := func(field string, r bounds) uint64 {111 if err != nil {112 return 0113 }114 var bits uint64115 bits, err = getField(field, r)116 return bits117 }118 119 var (120 second = field(fields[0], seconds)121 minute = field(fields[1], minutes)122 hour = field(fields[2], hours)123 dayofmonth = field(fields[3], dom)124 month = field(fields[4], months)125 dayofweek = field(fields[5], dow)126 )127 if err != nil {128 return nil, err129 }130 // 返回所需要的SpecSchedule131 return &SpecSchedule{132 Second: second,133 Minute: minute,134 Hour: hour,135 Dom: dayofmonth,136 Month: month,137 Dow: dayofweek,138 }, nil139 }140 141 func expandFields(fields []string, options ParseOption) []string {142 n := 0143 count := len(fields)144 expFields := make([]string, len(places))145 copy(expFields, defaults)146 for i, place := range places {147 if options&place > 0 {148 expFields[i] = fields[n]149 n++150 }151 if n == count {152 break153 }154 }155 return expFields156 }157 158 var standardParser = NewParser(159 Minute | Hour | Dom | Month | Dow | Descriptor,160 )161 162 // ParseStandard returns a new crontab schedule representing the given standardSpec163 // (https://en.wikipedia.org/wiki/Cron). It differs from Parse requiring to always164 // pass 5 entries representing: minute, hour, day of month, month and day of week,165 // in that order. It returns a descriptive error if the spec is not valid.166 //167 // It accepts168 // - Standard crontab specs, e.g. "* * * * ?"169 // - Descriptors, e.g. "@midnight", "@every 1h30m"170 // 这里表示不仅可以使用cron表达式,也可以使用@midnight @every等方法171 172 func ParseStandard(standardSpec string) (Schedule, error) {173 return standardParser.Parse(standardSpec)174 }175 176 var defaultParser = NewParser(177 Second | Minute | Hour | Dom | Month | DowOptional | Descriptor,178 )179 180 // Parse returns a new crontab schedule representing the given spec.181 // It returns a descriptive error if the spec is not valid.182 //183 // It accepts184 // - Full crontab specs, e.g. "* * * * * ?"185 // - Descriptors, e.g. "@midnight", "@every 1h30m"186 func Parse(spec string) (Schedule, error) {187 return defaultParser.Parse(spec)188 }189 190 // getField returns an Int with the bits set representing all of the times that191 // the field represents or error parsing field value. A "field" is a comma-separated192 // list of "ranges".193 func getField(field string, r bounds) (uint64, error) {194 var bits uint64195 ranges := strings.FieldsFunc(field, func(r rune) bool { return r == ',' })196 for _, expr := range ranges {197 bit, err := getRange(expr, r)198 if err != nil {199 return bits, err200 }201 bits |= bit202 }203 return bits, nil204 }205 206 // getRange returns the bits indicated by the given expression:207 // number | number "-" number [ "/" number ]208 // or error parsing range.209 func getRange(expr string, r bounds) (uint64, error) {210 var (211 start, end, step uint212 rangeAndStep = strings.Split(expr, "/")213 lowAndHigh = strings.Split(rangeAndStep[0], "-")214 singleDigit = len(lowAndHigh) == 1215 err error216 )217 218 var extra uint64219 if lowAndHigh[0] == "*" || lowAndHigh[0] == "?" {220 start = r.min221 end = r.max222 extra = starBit223 } else {224 start, err = parseIntOrName(lowAndHigh[0], r.names)225 if err != nil {226 return 0, err227 }228 switch len(lowAndHigh) {229 case 1:230 end = start231 case 2:232 end, err = parseIntOrName(lowAndHigh[1], r.names)233 if err != nil {234 return 0, err235 }236 default:237 return 0, fmt.Errorf("Too many hyphens: %s", expr)238 }239 }240 241 switch len(rangeAndStep) {242 case 1:243 step = 1244 case 2:245 step, err = mustParseInt(rangeAndStep[1])246 if err != nil {247 return 0, err248 }249 250 // Special handling: "N/step" means "N-max/step".251 if singleDigit {252 end = r.max253 }254 default:255 return 0, fmt.Errorf("Too many slashes: %s", expr)256 }257 258 if start < r.min {259 return 0, fmt.Errorf("Beginning of range (%d) below minimum (%d): %s", start, r.min, expr)260 }261 if end > r.max {262 return 0, fmt.Errorf("End of range (%d) above maximum (%d): %s", end, r.max, expr)263 }264 if start > end {265 return 0, fmt.Errorf("Beginning of range (%d) beyond end of range (%d): %s", start, end, expr)266 }267 if step == 0 {268 return 0, fmt.Errorf("Step of range should be a positive number: %s", expr)269 }270 271 return getBits(start, end, step) | extra, nil272 }273 274 // parseIntOrName returns the (possibly-named) integer contained in expr.275 func parseIntOrName(expr string, names map[string]uint) (uint, error) {276 if names != nil {277 if namedInt, ok := names[strings.ToLower(expr)]; ok {278 return namedInt, nil279 }280 }281 return mustParseInt(expr)282 }283 284 // mustParseInt parses the given expression as an int or returns an error.285 func mustParseInt(expr string) (uint, error) {286 num, err := strconv.Atoi(expr)287 if err != nil {288 return 0, fmt.Errorf("Failed to parse int from %s: %s", expr, err)289 }290 if num < 0 {291 return 0, fmt.Errorf("Negative number (%d) not allowed: %s", num, expr)292 }293 294 return uint(num), nil295 }296 297 // getBits sets all bits in the range [min, max], modulo the given step size.298 func getBits(min, max, step uint) uint64 {299 var bits uint64300 301 // If step is 1, use shifts.302 if step == 1 {303 return ^(math.MaxUint64 << (max + 1)) & (math.MaxUint64 << min)304 }305 306 // Else, use a simple loop.307 for i := min; i <= max; i += step {308 bits |= 1 << i309 }310 return bits311 }312 313 // all returns all bits within the given bounds. (plus the star bit)314 func all(r bounds) uint64 {315 return getBits(r.min, r.max, 1) | starBit316 }317 318 // parseDescriptor returns a predefined schedule for the expression, or error if none matches.319 func parseDescriptor(descriptor string) (Schedule, error) {320 switch descriptor {321 case "@yearly", "@annually":322 return &SpecSchedule{323 Second: 1 << seconds.min,324 Minute: 1 << minutes.min,325 Hour: 1 << hours.min,326 Dom: 1 << dom.min,327 Month: 1 << months.min,328 Dow: all(dow),329 }, nil330 331 case "@monthly":332 return &SpecSchedule{333 Second: 1 << seconds.min,334 Minute: 1 << minutes.min,335 Hour: 1 << hours.min,336 Dom: 1 << dom.min,337 Month: all(months),338 Dow: all(dow),339 }, nil340 341 case "@weekly":342 return &SpecSchedule{343 Second: 1 << seconds.min,344 Minute: 1 << minutes.min,345 Hour: 1 << hours.min,346 Dom: all(dom),347 Month: all(months),348 Dow: 1 << dow.min,349 }, nil350 351 case "@daily", "@midnight":352 return &SpecSchedule{353 Second: 1 << seconds.min,354 Minute: 1 << minutes.min,355 Hour: 1 << hours.min,356 Dom: all(dom),357 Month: all(months),358 Dow: all(dow),359 }, nil360 361 case "@hourly":362 return &SpecSchedule{363 Second: 1 << seconds.min,364 Minute: 1 << minutes.min,365 Hour: all(hours),366 Dom: all(dom),367 Month: all(months),368 Dow: all(dow),369 }, nil370 }371 372 const every = "@every "373 if strings.HasPrefix(descriptor, every) {374 duration, err := time.ParseDuration(descriptor[len(every):])375 if err != nil {376 return nil, fmt.Errorf("Failed to parse duration %s: %s", descriptor, err)377 }378 return Every(duration), nil379 }380 381 return nil, fmt.Errorf("Unrecognized descriptor: %s", descriptor)382 }
项目中应用
package mainimport ( "github.com/robfig/cron" "log")func main() { i := 0 c := cron.New() spec := "*/5 * * * * ?" c.AddFunc(spec, func() { i++ log.Println("cron running:", i) }) c.AddFunc("@every 1h1m", func() { i++ log.Println("cron running:", i) }) c.Start()}
注: @every 用法比较特殊,这是Go里面比较特色的用法。同样的还有 @yearly @annually @monthly @weekly @daily @midnight @hourly 这里面就不一一赘述了。希望大家能够自己探索。参考网站:http://blog.studygolang.com/2014/02/go_crontab/http://blog.csdn.net/cchd0001/article/details/51076922https://en.wikipedia.org/wiki/Cronhttps://github.com/robfig/cron