Go Revel - Jobs（任务调度模块）

revel提供了一个框架用于脱离请求流程的执行异步任务，一般用来执行经常运行的任务、更新缓存数据或发送邮件等。 ##启用 该框架作为一个可选的revel模块，默认并不启用。需要更改应用配置来启用它： module.jobs = github.com/robfig/revel/modules/jobs 此外，为了访问任务监控页面，需要将下面添加至路由配置： module:jobs 这条语句将在路由配置中加入`/@jobs`地址 ##参数 一些选项告诉jobs框架在运行任务时应该具有什么样的限制，下面是默认值： jobs.pool = 10 # 允许同时执行多少个任务 jobs.selfconcurrent = false # 允许一个任务只有在前一个实例完成后才能运行 ##启动任务 使用`revel.OnAppStart`函数在程序开始运行时启动一个任务，revel将在启动服务器之前连续的运行这些任务。注意，此功能并不是用jobs模块，但是它可以用来提交一个jobs作业而不终端服务器的启动。 func init() { revel.OnAppStart(func() { jobs.Now(populateCache{}) }) } ##经常性的任务 任务可以被任何时间表调度，有两个方法来表示时间表： 1、一个cron表达式 2、一个固定的时间间隔 revel使用`cron`来处理cron表达式并执行任务，这里对`cron`的格式进行了详细的说明： https://github.com/robfig/cron/blob/master/README.md 任务通常在`revel.OnAppStart`处理器注册，但也可以在之后的任何时间来注册一个任务。 import ( "github.com/robfig/revel" "github.com/robfig/revel/modules/jobs/app/jobs" "time" ) type ReminderEmails struct { // 省略 } func (e ReminderEmails) Run() { // 查询数据库 // 发送一些邮件 } func init() { revel.OnAppStart(func() { jobs.Schedule("0 0 0 * * ?", ReminderEmails{}) jobs.Schedule("@midnight", ReminderEmails{}) jobs.Schedule("@every 24h", ReminderEmails{}) jobs.Every(24 * time.Hour, ReminderEmails{}) }) } ##命名的调度器 可以在`app.conf`定义一个调度器，然后在任何地方引用它，这样有助于提供容易理解并且可重用的调度器。 在`app.conf`定义一个命名的调度器： cron.workhours_15m = 0 */15 9-17 ? * MON-FRI 在任何地方使用命名的调度器来设置cron描述表达式： func init() { revel.OnAppStart(func() { jobs.Schedule("cron.workhours_15m", ReminderEmails{}) }) } 注意，自定义的调度器名称必须以`cron.`开头。 ##一次性任务 有时，相应用户的请求需要做一些事，jobs模块允许提交一个单次执行的任务。 type AppController struct { *revel.Controller } func (c AppController) Action() revel.Result { // 处理请求. ... // 现在异步的发送邮件 jobs.Now(SendConfirmationEmail{}) //或者在单位时间之后再异步的发送邮件 jobs.In(time.Minute, SendConfirmationEmail{}) } ##注册函数 也可以将`func()`方式的函数使用`jobs.Func`类型包装并当作一个任务： func sendReminderEmails() { // 查询数据库 // 发送邮件 } func init() { revel.OnAppStart(func() { jobs.Schedule("@midnight", jobs.Func(sendReminderEmails)) }) } ##任务状态 jobs模块提供了一个状态页面用来显示所有的任务调度，以及它们的状态（IDLE 空闲 或 RUNNING 运行）还有它们上一次以及下一次的运行时间。  安全起见，只有请求来自`127.0.0.1`的时候，次页面才被显示。 ##受限的任务池 可以设置jobs任务池大小用来限制同一时间运行任务的数量，这可以允许开发人员限制异步任务所使用的资源 - 如果常规的交互响应权重高于异步处理。如果任务池中正在运行的任务满了，那么新的任务会被阻塞直到池中有任务完成。 ##开发相关 1、允许以HTTP基本的验证方式访问任务状态页面 2、允许系统管理员在任务状态页面以交互方式运行调度任务 3、为任务的运行提供能多的可视化效果，如池大小，队列长度