quartz 搭建详解

需求，在项目中增加定时任务。

       环境：hibernate + maven  + mysql

1. 阅读官方基本用例：

   http://www.quartz-scheduler.org/

2 . maven 加载依赖：

    

Quartz 2.2.x Maven Snippets

To include Quartz 2.2.x in your project, use:

  <dependency>    <groupId>org.quartz-scheduler</groupId>    <artifactId>quartz</artifactId>    <version>2.2.1</version>  </dependency>  <dependency>    <groupId>org.quartz-scheduler</groupId>    <artifactId>quartz-jobs</artifactId>    <version>2.2.1</version>  </dependency>   

3. 管理类

    

package xx;

import org.quartz.CronScheduleBuilder;import org.quartz.Job;import org.quartz.JobBuilder;import org.quartz.JobDetail;import org.quartz.JobKey;import org.quartz.Scheduler;import org.quartz.SchedulerException;import org.quartz.SchedulerFactory;import org.quartz.Trigger;import org.quartz.TriggerBuilder;import org.quartz.TriggerKey;import org.quartz.impl.StdSchedulerFactory;import bsh.ParseException;public class QuartzManager {// private static Logger logger = Logger.getLogger(QuartzManager.class.getName());private static SchedulerFactory gSchedulerFactory = new StdSchedulerFactory();/** * 添加一个定时任务 *  * @param jobName *            任务名 * @param jobGroupName *            任务组名 * @param triggerName *            触发器名 * @param triggerGroupName *            触发器组名 * @param jobClass *            任务 * @param time *            时间设置，参考quartz说明文档 * @throws SchedulerException * @throws ParseException */public static void addJob(String jobName, String jobGroupName, String triggerName, String triggerGroupName,Job jobClass, String time) {try {Scheduler scheduler = getScheduler();// define the job and tie it to our HelloJob classJobDetail job = JobBuilder.newJob(jobClass.getClass()).withIdentity(jobName, jobGroupName).build();Trigger trigger = TriggerBuilder.newTrigger().withIdentity(triggerName, triggerGroupName).withSchedule(CronScheduleBuilder.cronSchedule(time)).build();// Tell quartz to schedule the job using our triggerscheduler.scheduleJob(job, trigger);scheduler.start();} catch (Exception e) {e.printStackTrace();throw new RuntimeException(e);}}/** * 修改一个任务的触发时间 *  * @param triggerName * @param triggerGroupName * @param time * @throws SchedulerException */@SuppressWarnings({ "unchecked", "rawtypes" })public static void modifyJobTime(String triggerName, String triggerGroupName, String time) {try {Scheduler sched = getScheduler();TriggerKey triggerKey = TriggerKey.triggerKey(triggerName, triggerGroupName);// retrieve the triggerTrigger oldTrigger = sched.getTrigger(triggerKey);// obtain a builder that would produce the triggerTriggerBuilder tb = oldTrigger.getTriggerBuilder();// update the schedule associated with the builder, and build the// new trigger// (other builder methods could be called, to change the trigger in// any desired way)CronScheduleBuilder schedBuilder = CronScheduleBuilder.cronSchedule(time);Trigger newTrigger = tb.withSchedule(schedBuilder).build();sched.rescheduleJob(oldTrigger.getKey(), newTrigger);} catch (Exception e) {// TODO: handle exceptione.printStackTrace();}}/** * 移除一个任务 *  * @param jobName * @param jobGroupName * @param triggerName * @param triggerGroupName * @throws SchedulerException  */public static void removeJob(String jobName, String jobGroupName, String triggerName, String triggerGroupName) throws SchedulerException {getScheduler().deleteJob(JobKey.jobKey(jobName, jobGroupName));}/** * 查询一个任务 *  * @param jobName * @param jobGroupName * @throws SchedulerException  */public static boolean findJobByJobNameAndJobGroupName(String jobName, String jobGroupName) throws SchedulerException {JobDetail jobDetail = getScheduler().getJobDetail(new JobKey(jobName, jobGroupName));if (jobDetail != null) {return true;}return false;}public static Scheduler getScheduler() throws SchedulerException {return gSchedulerFactory.getScheduler();}/** * 启动所有定时任务 * @throws SchedulerException  */public static void startJobs() throws SchedulerException {getScheduler().start();}/** * 关闭所有定时任务 */public static void shutdownJobs() {try {Scheduler sched = getScheduler();if (!sched.isShutdown()) {sched.shutdown();}} catch (Exception e) {e.printStackTrace();throw new RuntimeException(e);}}public static void main(String[] args) {System.out.println("开始任务");// QuartzManager.addJob("jibName", "jobGroupName", "triggerName",// "triggerGroupName", new PrintPropsJob(), "0/3 * * * * ? *");// QuartzManager.addJob("jibName2", "jobGroupName", "triggerName2",// "triggerGroupName", new PrintPropsJob2(), "0/5 * * * * ? *");}}

4. 公共抽象类(需要事物管理，利用 hibernate)

   

import org.hibernate.Session;import org.hibernate.Transaction;import org.quartz.Job;import org.quartz.JobExecutionContext;import org.quartz.JobExecutionException;import org.quartz.SchedulerException;public abstract class CommonJob implements Job {public CommonJob() {// Instances of Job must have a public no-argument constructor.}@Overridepublic void execute(JobExecutionContext context) throws JobExecutionException {Session session = HibernateUtil.getSession();Transaction transaction = session.getTransaction();try {method(context);transaction.commit();} catch (Exception e) {if(transaction != null){transaction.rollback();}e.printStackTrace();} finally {HibernateUtil.closeSession();}}public abstract void method(JobExecutionContext context) throws SchedulerException;}

4. 具体实现类：

  需要继承CommonJob 并复写method 

  

public class xxJob extends CommonJob{protected GroupMailDAO groupMailDAO = new GroupMailDAOImpl();@Overridepublic void method(JobExecutionContext context) throws SchedulerException {//业务逻辑}}

5. 由于服务器重启后，内存中的定时任务将消失，所以需要配置：quartz.properties（WEB-INF/classes路径）

  

org.quartz.scheduler.instanceName = schedulerorg.quartz.threadPool.threadCount = 10org.quartz.jobStore.class = org.quartz.impl.jdbcjobstore.JobStoreTXorg.quartz.jobStore.driverDelegateClass = org.quartz.impl.jdbcjobstore.StdJDBCDelegateorg.quartz.jobStore.tablePrefix = QRTZ_org.quartz.jobStore.dataSource = dataSourceorg.quartz.dataSource.dataSource.driver = com.mysql.jdbc.Driverorg.quartz.dataSource.dataSource.URL = jdbc\:mysql\://localhost\:3306/quartz?useUnicode\=true&characterEncoding\=UTF8&zeroDateTimeBehavior\=convertToNull&serverTimezone\=America/New_York&useSSL\=falseorg.quartz.dataSource.dataSource.user = rootorg.quartz.dataSource.dataSource.password = adminorg.quartz.dataSource.dataSource.maxConnections =10

 内容：http://www.quartz-scheduler.org/documentation/quartz-2.2.x/configuration/ConfigJobStoreTX.html

6. mysql  定时任务表结构：（MONGODB自动创建，未验证）

  

## Quartz seems to work best with the driver mm.mysql-2.0.7-bin.jar## PLEASE consider using mysql with innodb tables to avoid locking issues## In your Quartz properties file, you'll need to set # org.quartz.jobStore.driverDelegateClass = org.quartz.impl.jdbcjobstore.StdJDBCDelegate#DROP TABLE IF EXISTS QRTZ_FIRED_TRIGGERS;DROP TABLE IF EXISTS QRTZ_PAUSED_TRIGGER_GRPS;DROP TABLE IF EXISTS QRTZ_SCHEDULER_STATE;DROP TABLE IF EXISTS QRTZ_LOCKS;DROP TABLE IF EXISTS QRTZ_SIMPLE_TRIGGERS;DROP TABLE IF EXISTS QRTZ_SIMPROP_TRIGGERS;DROP TABLE IF EXISTS QRTZ_CRON_TRIGGERS;DROP TABLE IF EXISTS QRTZ_BLOB_TRIGGERS;DROP TABLE IF EXISTS QRTZ_TRIGGERS;DROP TABLE IF EXISTS QRTZ_JOB_DETAILS;DROP TABLE IF EXISTS QRTZ_CALENDARS;CREATE TABLE QRTZ_JOB_DETAILS  (    SCHED_NAME VARCHAR(120) NOT NULL,    JOB_NAME  VARCHAR(200) NOT NULL,    JOB_GROUP VARCHAR(200) NOT NULL,    DESCRIPTION VARCHAR(250) NULL,    JOB_CLASS_NAME   VARCHAR(250) NOT NULL,    IS_DURABLE VARCHAR(1) NOT NULL,    IS_NONCONCURRENT VARCHAR(1) NOT NULL,    IS_UPDATE_DATA VARCHAR(1) NOT NULL,    REQUESTS_RECOVERY VARCHAR(1) NOT NULL,    JOB_DATA BLOB NULL,    PRIMARY KEY (SCHED_NAME,JOB_NAME,JOB_GROUP));CREATE TABLE QRTZ_TRIGGERS  (    SCHED_NAME VARCHAR(120) NOT NULL,    TRIGGER_NAME VARCHAR(200) NOT NULL,    TRIGGER_GROUP VARCHAR(200) NOT NULL,    JOB_NAME  VARCHAR(200) NOT NULL,    JOB_GROUP VARCHAR(200) NOT NULL,    DESCRIPTION VARCHAR(250) NULL,    NEXT_FIRE_TIME BIGINT(13) NULL,    PREV_FIRE_TIME BIGINT(13) NULL,    PRIORITY INTEGER NULL,    TRIGGER_STATE VARCHAR(16) NOT NULL,    TRIGGER_TYPE VARCHAR(8) NOT NULL,    START_TIME BIGINT(13) NOT NULL,    END_TIME BIGINT(13) NULL,    CALENDAR_NAME VARCHAR(200) NULL,    MISFIRE_INSTR SMALLINT(2) NULL,    JOB_DATA BLOB NULL,    PRIMARY KEY (SCHED_NAME,TRIGGER_NAME,TRIGGER_GROUP),    FOREIGN KEY (SCHED_NAME,JOB_NAME,JOB_GROUP)        REFERENCES QRTZ_JOB_DETAILS(SCHED_NAME,JOB_NAME,JOB_GROUP));CREATE TABLE QRTZ_SIMPLE_TRIGGERS  (    SCHED_NAME VARCHAR(120) NOT NULL,    TRIGGER_NAME VARCHAR(200) NOT NULL,    TRIGGER_GROUP VARCHAR(200) NOT NULL,    REPEAT_COUNT BIGINT(7) NOT NULL,    REPEAT_INTERVAL BIGINT(12) NOT NULL,    TIMES_TRIGGERED BIGINT(10) NOT NULL,    PRIMARY KEY (SCHED_NAME,TRIGGER_NAME,TRIGGER_GROUP),    FOREIGN KEY (SCHED_NAME,TRIGGER_NAME,TRIGGER_GROUP)        REFERENCES QRTZ_TRIGGERS(SCHED_NAME,TRIGGER_NAME,TRIGGER_GROUP));CREATE TABLE QRTZ_CRON_TRIGGERS  (    SCHED_NAME VARCHAR(120) NOT NULL,    TRIGGER_NAME VARCHAR(200) NOT NULL,    TRIGGER_GROUP VARCHAR(200) NOT NULL,    CRON_EXPRESSION VARCHAR(200) NOT NULL,    TIME_ZONE_ID VARCHAR(80),    PRIMARY KEY (SCHED_NAME,TRIGGER_NAME,TRIGGER_GROUP),    FOREIGN KEY (SCHED_NAME,TRIGGER_NAME,TRIGGER_GROUP)        REFERENCES QRTZ_TRIGGERS(SCHED_NAME,TRIGGER_NAME,TRIGGER_GROUP));CREATE TABLE QRTZ_SIMPROP_TRIGGERS  (              SCHED_NAME VARCHAR(120) NOT NULL,    TRIGGER_NAME VARCHAR(200) NOT NULL,    TRIGGER_GROUP VARCHAR(200) NOT NULL,    STR_PROP_1 VARCHAR(512) NULL,    STR_PROP_2 VARCHAR(512) NULL,    STR_PROP_3 VARCHAR(512) NULL,    INT_PROP_1 INT NULL,    INT_PROP_2 INT NULL,    LONG_PROP_1 BIGINT NULL,    LONG_PROP_2 BIGINT NULL,    DEC_PROP_1 NUMERIC(13,4) NULL,    DEC_PROP_2 NUMERIC(13,4) NULL,    BOOL_PROP_1 VARCHAR(1) NULL,    BOOL_PROP_2 VARCHAR(1) NULL,    PRIMARY KEY (SCHED_NAME,TRIGGER_NAME,TRIGGER_GROUP),    FOREIGN KEY (SCHED_NAME,TRIGGER_NAME,TRIGGER_GROUP)     REFERENCES QRTZ_TRIGGERS(SCHED_NAME,TRIGGER_NAME,TRIGGER_GROUP));CREATE TABLE QRTZ_BLOB_TRIGGERS  (    SCHED_NAME VARCHAR(120) NOT NULL,    TRIGGER_NAME VARCHAR(200) NOT NULL,    TRIGGER_GROUP VARCHAR(200) NOT NULL,    BLOB_DATA BLOB NULL,    PRIMARY KEY (SCHED_NAME,TRIGGER_NAME,TRIGGER_GROUP),    FOREIGN KEY (SCHED_NAME,TRIGGER_NAME,TRIGGER_GROUP)        REFERENCES QRTZ_TRIGGERS(SCHED_NAME,TRIGGER_NAME,TRIGGER_GROUP));CREATE TABLE QRTZ_CALENDARS  (    SCHED_NAME VARCHAR(120) NOT NULL,    CALENDAR_NAME  VARCHAR(200) NOT NULL,    CALENDAR BLOB NOT NULL,    PRIMARY KEY (SCHED_NAME,CALENDAR_NAME));CREATE TABLE QRTZ_PAUSED_TRIGGER_GRPS  (    SCHED_NAME VARCHAR(120) NOT NULL,    TRIGGER_GROUP  VARCHAR(200) NOT NULL,     PRIMARY KEY (SCHED_NAME,TRIGGER_GROUP));CREATE TABLE QRTZ_FIRED_TRIGGERS  (    SCHED_NAME VARCHAR(120) NOT NULL,    ENTRY_ID VARCHAR(95) NOT NULL,    TRIGGER_NAME VARCHAR(200) NOT NULL,    TRIGGER_GROUP VARCHAR(200) NOT NULL,    INSTANCE_NAME VARCHAR(200) NOT NULL,    FIRED_TIME BIGINT(13) NOT NULL,    SCHED_TIME BIGINT(13) NOT NULL,    PRIORITY INTEGER NOT NULL,    STATE VARCHAR(16) NOT NULL,    JOB_NAME VARCHAR(200) NULL,    JOB_GROUP VARCHAR(200) NULL,    IS_NONCONCURRENT VARCHAR(1) NULL,    REQUESTS_RECOVERY VARCHAR(1) NULL,    PRIMARY KEY (SCHED_NAME,ENTRY_ID));CREATE TABLE QRTZ_SCHEDULER_STATE  (    SCHED_NAME VARCHAR(120) NOT NULL,    INSTANCE_NAME VARCHAR(200) NOT NULL,    LAST_CHECKIN_TIME BIGINT(13) NOT NULL,    CHECKIN_INTERVAL BIGINT(13) NOT NULL,    PRIMARY KEY (SCHED_NAME,INSTANCE_NAME));CREATE TABLE QRTZ_LOCKS  (    SCHED_NAME VARCHAR(120) NOT NULL,    LOCK_NAME  VARCHAR(40) NOT NULL,     PRIMARY KEY (SCHED_NAME,LOCK_NAME));

7. 配置web.xml 保证重启后可以加载数据库中存在的定时任务

  

<servlet><servlet-name>QuartzInitializer</servlet-name><servlet-class>org.quartz.ee.servlet.QuartzInitializerServlet</servlet-class><init-param><param-name>shutdown-on-unload</param-name><param-value>true</param-value></init-param><init-param><param-name>config-file</param-name><param-value>quartz.properties</param-value></init-param><load-on-startup>1</load-on-startup></servlet>