【轉(zhuǎn)載請注明出處】：http://www.lxweimin.com/p/7c6e63c88dc2
這篇文章我寫的是集群方式的，如果是單節(jié)點且不需要持久化可以參考文章http://www.lxweimin.com/p/fe257adc331d
1、依賴jar包
如果使用的是Spring cloud 微服務(wù)架構(gòu)，查看官網(wǎng)發(fā)現(xiàn)目前中央倉庫中還沒有 spring-boot-starter-quartz ，只有在spring 的官方倉庫中有
image.png
路徑http://repo.spring.io/milestone/org/springframework/boot/spring-boot-starter-quartz/
要用的話需要手動指定版本
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-quartz</artifactId>
<version>2.0.0.M2</version>
</dependency>
image.png
既然是這樣，我們不如直接引用這幾個jar包省事，還能根據(jù)自己的項目環(huán)境選擇合適的版本
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-jdbc</artifactId>
</dependency>
<dependency>
<groupId>org.quartz-scheduler</groupId>
<artifactId>quartz</artifactId>
<version>2.3.0</version>
</dependency>
<dependency>
<groupId>org.quartz-scheduler</groupId>
<artifactId>quartz-jobs</artifactId>
<version>2.3.0</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context-support</artifactId>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-tx</artifactId>
</dependency>
我的是Spring cloud項目，和spring相關(guān)的沒有指定具體版本，各位視情況而定，如果是單純的Spring boot項目，手動指定下版本號即可。
2、數(shù)據(jù)庫配置
由于分布式的quartz需要將任務(wù)和觸發(fā)器持久化到數(shù)據(jù)庫，這樣就的為quartz配置一套數(shù)據(jù)源，而一般的項目如果有其他的業(yè)務(wù)需要操作數(shù)據(jù)庫，項目中本身需要為spring配置一套數(shù)據(jù)源，這樣在同一個運行環(huán)境中就會同時有兩套數(shù)據(jù)源的配置，如果不是有特殊需求，通一個環(huán)境有一套配置足以。在網(wǎng)上也看了好多集成的例子，但是都是配置兩套，當時的直覺告訴我一套是可以的，當時也試了一些方式，后來自己摸索出來了，直接說我的實現(xiàn)方式，其他的省略，要看的話可以直接去官網(wǎng)看一眼，下面以msql數(shù)據(jù)庫為例，其他類似。
image.png
quartz.properties
org.quartz.scheduler.instanceName=test-schedule
org.quartz.scheduler.instanceId=AUTO
org.quartz.jobStore.class=org.quartz.impl.jdbcjobstore.JobStoreTX
org.quartz.jobStore.driverDelegateClass=org.quartz.impl.jdbcjobstore.StdJDBCDelegate
org.quartz.jobStore.tablePrefix=QRTZ_
org.quartz.jobStore.isClustered=true
org.quartz.jobStore.useProperties=false
org.quartz.jobStore.clusterCheckinInterval=20000
org.quartz.scheduler.skipUpdateCheck=true
org.quartz.threadPool.class=org.quartz.simpl.SimpleThreadPool
org.quartz.threadPool.threadCount=10
org.quartz.threadPool.threadPriority=5
org.quartz.threadPool.threadsInheritContextClassLoaderOfInitializingThread=true
application-dev.properties相關(guān)部分
server.port=8084
spring.application.name=test-schedule
server.tomcat.max-http-header-size=8192
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/test-schedule?useUnicode=true&autoReconnect=true&rewriteBatchedStatements=TRUE&useSSL=false
spring.datasource.username=root
spring.datasource.password=123456
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
QuartzJobFactory
import org.quartz.spi.TriggerFiredBundle;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.config.AutowireCapableBeanFactory;
import org.springframework.scheduling.quartz.AdaptableJobFactory;
import org.springframework.stereotype.Component;
/**
* <p>Job工廠</p>
* <PRE>
* <BR> 修改記錄
* <BR>-----------------------------------------------
* <BR> 修改日期 修改人 修改內(nèi)容
* </PRE>
*
* @author zl
* @version 1.0
* @date Created in 2017/12/16 15:48
* @copyright: Copyright (c) founders
*/
@Component
public class QuartzJobFactory extends AdaptableJobFactory {
@Autowired
private AutowireCapableBeanFactory capableBeanFactory;
@Override
protected Object createJobInstance(TriggerFiredBundle bundle) throws Exception {
Object jobInstance = super.createJobInstance(bundle);
capableBeanFactory.autowireBean(jobInstance);
return jobInstance;
}
}
QuartzConfig
import org.quartz.Scheduler;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.io.ClassPathResource;
import org.springframework.scheduling.quartz.SchedulerFactoryBean;
import javax.sql.DataSource;
/**
* <p>Quartz配置</p>
* <PRE>
* <BR> 修改記錄
* <BR>-----------------------------------------------
* <BR> 修改日期 修改人 修改內(nèi)容
* </PRE>
*
* @author zl
* @version 1.0
* @date Created in 2017/12/16 15:33
* @copyright: Copyright (c) founders
*/
@Configuration
public class QuartzConfig {
@Autowired
DataSource dataSource;
@Bean
public SchedulerFactoryBean schedulerFactoryBean (QuartzJobFactory quartzJobFactory) throws Exception {
SchedulerFactoryBean factoryBean=new SchedulerFactoryBean();
factoryBean.setJobFactory(quartzJobFactory);
factoryBean.setConfigLocation(new ClassPathResource("quartz.properties"));
factoryBean.setDataSource(dataSource);
factoryBean.afterPropertiesSet();
return factoryBean;
}
@Bean
public Scheduler scheduler(SchedulerFactoryBean schedulerFactoryBean) throws Exception {
Scheduler scheduler=schedulerFactoryBean.getScheduler();
scheduler.start();
return scheduler;
}
}
到這里，配置部分已經(jīng)結(jié)束了，還需要創(chuàng)建一下數(shù)據(jù)庫就可以安心寫具體job了。
在quartz-2.3.0.jar這個jar包的org.quartz.impl.jdbcjobstore包下有對應(yīng)的各種數(shù)據(jù)庫的初始化sql腳本
image.png
3、job
BaseJob
import org.quartz.Job;
import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;
/**
* <p>job接口</p>
* <PRE>
* <BR> 修改記錄
* <BR>-----------------------------------------------
* <BR> 修改日期 修改人 修改內(nèi)容
* </PRE>
*
* @author zl
* @version 1.0
* @date Created in 2017/12/16 15:57
* @copyright: Copyright (c) founders
*/
public interface BaseJob extends Job {
@Override
void execute(JobExecutionContext context) throws JobExecutionException;
}
TestJob
import lombok.extern.slf4j.Slf4j;
import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;
import org.springframework.stereotype.Component;
/**
* <p>Test Job</p>
* <PRE>
* <BR> 修改記錄
* <BR>-----------------------------------------------
* <BR> 修改日期 修改人 修改內(nèi)容
* </PRE>
*
* @author zl
* @version 1.0
* @date Created in 2017/12/16 16:14
* @copyright: Copyright (c) founders
*/
@Slf4j
@Component
@DisallowConcurrentExecution
public class TestJob implements BaseJob {
@Override
public void execute(JobExecutionContext context) throws JobExecutionException {
log.info("test job----PreviousFireTime={},NextFireTime={},FireTime={}" ,context.getPreviousFireTime(),context.getNextFireTime(),context.getFireTime());
}
}
@DisallowConcurrentExecution意思是不允許并發(fā)執(zhí)行，也就是說當Job的執(zhí)行時間（如執(zhí)行完需要30s）大于job的執(zhí)行時間間隔（如10s），默認情況下，quartz為了能讓job按照預(yù)定的時間間隔執(zhí)行，會馬上啟用新的線程執(zhí)行job。
這個時候啟動項目，然后在數(shù)據(jù)庫qrtz_cron_triggers、qrtz_job_details、qrtz_triggers這三個表添加相應(yīng)的任務(wù)和觸發(fā)器，如果添加的正確，job是可以跑起來的，下面我再介紹下job的管理。
4、job管理
TaskInfoVo
import lombok.Data;
import java.util.Date;
/**
* <p>task</p>
* <PRE>
* <BR> 修改記錄
* <BR>-----------------------------------------------
* <BR> 修改日期 修改人 修改內(nèi)容
* </PRE>
*
* @author zl
* @version 1.0
* @date Created in 2017/12/16 22:00
* @copyright: Copyright (c) founders
*/
@Data
public class TaskInfoVo {
private String jobName;
private String jobGroup;
private String jobDescription;
private String jobStatus;
private String cronExpression;
private String createTime;
private Date previousFireTime;
private Date nextFireTime;
}
JobService 這個類拿去直接是可以用的，注意我用了lombok
import com.sunlands.zlcx.schedule.exception.BusinessException;
import com.sunlands.zlcx.schedule.vo.PageResultVO;
import com.sunlands.zlcx.schedule.vo.TaskInfoVo;
import lombok.extern.slf4j.Slf4j;
import org.apache.commons.lang3.StringUtils;
import org.quartz.*;
import org.quartz.impl.matchers.GroupMatcher;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.text.SimpleDateFormat;
import java.util.ArrayList;
import java.util.Date;
import java.util.HashSet;
import java.util.List;
import java.util.stream.Collectors;
/**
* <p>Job管理</p>
* <PRE>
* <BR> 修改記錄
* <BR>-----------------------------------------------
* <BR> 修改日期 修改人 修改內(nèi)容
* </PRE>
*
* @author zl
* @version 1.0
* @date Created in 2017/12/16 21:58
* @copyright: Copyright (c) founders
*/
@Service
@Slf4j
public class JobService {
@Autowired
private Scheduler scheduler;
/**
* 分頁查詢
*
* @return
*/
public PageResultVO<TaskInfoVo> list(int page, int size) {
PageResultVO<TaskInfoVo> resultVO = new PageResultVO<TaskInfoVo>();
try {
List<TaskInfoVo> list = new ArrayList<>();
for (String groupJob : scheduler.getJobGroupNames()) {
for (JobKey jobKey : scheduler.getJobKeys(GroupMatcher.<JobKey>groupEquals(groupJob))) {
List<? extends Trigger> triggers = scheduler.getTriggersOfJob(jobKey);
for (Trigger trigger : triggers) {
Trigger.TriggerState triggerState = scheduler.getTriggerState(trigger.getKey());
JobDetail jobDetail = scheduler.getJobDetail(jobKey);
String cronExpression = "", createTime = "";
if (trigger instanceof CronTrigger) {
CronTrigger cronTrigger = (CronTrigger) trigger;
cronExpression = cronTrigger.getCronExpression();
createTime = cronTrigger.getDescription();
}
TaskInfoVo info = new TaskInfoVo();
info.setJobName(jobKey.getName());
info.setJobGroup(jobKey.getGroup());
info.setJobDescription(jobDetail.getDescription());
info.setJobStatus(triggerState.name());
info.setCronExpression(cronExpression);
info.setCreateTime(createTime);
info.setPreviousFireTime(trigger.getPreviousFireTime());
info.setNextFireTime(trigger.getNextFireTime());
list.add(info);
}
}
}
resultVO.setTotal(list.size());
resultVO.setRows(list.stream().skip((page - 1) * size).limit(size).collect(Collectors.toList()));
} catch (SchedulerException e) {
log.error("分頁查詢定時任務(wù)失敗，page={},size={},e={}", page, size, e);
}
return resultVO;
}
/**
* 添加
*
* @param jobName
* @param jobGroup
* @param cronExpression
* @param jobDescription
*/
public void addJob(String jobName, String jobGroup, String cronExpression, String jobDescription) {
if (StringUtils.isAnyBlank(jobName, jobGroup, cronExpression, jobDescription)) {
throw new BusinessException(String.format("參數(shù)錯誤, jobName={},jobGroup={},cronExpression={},jobDescription={}", jobName, jobGroup, cronExpression, jobDescription));
}
String createTime = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date());
try {
log.info("添加jobName={},jobGroup={},cronExpression={},jobDescription={}", jobName, jobGroup, cronExpression, jobDescription);
if (checkExists(jobName, jobGroup)) {
log.error("Job已經(jīng)存在, jobName={},jobGroup={}", jobName, jobGroup);
throw new BusinessException(String.format("Job已經(jīng)存在, jobName={},jobGroup={}", jobName, jobGroup));
}
TriggerKey triggerKey = TriggerKey.triggerKey(jobName, jobGroup);
JobKey jobKey = JobKey.jobKey(jobName, jobGroup);
CronScheduleBuilder schedBuilder = CronScheduleBuilder.cronSchedule(cronExpression).withMisfireHandlingInstructionDoNothing();
CronTrigger trigger = TriggerBuilder.newTrigger().withIdentity(triggerKey).withDescription(createTime).withSchedule(schedBuilder).build();
Class<? extends Job> clazz = (Class<? extends Job>) Class.forName(jobName);
JobDetail jobDetail = JobBuilder.newJob(clazz).withIdentity(jobKey).withDescription(jobDescription).build();
scheduler.scheduleJob(jobDetail, trigger);
} catch (SchedulerException | ClassNotFoundException e) {
log.error("添加job失敗, jobName={},jobGroup={},e={}", jobName, jobGroup, e);
throw new BusinessException("類名不存在或執(zhí)行表達式錯誤");
}
}
/**
* 修改
*
* @param jobName
* @param jobGroup
* @param cronExpression
* @param jobDescription
*/
public void edit(String jobName, String jobGroup, String cronExpression, String jobDescription) {
if (StringUtils.isAnyBlank(jobName, jobGroup, cronExpression, jobDescription)) {
throw new BusinessException(String.format("參數(shù)錯誤, jobName={},jobGroup={},cronExpression={},jobDescription={}", jobName, jobGroup, cronExpression, jobDescription));
}
String createTime = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date());
try {
log.info("修改jobName={},jobGroup={},cronExpression={},jobDescription={}", jobName, jobGroup, cronExpression, jobDescription);
if (!checkExists(jobName, jobGroup)) {
log.error("Job不存在, jobName={},jobGroup={}", jobName, jobGroup);
throw new BusinessException(String.format("Job不存在, jobName={},jobGroup={}", jobName, jobGroup));
}
TriggerKey triggerKey = TriggerKey.triggerKey(jobName, jobGroup);
JobKey jobKey = new JobKey(jobName, jobGroup);
CronScheduleBuilder cronScheduleBuilder = CronScheduleBuilder.cronSchedule(cronExpression).withMisfireHandlingInstructionDoNothing();
CronTrigger cronTrigger = TriggerBuilder.newTrigger().withIdentity(triggerKey).withDescription(createTime).withSchedule(cronScheduleBuilder).build();
JobDetail jobDetail = scheduler.getJobDetail(jobKey);
jobDetail.getJobBuilder().withDescription(jobDescription);
HashSet<Trigger> triggerSet = new HashSet<>();
triggerSet.add(cronTrigger);
scheduler.scheduleJob(jobDetail, triggerSet, true);
} catch (SchedulerException e) {
log.error("修改job失敗, jobName={},jobGroup={},e={}", jobName, jobGroup, e);
throw new BusinessException("類名不存在或執(zhí)行表達式錯誤");
}
}
/**
* 刪除
*
* @param jobName
* @param jobGroup
*/
public void delete(String jobName, String jobGroup) {
try {
log.info("刪除jobName={},jobGroup={}", jobName, jobGroup);
TriggerKey triggerKey = TriggerKey.triggerKey(jobName, jobGroup);
if (checkExists(jobName, jobGroup)) {
scheduler.pauseTrigger(triggerKey);
scheduler.unscheduleJob(triggerKey);
}
} catch (SchedulerException e) {
log.error("刪除job失敗, jobName={},jobGroup={},e={}", jobName, jobGroup, e);
throw new BusinessException(e.getMessage());
}
}
/**
* 暫停
*
* @param jobName
* @param jobGroup
*/
public void pause(String jobName, String jobGroup) {
try {
log.info("暫停jobName={},jobGroup={}", jobName, jobGroup);
TriggerKey triggerKey = TriggerKey.triggerKey(jobName, jobGroup);
if (!checkExists(jobName, jobGroup)) {
log.error("Job不存在, jobName={},jobGroup={}", jobName, jobGroup);
throw new BusinessException(String.format("Job不存在, jobName={},jobGroup={}", jobName, jobGroup));
}
scheduler.pauseTrigger(triggerKey);
} catch (SchedulerException e) {
log.error("暫停job失敗, jobName={},jobGroup={},e={}", jobName, jobGroup, e);
throw new BusinessException(e.getMessage());
}
}
/**
* 重啟
*
* @param jobName
* @param jobGroup
*/
public void resume(String jobName, String jobGroup) {
try {
log.info("重啟jobName={},jobGroup={}", jobName, jobGroup);
TriggerKey triggerKey = TriggerKey.triggerKey(jobName, jobGroup);
if (!checkExists(jobName, jobGroup)) {
log.error("Job不存在, jobName={},jobGroup={}", jobName, jobGroup);
throw new BusinessException(String.format("Job不存在, jobName={},jobGroup={}", jobName, jobGroup));
}
scheduler.resumeTrigger(triggerKey);
} catch (SchedulerException e) {
log.error("重啟job失敗, jobName={},jobGroup={},e={}", jobName, jobGroup, e);
throw new BusinessException(e.getMessage());
}
}
/**
* 立即執(zhí)行
*
* @param jobName
* @param jobGroup
*/
public void trigger(String jobName, String jobGroup) {
try {
log.info("立即執(zhí)行jobName={},jobGroup={}", jobName, jobGroup);
if (!checkExists(jobName, jobGroup)) {
log.error("Job不存在, jobName={},jobGroup={}", jobName, jobGroup);
throw new BusinessException(String.format("Job不存在, jobName={},jobGroup={}", jobName, jobGroup));
}
JobKey jobKey = new JobKey(jobName, jobGroup);
scheduler.triggerJob(jobKey);
} catch (SchedulerException e) {
log.error("立即執(zhí)行job失敗, jobName={},jobGroup={},e={}", jobName, jobGroup, e);
throw new BusinessException(e.getMessage());
}
}
/**
* 驗證是否存在
*
* @param jobName
* @param jobGroup
* @throws SchedulerException
*/
private boolean checkExists(String jobName, String jobGroup) throws SchedulerException {
TriggerKey triggerKey = TriggerKey.triggerKey(jobName, jobGroup);
return scheduler.checkExists(triggerKey);
}
}
Controller和頁面我就不拿出來了，自行寫一下即可，可以寫個測試類跑一下。
【轉(zhuǎn)載請注明出處】：http://www.lxweimin.com/p/7c6e63c88dc2
