Quartz框架调用Demo

Quartz框架调用Demo

任务调度在JAVA应用程序中运用的十分普遍，掌握QUARTZ是必备的技能;

官网：http://www.quartz-scheduler.org/ 下载最新1.80资源包

commons-logging、log4j、slf4j 等jar包要添加进去,quartz的jar包则肯定必须;

实例：文件一（执行具体任务class）

public class QuartzDemo implements Job{  

    @Override
    public void execute(JobExecutionContext arg0) throws JobExecutionException {
        System.out.println("Quartz执行.......");  

    }  

}  

文件二：

public class QuartzManager{
    private static final SimpleTrigger CronTrigger = null;  

    public static void main(String[] args){
    }  

    public void simpleDemo(){
          //通过SchedulerFactory来获取一个调度器
        SchedulerFactory schedulerFactory = new StdSchedulerFactory();
        Scheduler scheduler;
        try {
            scheduler = schedulerFactory.getScheduler();  

        //引进作业程序
        JobDetail jobDetail =
        new JobDetail("jobDetail-s1", "jobDetailGroup-s1", QuartzDemo.class);  

         //new一个触发器
        SimpleTrigger simpleTrigger =
        new SimpleTrigger("simpleTrigger", "triggerGroup-s1");  

        //设置作业启动时间  

        long ctime = System.currentTimeMillis();
        simpleTrigger.setStartTime(new Date(ctime));  

        //设置作业执行间隔
        simpleTrigger.setRepeatInterval(1000);  

        //设置作业执行次数
        simpleTrigger.setRepeatCount(10);  

        //设置作业执行优先级默认为5
        //simpleTrigger.setPriority(10);  

        //作业和触发器设置到调度器中
        scheduler.scheduleJob(jobDetail, simpleTrigger);  

        //启动调度器
        scheduler.start();
        } catch (SchedulerException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
    }  

    public void cronDemo(){  

        try    {
            SchedulerFactory schedFact  =   new  org.quartz.impl.StdSchedulerFactory();
            Scheduler sched  =  schedFact.getScheduler();
            sched.start();
            JobDetail jobDetail  =   new  JobDetail( " Income Report " ,
                     " Report Generation " , QuartzDemo.class );
            jobDetail.getJobDataMap().put( " type " ,  " FULL " );
            CronTrigger trigger  =   new  CronTrigger( " Income Report " ,
                     " Report Generation " );
             /**/ /*  每1分钟执行一次  */
            trigger.setCronExpression( "0 33 16 * * ?" );
            sched.scheduleJob(jobDetail, trigger);
        }   catch  (Exception e)   {
            e.printStackTrace();
        }
    }  

    public void caledarDemo(){
         //通过SchedulerFactory来获取一个调度器
      SchedulerFactory schedulerFactory = new StdSchedulerFactory();
      Scheduler scheduler;
        try {
            scheduler = schedulerFactory.getScheduler();
      //引进作业程序
      JobDetail jobDetail =
      new JobDetail("jobDetail-s1", "jobDetailGroup-s1", QuartzDemo.class);
       //new一个触发器
      CronTrigger simpleTrigger =
        new CronTrigger("trigger", "group", "job", "group", "16 26/1 8-17 * * ?");
     // new SimpleTrigger("simpleTrigger", "triggerGroup-s1");  

      //设置作业启动时间
    //Calendar excelCal = Calendar.getInstance();
        //excelCal.add(Calendar.DAY_OF_MONTH, 1);
        ///excelCal.set(Calendar.HOUR_OF_DAY, 16);
        //excelCal.set(Calendar.SECOND, 0);
        //excelCal.add(Calendar.MINUTE, 9);
     // long ctime = System.currentTimeMillis();
     // simpleTrigger.setStartTime(excelCal.getTime());
      //设置作业执行间隔
     // simpleTrigger.setRepeatInterval(1000);
      //设置作业执行次数
     // simpleTrigger.setRepeatCount(10);
      //设置作业执行优先级默认为5
      //simpleTrigger.setPriority(10);  

      //作业和触发器设置到调度器中
      scheduler.scheduleJob(jobDetail, simpleTrigger);  

      //启动调度器
      scheduler.start();
        } catch (SchedulerException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        } catch (ParseException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }  

    }  

}  

需要注意的几点是经常会出现org.quartz.core.ErrorLogger : An error occured instantiating job to be executed.....这种异常，解决办法是

1）Job类必须有默认的无参构造方法，当然不覆盖的话类本身就是无参的构造方法  

2）Job的scope必须是Public类型的，因为quartz根据反射机制实例化类，如果不是public的，无法对其暴露  

3)  Job类不能是内部类，原因同上，所以最好单独建类  

