Devfeel/DotTask
简约大方的go-task组件
支持cron、loop、queue三种模式
特性
- 支持配置方式(xml + json + yaml)与代码方式
- 支持cron、loop、queue三种模式
- cron模式支持“秒 分 时 日 月 周”配置
- loop模式支持毫秒级别
- queue模式支持毫秒级别
- 上次任务没有停止的情况下不触发下次任务
- 支持Exception、OnBegin、OnEnd注入点
- 支持单独执行TaskHandler
- 支持代码级重设Task的相关设置
- 支持超时控制
- 内建Task运行计数信息，包含执行与异常计数
- 内建针对Task与Counter的OutputHttpHandler,可方便与WebServer自动集成
安装：
go get -u github.com/devfeel/dottask
快速开始：
package main
import (
"fmt"
. "github.com/devfeel/dottask"
"time"
)
var service *TaskService
func Job_Test(ctx *TaskContext) error {
fmt.Println(time.Now().String(), " => Job_Test")
//time.Sleep(time.Second * 3)
return nil
}
func Loop_Test(ctx *TaskContext) error {
fmt.Println(time.Now().String(), " => Loop_Test")
time.Sleep(time.Second * 3)
return nil
}
func main() {
//step 1: init new task service
service = StartNewService()
//step 2: register task handler
_, err := service.CreateCronTask("testcron", true, "48-5 */2 * * * *", Job_Test, nil)
if err != nil {
fmt.Println("service.CreateCronTask error! => ", err.Error())
}
_, err = service.CreateLoopTask("testloop", true, 0, 1000, Loop_Test, nil)
if err != nil {
fmt.Println("service.CreateLoopTask error! => ", err.Error())
}
//step 3: start all task
service.StartAllTask()
fmt.Println(service.PrintAllTasks())
for {
time.Sleep(time.Hour)
}
}配置方式
package main
import (
"fmt"
. "github.com/devfeel/dottask"
"time"
)
var service *TaskService
func Job_Config(ctx *TaskContext) error {
fmt.Println(time.Now().String(), " => Job_Config")
//time.Sleep(time.Second * 3)
return nil
}
func Loop_Config(ctx *TaskContext) error {
fmt.Println(time.Now().String(), " => Loop_Config")
time.Sleep(time.Second * 3)
return nil
}
func RegisterTask(service *TaskService) {
service.RegisterHandler("Job_Config", Job_Config)
service.RegisterHandler("Loop_Config", Loop_Config)
}
func main() {
//step 1: init new task service
service = StartNewService()
//step 2: register all task handler
RegisterTask(service)
//step 3: load config file
service.LoadConfig("d:\\task.conf")
//step 4: start all task
service.StartAllTask()
fmt.Println(service.PrintAllTasks())
for {
time.Sleep(time.Hour)
}
}task.xml.conf:
<?xml version="1.0" encoding="UTF-8"?>
<config>
<global isrun="true" logpath="d:/"/>
<tasks>
<task taskid="Loop_Config" type="loop" isrun="true" duetime="10000" interval="10" handlername="Loop_Config" />
<task taskid="Job_Config" type="cron" isrun="true" express="0 */5 * * * *" handlername="Job_Config" />
</tasks>
</config>
关于表达式
- 关于CronTask的TimeExpress 简单解释：
- 基本格式：* * * * * *（6列，以空格分隔）
- f1:第1列表示秒0-59，每一秒用或/1 表示。
- f2:第2列表示分钟0-59。
- f3:第3列表示小时0-23。
- f4:第4列表示日期1-31。
- f5:第5列表示月份1-12。
- f6:第6列表示星期几0-7，其中0和7均表示为周日。
- 当f1为 * 时表示每秒都要执行任务，f2为 * 时表示每分钟都要执行程序，其余类推
- 当f1为 a-b 时表示从第 a 秒钟到第 b 秒钟这段时间内要执行，f2 为 a-b 时表示从第 a 到第 b 分钟都要执行，其余类推
- 当f1为 */n 时表示每 n 秒钟个时间间隔执行一次，f2 为 */n 表示每 n 小时个时间间隔执行一次，其余类推
- 当f1为 a, b, c,... 时表示第 a, b, c,... 秒钟要执行，f2 为 a, b, c,... 时表示第 a, b, c...分钟要执行，其余类推
示例：
- #每天早上7点执行一次调度任务:
- 0 0 7 * * *
- #在 12 月内, 每天的早上 6 点到 12 点中，每隔3个小时执行一次调度任务:
- 0 0 6-12/3 * 12 *
- #周一到周五每天下午 5:00执行一次调度任务:
- 0 0 17 * * 1-5
- #每月每天的午夜 0 点 20 分, 2 点 20 分, 4 点 20 分....执行一次调度任务
- 0 20 0-23/2 * * *
- #每月每天的0 点 20 分, 9 点 20 分, 16 点 20 分执行一次调度任务
- 0 20 0,9,16 * * *
外部依赖
yaml - https://gopkg.in/yaml.v2
如何联系
QQ群：193409346