核心 = scheduler + JobDetail + Trigger
原理:
1、scheduler是一个计划调度器容器(总部),容器里面可以盛放众多的JobDetail和trigger,当容器启动后,里面的每个JobDetail都会根据trigger按部就班自动去执行。
2、JobDetail是一个可执行的工作,它本身可能是有状态的。(何事)
3、Trigger代表一个调度参数的配置,什么时候去调。(何时)
4、当JobDetail和Trigger在scheduler容器上注册后,形成了装配好的作业(JobDetail和Trigger所组成的一对儿),就可以伴随容器启动而调度执行了。
5、scheduler是个容器,容器中有一个线程池,用来并行调度执行每个作业,这样可以提高容器效率。
组件概念:
1、Job:作业是一个执行任务的简单Java类。只需实现org.quartz.Job接口,并将业务代码写在execute()方法中即可。
public class PrintTimeJob implements Job {
@Override
public void execute(JobExecutionContext context) throws JobExecutionException {
//获取JobDetail中关联的数据
String msg = (String) context.getJobDetail().getJobDataMap().get("params");
System.out.println("current time :"+new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date()) + "---" + msg);
}
}
2、 JobDetail:由Quartz客户端在Job被加入到scheduler时创建。它包含了Job的各种设置属性以及一个JobDataMap对象(存储给定Job类实例的数据)。Scheduler并不保存真正的Job Class,而是通过JobDetail来保存。
3、Trigger:触发器,被用来触发jobs的执行。Triggers也有一个JobDataMap与之关联,这非常有利于向触发器所触发的Job传递参数。Quartz打包了很多不同类型的Trigger,最常用的Trigger类是SimpleTrigger和CronTrigger。
4、 SimpleTrigger:用来触发只需执行一次、或者在给定时间触发、并且重复N次且每次执行延迟一定时间的任务。
5、CronTrigger:如果需要像日历那样按日程来触发任务,而不仅仅是像SimpleTrigger 那样每隔特定的间隔时间触发
6、 Cron表达式被用来配置CronTrigger实例。Cron表达式是一个由7个子表达式组成的字符串。每个子表达式都描述了一个单独的日程细节。这些子表达式用空格分隔,分别表示:
Seconds | Minutes | Hours | Day-of-Month | Month | Day-of-Week | Year (optional field) |
---|---|---|---|---|---|---|
秒 | 分钟 | 小时 | 月中的天 | 月 | 周中的天 | 年 |
在线生成Cron表达式
注:月中的天和周中的天互斥,所以其中有一个一定是?
===================================================================
SimpleTrigger
public class SimpleScheduler {
public static void main(String[] args) throws SchedulerException {
JobDataMap jobDataMap = new JobDataMap();
jobDataMap.put("params", "123456");
//打印当前的执行时间
Date date = new Date();
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
String currentTime = sdf.format(date);
System.out.println("Current Time : "+currentTime);
//获取10秒钟之后的具体时间
date.setTime(date.getTime()+10000);
//创建一个JobDetail实例,将该实例与PrintTimeJob class绑定
JobDetail jobDetail = JobBuilder.newJob(PrintTimeJob.class)
.withIdentity("myJob")
.setJobData(jobDataMap)
.build();
//创建一个Trigger实例,定义该Job距离当前时间10s钟后执行,且执行一次
SimpleTrigger trigger = (SimpleTrigger)TriggerBuilder.newTrigger()
.withIdentity("myTrigger")
.startAt(date)
.build();
//创建Scheduler实例
SchedulerFactory sfact = new StdSchedulerFactory();
Scheduler scheduler = sfact.getScheduler();
scheduler.start();
scheduler.scheduleJob(jobDetail, trigger);
//取消定时任务:功能上触发器和任务取消一个即可,但还是都删除吧
// TriggerKey triggerKey = new TriggerKey("myTrigger");
// scheduler.pauseTrigger(triggerKey);// 停止触发器
// scheduler.unscheduleJob(triggerKey);// 移除触发器
// JobKey jobKey = new JobKey("myJob");
// scheduler.deleteJob(jobKey);// 删除任务
}
===================================================================
CronTrigger
/**
* 添加一个定时任务
*/
public static void addJob(Scheduler sched, String jobName, String jobGroupName, String triggerName,
String triggerGroupName, @SuppressWarnings("rawtypes") Class jobClass, Object params, String time) {
try {
JobKey jobKey = new JobKey(jobName, jobGroupName);
JobDataMap jobDataMap = new JobDataMap();
jobDataMap.put("params", params);
@SuppressWarnings("unchecked")
JobDetail jobDetail = newJob(jobClass).withIdentity(jobKey).setJobData(jobDataMap).build();
// 触发器
TriggerKey triggerKey = new TriggerKey(triggerName, triggerGroupName);
Trigger trigger = newTrigger().withIdentity(triggerKey).withSchedule(cronSchedule(time)).build();
sched.scheduleJob(jobDetail, trigger);
} catch (Exception e) {
throw new RuntimeException(e);
}
}
/**
* 修改一个任务的触发时间
*/
public static void modifyJobTime(Scheduler sched, String triggerName, String triggerGroupName, String time) {
try {
TriggerKey triggerKey = new TriggerKey(triggerName, triggerGroupName);
CronTrigger trigger = (CronTrigger) sched.getTrigger(triggerKey);
if (trigger == null) {
return;
}
String oldTime = trigger.getCronExpression();
if (!oldTime.equalsIgnoreCase(time)) {
// 修改时间
trigger.getTriggerBuilder().withSchedule(cronSchedule(time));
// 重启触发器
sched.resumeTrigger(triggerKey);
}
} catch (Exception e) {
throw new RuntimeException(e);
}
}
/**
* 移除一个定时任务
*/
public static void removeJob(Scheduler sched, String jobName, String jobGroupName, String triggerName,
String triggerGroupName) {
try {
TriggerKey triggerKey = new TriggerKey(triggerName, triggerGroupName);
sched.pauseTrigger(triggerKey);// 停止触发器
sched.unscheduleJob(triggerKey);// 移除触发器
JobKey jobKey = new JobKey(jobName, jobGroupName);
sched.deleteJob(jobKey);// 删除任务
} catch (Exception e) {
throw new RuntimeException(e);
}
}
===================================================================
timer demo