Quartz的配置文件：quartz.properties详解

# Configure Main Scheduler Properties
org.quartz.scheduler.instanceName = TestScheduler
org.quartz.scheduler.instanceId = one
# Configure ThreadPool
org.quartz.threadPool.class = org.quartz.simpl.SimpleThreadPool
org.quartz.threadPool.threadCount =  5
org.quartz.threadPool.threadPriority = 4
# Configure JobStore
org.quartz.jobStore.misfireThreshold = 5000
org.quartz.jobStore.class = org.quartz.simpl.RAMJobStore  

附：cronExpression配置说明  

字段   允许值   允许的特殊字符
秒    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提供管理任务的Java代码：

/**
  * Package Name:nc.xyzq.common.task
  * Date:2019年01月24日下午3:06:49
  * @author lizm
  *
  */  

package nc.xyzq.common.task;

import org.quartz.CronTrigger;
import org.quartz.JobDetail;
import org.quartz.Scheduler;
import org.quartz.SchedulerFactory;
import org.quartz.impl.StdSchedulerFactory;

//任务管理器
public class QuartzManager {
    private static SchedulerFactory gSchedulerFactory = new StdSchedulerFactory();

    private static String JOB_GROUP_NAME = "EXTJWEB_JOBGROUP_NAME";
    private static String TRIGGER_GROUP_NAME = "EXTJWEB_TRIGGERGROUP_NAME";

    /**
     * 添加一个定时任务，使用默认的任务组名，触发器名，触发器组名
     *
     * @param jobName 任务名
     * @param jobClass  任务
     * @param time  时间设置，参考quartz说明文档
     *
     */
    public static void addJob(String jobName, String jobClass, String time) {

         try {
             //System.out.println("addJob>>>1111>>Apache Tomcat v6.0.32 at localhost:"+jobName+" jobClass:"+jobClass+" time:"+time);
            //通过SchedulerFactory来获取一个调度器
            Scheduler sched = gSchedulerFactory.getScheduler();
            //引进作业程序
            JobDetail jobDetail = new JobDetail(jobName, JOB_GROUP_NAME, Class
                    .forName(jobClass));// 任务名，任务组，任务执行类
             //new一个触发器
            CronTrigger trigger = new CronTrigger(jobName, TRIGGER_GROUP_NAME);
            // 触发器时间设定
            trigger.setCronExpression(time);
            sched.scheduleJob(jobDetail, trigger);
            // 启动
            if (!sched.isShutdown()) {
                sched.start();
            }
        } catch (Exception e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }

    }

    /**
     * 添加一个定时任务
     *
     * @param jobName 任务名
     * @param jobGroupName 任务组名
     * @param triggerName 触发器名
     * @param triggerGroupName 触发器组名
     * @param jobClass 任务
     * @param time 时间设置，参考quartz说明文档
     */
    public static void addJob(String jobName, String jobGroupName,
            String triggerName, String triggerGroupName, String jobClass,
            String time) {
        try {
            //通过SchedulerFactory来获取一个调度器
            Scheduler sched = gSchedulerFactory.getScheduler();
            //引进作业程序
            JobDetail jobDetail = new JobDetail(jobName, jobGroupName, Class
                    .forName(jobClass));// 任务名，任务组，任务执行类
            //触发器
            CronTrigger trigger = new CronTrigger(triggerName, triggerGroupName);
            // 触发器时间设定
            trigger.setCronExpression(time);
            sched.scheduleJob(jobDetail, trigger);
            // 启动
            if (!sched.isShutdown()) {
                sched.start();
            }
        } catch (Exception e) {
            e.printStackTrace();
            throw new RuntimeException(e);
        }
    }

