【前言】在项目的管理功能中,对定时任务的管理有时会很常见。因为我们不能指望只在配置文件中配置好定时任务就行了,因为如果要控制定时任务的 “暂停” 呢?暂停之后又要在某个时间点 “重启” 该定时任务呢?或者说直接 “删除” 该定时任务呢?要改变某定时任务的触发时间呢? “添加” 一个定时任务对于系统的使用者而言,是不太现实的,因为一个定时任务的处理逻辑他是不可能完成的,还是必须得由开发人员去添加。一般来说,是针对 “已有” 定时任务进行的一些操作,这时候就必须要用到代码来操作了,因为此时通过配置来管控是不太现实的。
版本:Spring4.x + quartz2.x
首先,开发人员会在配置文件中配置一个定时任务(定时任务的实现略……)
<bean id="job1" class="org.test.job.TestJob2" />
<!-- 定义触发器来管理任务bean -->
<bean id="cronTriggerJob1"
class="org.springframework.scheduling.quartz.CronTriggerFactoryBean"
p:cronExpression="0 52 17 * * ? *" >
<property name="jobDetail">
<bean class="org.springframework.scheduling.quartz.JobDetailFactoryBean"
p:durability="true"
p:jobClass="org.test.job.TestJob1"
/>
</property>
</bean>
</bean>
<!-- 执行实际的调度 -->
<bean class="org.springframework.scheduling.quartz.SchedulerFactoryBean">
<property name="triggers">
<list>
<ref bean="cronTriggerJob1" />
</list>
</property>
</bean>
我们怎么根据配置的bean来操作该定时任务的管理呢?
需查阅spring4.x结合quartz2.x的底层API,并搞清楚以下概念:
1)Trigger trigger. trigger.getKey()会得到两个东西——group:DEFAULT(默认的group name)、name(triggerName)。其中name对应的就是配置文件中配置的trigger的bean的id(或name)
2)trigger.getJobKey()一样会得到两个东西——group:DEFAULT(默认的group name)、name(jobName)。其中jobName对应的就是配置文件中job的bean的id或name(本例为job1)
注:以上粗体字的部分即为代码管理定时任务的关键之处!
3)如何根据jobName查找到他关联到的trigger呢?
quartz1.x还有这种语法,不过quartz2.x已经废除了:
quartz1.x Trigger trigger = sched.getTrigger(jobName,TRIGGER_GROUP_NAME);
quartz2.x的相关语法(Scheduler类的方法)更为丰富,如下:
public abstract List<? extends Trigger> getTriggersOfJob(JobKey paramJobKey)
throws SchedulerException;
public abstract List<String> getTriggerGroupNames()
throws SchedulerException;
public abstract Set<TriggerKey> getTriggerKeys(GroupMatcher<TriggerKey> paramGroupMatcher)
throws SchedulerException;
public abstract Trigger getTrigger(TriggerKey paramTriggerKey)
throws SchedulerException;
为了改变触发时间,
Trigger trigger = TriggerBuilder.forJob(String jobName).newTrigger()..withSchedule(CronScheduleBuilder.cronSchedule(time))build();
然后再用Scheduler调度类去执行:
schedler.resumeTrigger(trigger.getKey());
根据trigger得到相应的JobDetail:
JobDetail jobDetail = (JobDetail) trigger.getJobDataMap().get("jobDetail");
下面是对定时任务的管理(暂停、重启、删除):
//暂停
//schduler.pauseTrigger(TriggerKey triggerKey)
scheduler.pauseJob(JobKey.jobKey("job1"));//停止触发器
Thread.sleep(1000*60*2);
//恢复
//scheduler.resumeJob(JobKey jobKey)则可恢复一个具体的job,
scheduler.resumeTrigger(TriggerKey.triggerKey("cronTriggerJob1"));
Thread.sleep(1000*60*2);
//删除
//没有deleteTrigger的方法
scheduler.deleteJob(JobKey.jobKey("job1"));
Thread.sleep(1000*60*2);
//删除后再次尝试重启(会失效)
scheduler.resumeTrigger(TriggerKey.triggerKey("cronTriggerJob1"));
代码经测试,有效,并注意到:
当resume一个定时任务时,会立即执行该定时任务,执行完此次,然后再按原先设定的时间来定期执行;
当删除一个任务后,就算再次resume时,会失效,即并不会被恢复了。
=========================================
Spring bean必须注意的几点:
1)bean的id和name是一回事儿;
2)当一个bean类继承了InitializingBean接口后,必须实现其setBeanName(String name)抽象方法。name一般是bean的id或name属性值,此时bean实例化时方法的顺序为setProperties(String propName)->setBeanName()->afterPropertiesSet();
3)当为了获得一个bean对外提供的接口方法时,必须先获得这个bean的bean对象,通过Spring的SpringContextHolder.getBean(beanId) (其中beanId为bean的id或name属性值)。而不能通过new或者getInstance(获取单例)的方式,否则获取不到该bean的其他属性值!