Grails Quartz插件 定时调度任务
Quartz插件可以使Grails应用程序按照指定的时间间隔或cron表达式来执行调度任务。Grails系统通过spring配置使用Quartz Enterprise Job Scheduler 实现，但是编码时按照规约可以很容易的实现。
Grails-Quartz 0.4.1是当前稳定版本。Grails-Quartz 0.4.2是最新正在开发的版本。（已经发布了）
1 插件安装
在应用文件夹路径下键入以下命令
grails install-plugin quartz
如果以上命令由于某种原因不行，试一下下面这个
grails install-plugin http://cloud.github.com/downloads/nebolsin/grails-quartz/grails-quartz-0.4.1.zip
2 用法
调度任务（Scheduling Jobs）
在命令行键入“grails create-job”命令并输入任务名称，Grails会创建一个新的任务，并把它放到"grails-app/jobs"路径下。
class MyJob {
static triggers = {
simple name: 'mySimpleTrigger', startDelay: 60000, repeatInterval: 1000
}
def group = "MyGroup"
def execute(){
print "Job run!"
}
}
上述例子会等待1分钟后每秒调用execute方法一次。'repeatInterval' 和'startDelay'属性的单位是毫秒，值必须是int或long。如果这两个属性不指定，则使用默认值（repeatInterval为1分钟，startDelay为30秒）
jobs默认情况下在test环境不运行。
调度Cron任务（Scheduling a Cron Job）
可以使用cron表达式调度任务。
class MyJob {
static triggers = {
cron name: 'myTrigger', cronExpression: "0 0 6 * * ?"
}
def group = "MyGroup"
def execute(){ print "Job run!" }
}
组合触发器任务
可以使用组合触发器调度任务。
class MyJob {
static
triggers = {
simple name:'simpleTrigger', startDelay:10000, repeatInterval: 30000, repeatCount: 10
cron name:'cronTrigger', startDelay:10000, cronExpression: '0/6 * 15 * * ?'
custom name:'customTrigger', triggerClass:MyTriggerClass, myParam:myValue, myAnotherParam:myAnotherValue
}
def execute() { println "Job run!" } }
上面这个例子中，scheduler（调度器）启动10秒后，job会每隔30秒执行一次，一共执行11次（simpleTrigger）；在15点时每6秒执行一次（15:00:00, 15:00:06, 15:00:12, … — 这个由'cronTrigger'配置的），自定义的触发器触发时执行。
三种触发器可以支持的参数如下
simple:name— 触发器的名称标识startDelay— 调度器启动与第一次执行任务之间的间隔 (单位：毫秒)repeatInterval— 连续两次执行任务之间的时间间隔(单位：毫秒)repeatCount— 任务执行(1 + repeatCount)次之后停止 (=0执行一次 或=-1执行无限次)
cron:name— 触发器的名称标识startDelay— 调度器启动与第一次执行任务之间的间隔 (单位：毫秒)cronExpression— cron表达式
custom:triggerClass— 自定义的实现了Trigger接口的类- 自定义触发器的需要的其他参数
动态任务调度（Dynamic Jobs Scheduling）
从0.4.1版本开始，可以使用动态调度任务。
可以使用以下方法：
MyJob.schedule(String cronExpression, Map params?)— 创建cron触发器;MyJob.schedule(Long repeatInterval, Integer repeatCount?, Map params?)— 创建simple触发器: 间隔repeatInterval毫秒重复job repeatCount+1次;MyJob.schedule(Date scheduleDate, Map params?)— 在指定日期调度执行一个任务;MyJob.schedule(Trigger trigger)— 使用自定义触发器调度任务执行;MyJob.triggerNow(Map params?)— 强制任务立刻执行.
每个方法都带有一个可选的‘params’参数。可以用它传递数据。
class MyJob {
…
def execute(context) {
println context.mergedJobDataMap.get('foo')
}
…
}
// 在controller (或 service, 或其他地方):
MyJob.triggerNow([foo:"It Works!" ])
依赖注入和jobs（Dependency Injection and Jobs）
Jobs被配置为按名称自动绑定（auto-wiring by name），属性可以注入到jobs里。为获取data source可以声明
def dataSource
或者一个Service类
def myService
Grails application context 配置为使用规约，因此大部分类型可以使用属性名称很简单地注入（即大多数情况下首字母小写）。
使用JobExecutionContext（Using JobExecutionContext）
从0.3.2开始，你可以定义在job中这样定义execute方法def execute(context){} ，这由Quartz's JobExecutionContext 提供。
如通过 context.getMergedJobDataMap() 提供一些参数给job一样，你可以从context中获取某些信息（触发器名称，上次执行时间
，下次执行时间等）。如果你的job是有状态的（看下面的并发一节），JobExecutionContext中的job数据在每次执行job时也会持久化。
配置插件（Configuring the plugin）
从0.3版本开始，插件支持配置文件，配置内容保存在
grails-app/conf/QuartzConfig.groovy文件中。语法与默认的Grails配置文件
Config.groovy
相同
。
在命令行键入
'grails install-quartz-config'，可以获得一个初始的 Quartz配置文件。文件内容大致如下：
quartz {
autoStartup = true
jdbcStore = false
}
environments {
test {
quartz {
autoStartup = false
}
}
}
目前支持的选项：
-
autoStartup— 应用启动时，自动启动Quartz调度器 (默认值:true) -
jdbcStore— 如果需要Quartz持久化 jobs到DB时设置为true(默认值:false),还需要提供quartz.properties文件，确信所需的数据表在db中存在 (see Clustering section below for the sample config and automatic tables creation using Hibernate)
还可以创建grails-app/conf/quartz.properties文件来为Quartz调度器提供不同的选项(参考 Quartz configuration reference ).
日志（Logging）
log被自动注入到你的job类里，但没有激活它。在 grails-app/conf/Config.groovy中配置如下语句即可设置log级别。
debug 'grails.app.task'
Hibernate会话和任务（Hibernate Sessions and Jobs）
默认配置每次job执行时绑定一个Hibernate会话。当你要open session或者domain类持久化操作时这是必须的。
如果你不使用，可以使用 'sessionRequired' 属性重载这个行为。
def sessionRequired = false
配置并发执行（Configuring concurrent execution）
默认Jobs可以并发执行，因此即使前一个同样的任务正在执行，一个新的任务也可以创建并执行。如果想重载这种行为，可以使用'concurrent' 属性
def concurrent = false