    /**
     * 修改一个任务的触发时间(使用默认的任务组名，触发器名，触发器组名)
     *
     * @param jobName
     * @param time
     */
    public static void modifyJobTime(String jobName, String time) {
        try {
            Scheduler sched = gSchedulerFactory.getScheduler();
            CronTrigger trigger = (CronTrigger) sched.getTrigger(jobName,
                    TRIGGER_GROUP_NAME);
            if (trigger == null) {
                return;
            }
            String oldTime = trigger.getCronExpression();
            if (!oldTime.equalsIgnoreCase(time)) {
                JobDetail jobDetail = sched.getJobDetail(jobName,
                        JOB_GROUP_NAME);
                Class objJobClass = jobDetail.getJobClass();
                String jobClass = objJobClass.getName();
                removeJob(jobName);

                addJob(jobName, jobClass, time);
            }
        } catch (Exception e) {
            e.printStackTrace();
            throw new RuntimeException(e);
        }
    }

    /**
     * 修改一个任务的触发时间
     *
     * @param triggerName
     * @param triggerGroupName
     * @param time
     */
    public static void modifyJobTime(String triggerName,
            String triggerGroupName, String time) {
        try {
            Scheduler sched = gSchedulerFactory.getScheduler();
            CronTrigger trigger = (CronTrigger) sched.getTrigger(triggerName,
                    triggerGroupName);
            if (trigger == null) {
                return;
            }
            String oldTime = trigger.getCronExpression();
            if (!oldTime.equalsIgnoreCase(time)) {
                CronTrigger ct = (CronTrigger) trigger;
                // 修改时间
                ct.setCronExpression(time);
                // 重启触发器
                sched.resumeTrigger(triggerName, triggerGroupName);
            }
        } catch (Exception e) {
            e.printStackTrace();
            throw new RuntimeException(e);
        }
    }

    /**
     * 移除一个任务(使用默认的任务组名，触发器名，触发器组名)
     *
     * @param jobName
     */
    public static void removeJob(String jobName) {
        try {
            Scheduler sched = gSchedulerFactory.getScheduler();
            // 停止触发器
            sched.pauseTrigger(jobName, TRIGGER_GROUP_NAME);
            // 移除触发器
            sched.unscheduleJob(jobName, TRIGGER_GROUP_NAME);
            // 删除任务
            sched.deleteJob(jobName, JOB_GROUP_NAME);
        } catch (Exception e) {
            e.printStackTrace();
            throw new RuntimeException(e);
        }
    }

    /**
     * 移除一个任务
     *
     * @param jobName
     * @param jobGroupName
     * @param triggerName
     * @param triggerGroupName
     */
    public static void removeJob(String jobName, String jobGroupName,
            String triggerName, String triggerGroupName) {
        try {
            Scheduler sched = gSchedulerFactory.getScheduler();
            // 停止触发器
            sched.pauseTrigger(triggerName, triggerGroupName);
            // 移除触发器
            sched.unscheduleJob(triggerName, triggerGroupName);
            // 删除任务
            sched.deleteJob(jobName, jobGroupName);
        } catch (Exception e) {
            e.printStackTrace();
            throw new RuntimeException(e);
        }
    }

    /**
     * 启动所有定时任务
     */
    public static void startJobs() {
        try {
            Scheduler sched = gSchedulerFactory.getScheduler();
            if (sched.isShutdown()) {
                sched.start();
            }
        } catch (Exception e) {
            e.printStackTrace();
            throw new RuntimeException(e);
        }
    }

    /**
     * 关闭所有定时任务
     */
    public static void shutdownJobs() {
        try {
            Scheduler sched = gSchedulerFactory.getScheduler();
            if (!sched.isShutdown()) {
                sched.shutdown();
            }
        } catch (Exception e) {
            e.printStackTrace();
            throw new RuntimeException(e);
        }
    }

    /***
     * 停止触发器
     * @param triggerName
     * @param triggerGroupName
     */
    public static void pauseTrigger(){
        try {
            Scheduler sched = gSchedulerFactory.getScheduler();
            sched.pauseTriggerGroup(TRIGGER_GROUP_NAME);
        } catch (Exception e) {
            e.printStackTrace();
            throw new RuntimeException(e);
        }
    }

    /***
     * 重启触发器
     * @param triggerName
     * @param triggerGroupName
     * @param time
     */
    public static void resumeTrigger() {
        try {
            Scheduler sched = gSchedulerFactory.getScheduler();
            // 重启触发器
            sched.resumeTriggerGroup(TRIGGER_GROUP_NAME);
        } catch (Exception e) {
            e.printStackTrace();
            throw new RuntimeException(e);
        }
    }

}