go中的定时任务--gron

简介

gron是一个比较小巧、灵活的定时任务库，可以执行定时的、周期性的任务。gron提供简洁的、并发安全的接口。我们先介绍gron库的使用，然后简单分析一下源码。

快速使用

先安装：

$ go get github.com/roylee0704/gron

后使用：

package main

import (
  "fmt"
  "sync"
  "time"

  "github.com/roylee0704/gron"
)

func main() {
   
  var wg sync.WaitGroup
  wg.Add(1)

  c := gron.New()
  c.AddFunc(gron.Every(5*time.Second), func() {
   
    fmt.Println("runs every 5 seconds.")
  })
  c.Start()

  wg.Wait()
}

gron的使用比较简单：

• 首先调用gron.New()创建一个管理器，这是一个定时任务的管理器；
• 然后调用管理器的AddFunc()或Add()方法向它添加任务，在启动时添加也是可以的，见下文分析；
• 最后调用管理器的Start()方法启动它。

gron支持两种添加任务的方式，一种是使用无参数的函数，另一种是实现任务接口。上面例子中使用的是前一种方式，实现接口的方式我们后面会介绍。添加任务时通过gron.Every()指定周期任务的间隔，上面添加了一个 5s 的周期任务，每隔 5s 输出一行文字。

需要注意的是，我们使用sync.WaitGroup保证主 goroutine 不退出。因为c.Start()中只是启动了一个 goroutine，如果主 goroutine 退出了，整个程序就停止了。

运行程序，每隔 5s 输出：

runs every 5 seconds.
runs every 5 seconds.
runs every 5 seconds.

该程序需要按下ctrl + c停止！

时间格式

gron接受time.Duration类型的时间间隔，除了time包中定义的基础Second/Minute/Hour，gron中的xtime子包还提供了Day/Week单位的时间。有一点需要注意，gron支持的时间精度为 1s，小于 1s 的间隔是不支持的。除了单位时间间隔，我们还可以使用4m10s这样的时间：

func main() {
   
  var wg sync.WaitGroup
  wg.Add(1)

  c := gron.New()
  c.AddFunc(gron.Every(1*time.Second), func() {
   
    fmt.Println("runs every second.")
  })
  c.AddFunc(gron.Every(1*time.Minute), func() {
   
    fmt.Println("runs every minute.")
  })
  c.AddFunc(gron.Every(1*time.Hour), func() {
   
    fmt.Println("runs every hour.")
  })
  c.AddFunc(gron.Every(1*xtime.Day), func() {
   
    fmt.Println("runs every day.")
  })
  c.AddFunc(gron