1、什么是Quartz
quartz是一个功能丰富的开源的任务调用系统,它可以定义很多job并发执行,支持事务和集群
2、可以做什么
定义任务,在任何时刻,或者某一时刻可以做想执行的任务
3、Quartz 三要素:
- Scheduler:任务调度器,所有的任务都是从这里开始。
- Trigger:触发器,定期执行任务,一般有cron表达式
- JobDetail 任务详细
- Job : 定义任务具体执行的逻辑,最终执行的逻辑
job 实现 QuartzJobBean ,abstractQuartzJob,任务执行的地方
Scheduler
注意:scheduler是一个接口类,所有的具体实现类都是通过SchedulerFactory工厂类实现,因此是需要配置调度工厂的,由他来调度任务
自定义SchedulerFactory(简单使用Quartz不需要自定义这个(注意)
)
@Bean
public SchedulerFactoryBean schedulerFactoryBean(DataSource dataSource)
{
SchedulerFactoryBean factory = new SchedulerFactoryBean();
factory.setDataSource(dataSource);
// quartz参数
Properties prop = new Properties();
prop.put("org.quartz.scheduler.instanceName", "RuoyiScheduler");
prop.put("org.quartz.scheduler.instanceId", "AUTO");
// 线程池配置
prop.put("org.quartz.threadPool.class", "org.quartz.simpl.SimpleThreadPool");
prop.put("org.quartz.threadPool.threadCount", "20");
prop.put("org.quartz.threadPool.threadPriority", "5");
// JobStore配置
prop.put("org.quartz.jobStore.class", "org.quartz.impl.jdbcjobstore.JobStoreTX");
// 集群配置
prop.put("org.quartz.jobStore.isClustered", "true");
prop.put("org.quartz.jobStore.clusterCheckinInterval", "15000");
prop.put("org.quartz.jobStore.maxMisfiresToHandleAtATime", "1");
prop.put("org.quartz.jobStore.txIsolationLevelSerializable", "true");
// sqlserver 启用
// prop.put("org.quartz.jobStore.selectWithLockSQL", "SELECT * FROM {0}LOCKS UPDLOCK WHERE LOCK_NAME = ?");
prop.put("org.quartz.jobStore.misfireThreshold", "12000");
prop.put("org.quartz.jobStore.tablePrefix", "QRTZ_");
factory.setQuartzProperties(prop);
factory.setSchedulerName("RuoyiScheduler");
// 延时启动
factory.setStartupDelay(1);
factory.setApplicationContextSchedulerContextKey("applicationContextKey");
// 可选,QuartzScheduler
// 启动时更新己存在的Job,这样就不用每次修改targetObject后删除qrtz_job_details表对应记录了
factory.setOverwriteExistingJobs(true);
// 设置自动启动,默认为true
factory.setAutoStartup(true);
return factory;
}
Trigger
常用方法
- withIdentity() 给触发器一些属性 比如名字,组名。
- storeDurably() 持久化存储
- withSchedule(ScheduleBuilder schedBuilder) 以某种触发器触发。
简单示例
JobDetail jobDetail = JobBuilder.newJob(QuartzJobBean.class)
.withIdentity("name1", "group1")
.storeDurably(true)
.build();
ScheduleBuilder(使用cronScheduler)
CronScheduleBuilder cronScheduleBuilder =
CronScheduleBuilder.cronSchedule(("0 0/5 * * * ?"));
@Bean
public Trigger storeUserLikeAndCountTrigger(){
CronTrigger cronTrigger = TriggerBuilder.newTrigger().forJob(storeUserLikeAndCountJobDetail())
.withIdentity("trigger1", "group1")
.withSchedule(CronScheduleBuilder.cronSchedule(("0 0/5 * * * ?")))
.startNow() //立即启动
.build();
return cronTrigger;
}
cron表达式写法
CornTrigger表达式的写法
* *
分别代表秒、分、时、日、月、周几
例子:
0 0 12 ? * 3 每周二中午 12 点执行任务
0 0 0 0 * ? 每月 1 日 0 点执行任务
字段 允许值 允许的特殊字符
秒 0-59 , - * /
分 0-59 , - * /
小时 0-23 , - * /
日期 1-31 , - * ? / L W C
月份 1-12 或者 JAN-DEC , - * /
星期 1-7 或者 SUN-SAT , - * ? / L C #
年(可选) 留空, 1970-2099 , - * /
表达式 意义
“0 0 12 ?” 每天中午12点触发
“0 15 10 ? ” 每天上午10:15触发
“0 15 10 ?” 每天上午10:15触发
“0 15 10 ? *” 每天上午10:15触发
“0 15 10 ? 2005” 2005年的每天上午10:15触发
“0 14 * ?” 在每天下午2点到下午2:59期间的每1分钟触发
“0 0/5 14 ?” 在每天下午2点到下午2:55期间的每5分钟触发
“0 0/5 14,18 ?” 在每天下午2点到2:55期间和下午6点到6:55期间的每5分钟触发
“0 0-5 14 ?” 在每天下午2点到下午2:05期间的每1分钟触发
“0 10,44 14 ? 3 WED” 每年三月的星期三的下午2:10和2:44触发
“0 15 10 ? * MON-FRI” 周一至周五的上午10:15触发
“0 15 10 15 * ?” 每月15日上午10:15触发
“0 15 10 L * ?” 每月最后一日的上午10:15触发
“0 15 10 ? * 6L” 每月的最后一个星期五上午10:15触发
“0 15 10 ? * 6L 2002-2005” 2002年至2005年的每月的最后一个星期五上午10:15触发
“0 15 10 ? * 6#3” 每月的第三个星期五上午10:15触发
特殊字符 意义
* 表示所有值;
? 表示未说明的值,即不关心它为何值;
- 表示一个指定的范围;
, 表示附加一个可能值;
/ 符号前表示开始时间,符号后表示每次递增的值;
L(“last”) (“last”) “L” 用在day-of-month字段意思是 “这个月最后一天”;用在 day-of-week字段, 它简单意思是 “7” or “SAT”。 如果在day-of-week字段里和数字联合使用,它的意思就是 “这个月的最后一个星期几” – 例如: “6L” means “这个月的最后一个星期五”. 当我们用“L”时,不指明一个列表值或者范围是很重要的,不然的话,我们会得到一些意想不到的结果。
W(“weekday”) 只能用在day-of-month字段。用来描叙最接近指定天的工作日(周一到周五)。例如:在day-of-month字段用“15W”指“最接近这个月第15天的工作日”,即如果这个月第15天是周六,那么触发器将会在这个月第14天即周五触发;如果这个月第15天是周日,那么触发器将会在这个月第16天即周一触发;如果这个月第15天是周二,那么就在触发器这天触发。
注意一点:这个用法只会在当前月计算值,不会越过当前月。“W”字符仅能在day-of-month指明一天,不能是一个范围或列表。也可以用“LW”来指定这个月的最后一个工作日。
只能用在day-of-week字段。用来指定这个月的第几个周几。例:在day-of-week字段用”6#3”指这个月第3个周五(6指周五,3指第3个)。如果指定的日期不存在,触发器就不会触发。
C 指和calendar联系后计算过的值。例:在day-of-month 字段用“5C”指在这个月第5天或之后包括calendar的第一天;在day-of-week字段用“1C”指在这周日或之后包括calendar的第一天
测试示例
导入依赖
<!-- quartz 任务调度-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-quartz</artifactId>
</dependency>
定义任务(调度器实际执行的是这的内部逻辑)
@Component
public class XXXXTask extends QuartzJobBean {
private static final Logger logger = LoggerFactory.getLogger(XXXTask.class);
private SimpleDateFormat sb = new SimpleDateFormat("yyyy-MM-dd hh:mm:ss");
@Override
@Transactional
protected void executeInternal(JobExecutionContext jobExecutionContext) throws JobExecutionException {
logger.info("storeVisitTask execute.. {}",sb.format(new Date()));
xxxxx
}
}
配置类
@Configuration
public class QuartzConfig {
@Bean
public JobDetail XXXJobDetail(){
JobDetail jobDetail = JobBuilder.newJob(XXXTask.class)
.withIdentity("XXXjobDetail;", "group1")
.storeDurably(true)
.build();
return jobDetail;
}
@Bean
public Trigger xxxxxTrigger(){
CronTrigger cronTrigger = TriggerBuilder.newTrigger().forJob(XXXJobDetail())
.withIdentity("xxxTrigger", "group1")
.withSchedule(CronScheduleBuilder.cronSchedule(("0 0/5 * * * ?")))
.startNow() //立即启动
.build();
return cronTrigger;
}
}
由触发器触发任务执行,执行逻辑在Job实现类