Quartz是一个完全由Java编写的开源作业调度框架，为在Java应用程序中进行作业调度提供了简单却强大的机制。Quartz允许开发人员根据时间间隔来调度作业。它实现了作业和触发器的多对多的关系，还能把多个作业与不同的触发器关联。简单地创建一个org.quarz.Job接口的Java类，Job接口包含唯一的方法：

1     public void execute(JobExecutionContext context) throws JobExecutionException;

　　在Job接口实现类里面，添加需要的逻辑到execute()方法中。配置好Job实现类并设定好调度时间表，Quartz就会自动在设定的时间调度作业执行execute()。

　　整合了Quartz的应用程序可以重用不同事件的作业，还可以为一个事件组合多个作业。Quartz通过属性文件来配置JDBC事务的数据源、全局作业、触发器侦听器、插件、线程池等等。

• Hello,Quartz

　　配置环境：

　　1. 下载Quartz

　　2. 阅读Readme.txt，了解每个jar包的作用，将quartz.jar包和lib/下的几个jar包、以及相关依赖的jar包放在工程的classpath中 

　　先来看一个简单的Quartz应用，让它每隔5s打印"Hello, Quartz"，打印10次。

　　代码清单1：创建任务

1 import java.util.Date; 2 import org.quartz.Job; 3 import org.quartz.JobExecutionContext; 4 import org.quartz.JobExecutionException; 5  6 public class HelloQuartzJob implements Job { 7  8     public void execute(JobExecutionContext context)  9             throws JobExecutionException {10         System.out.println("Hello, Quartz! - executing its JOB at "+ 11             new Date() + " by " + context.getTrigger().getName());12     }13 }

　　为了调度此任务执行，需要先得到一个Schedule实例，然后创建一个包含任务信息的JobDetail，最后创建一个Trigger管理任务的执行。

　　代码清单2：调度任务

1 import java.sql.Date;  2 import org.quartz.JobDetail; 3 import org.quartz.Scheduler; 4 import org.quartz.SchedulerException; 5 import org.quartz.SchedulerFactory; 6 import org.quartz.SimpleTrigger; 7 import org.quartz.impl.StdSchedulerFactory; 8  9 10 public class HelloQuartzScheduling {11 12     public static void main(String[] args)throws SchedulerException {13 14         SchedulerFactory schedulerFactory = new StdSchedulerFactory();15         Scheduler scheduler = schedulerFactory.getScheduler();16 17         JobDetail jobDetail = new JobDetail("helloQuartzJob", 18                 Scheduler.DEFAULT_GROUP, HelloQuartzJob.class);19 20         SimpleTrigger simpleTrigger = new SimpleTrigger("simpleTrigger", 21                 Scheduler.DEFAULT_GROUP);22 23         simpleTrigger.setStartTime(new Date(System.currentTimeMillis()));24         simpleTrigger.setRepeatInterval(5000);25         simpleTrigger.setRepeatCount(10);26 27         scheduler.scheduleJob(jobDetail, simpleTrigger);28 29         scheduler.start();30     }31 32 }

　　Job接口包含唯一方法execute()，将任务逻辑添加到该方法中。StdSchedulerFactory.getScheduler()返回一个可运行的实例，然后创建调度任务的JobDetail实例，并传递3个参数给构造方法。第一个参数是任务名，用于引用该任务。第二个参数是任务组名，这里使用默认名，任务组名用于引用集合起来的一组任务，如可以使用Scheduler.pauseJobGroup()来暂停一组任务，每个组中的任务名是唯一的。第三个参数是实现特定任务的类。创建JobDetail实例后，需要创建一个Trigger，这里使用的是SimpleTrigger类，它提供了JDK Timer风格的触发器行为。传递给SimpleTrigger构造方法的两个参数分别是触发器名和任务组名，触发器名在它所在的任务组中必须是唯一的。接下来是设置触发器的一些属性，setStartTime()是设置启动时间，setRepeatInterval()是设置重复间隔，setRepeatCount()是设置重复次数。最后，scheduler.start()启动调度，终止调度可以用stop()方法。

• CronTrigger类

　　Quartz有两大触发器，除了上面使用的SimpleTrigger外，就是CronTrigger。CronTrigger能够提供复杂的触发器表达式的支持。CronTrigger是基于Unix Cron守护进程，它是一个调度程序，支持简单而强大的触发器语法。

　　使用CronTrigger主要的是要掌握Cron表达式。Cron表达式包含6个必要组件和一个可选组件，如下表所示。

位置	含义	允许的特殊字符
1	秒（0~59）	, -  *  /
2	分（0~59）	, -  *  /
3	小时（0~24）	, -  *  /
4	日期（1~31）	, -  *  /  ?  L  W  C
5	月（JAN~DEC或1~12）	, -  *  /
6	星期（SUN~SAT或1~7）	, -  *  /  ?  L  C  #
7	年（可选，1970~2099），若为空，表示全部时间范围	, -  *  /

　　特殊字符的含义，见下表。

 

特殊字符	说明
*	通配符，任意值
?	无特定值。通常和其他指定的值一起使用，表示必须显示该值但不能检查
-	范围。e.g.小时部分10-12表示10:00，11:00， 12:00
,	列分隔符。可以让你指定一系列的值。e.g.在星期域中指定MON、TUE和WED
/	增量。表示一个值的增量，e.g.分钟域中0/1表示从0开始，每次增加1min
L	表示Last。它在日期和星期域中表示有所不同。在日期域中，表示这个月的最后一天，而在星期域中，它永远是7（星期六）。当你希望使用星期中某一天时，L字符非常有用。e.g.星期域中6L表示每一个月的最后一个星期五
W	在本月内离当天最近的工作日触发，所谓的最近工作日，即当天到工作日的前后最短距离，如果当天即为工作日，则距离是0；所谓本月内指的是不能跨月取到最近工作日，即使前/后月份的最后一天/第一天确实满足最近工作日。e.g. LW表示本月的最后一个工作日触发，W强烈依赖月份。
#	表示该月的第几个星期，e.g. 1#2表示每一个月的第一个星期一
C	日历值。日期值是根据一个给定的日历计算出来的。在日期域中给定一个20C将在20日（日历包括20日）或20日后日历中包含的第一天（不包括20日）激活触发器。例如在一个星期域中使用6C表示日历中星期五（日历包括星期五）或者第一天（日历不包括星期五）

 

　　Cron表达式举例：

"30 * * * * ?" 每半分钟触发任务

"30 10 * * * ?" 每小时的10分30秒触发任务

"30 10 1 * * ?" 每天1点10分30秒触发任务

"30 10 1 20 * ?" 每月20号1点10分30秒触发任务

"30 10 1 20 10 ? *" 每年10月20号1点10分30秒触发任务

"30 10 1 20 10 ? 2011" 2011年10月20号1点10分30秒触发任务

"30 10 1 ? 10 * 2011" 2011年10月每天1点10分30秒触发任务

"30 10 1 ? 10 SUN 2011" 2011年10月每周日1点10分30秒触发任务

"15,30,45 * * * * ?" 每15秒，30秒，45秒时触发任务

"15-45 * * * * ?" 15到45秒内，每秒都触发任务

"15/5 * * * * ?" 每分钟的每15秒开始触发，每隔5秒触发一次

"15-30/5 * * * * ?" 每分钟的15秒到30秒之间开始触发，每隔5秒触发一次

"0 0/3 * * * ?" 每小时的第0分0秒开始，每三分钟触发一次

"0 15 10 ? * MON-FRI" 星期一到星期五的10点15分0秒触发任务

"0 15 10 L * ?" 每个月最后一天的10点15分0秒触发任务

"0 15 10 LW * ?" 每个月最后一个工作日的10点15分0秒触发任务

"0 15 10 ? * 5L" 每个月最后一个星期四的10点15分0秒触发任务

"0 15 10 ? * 5#3" 每个月第三周的星期四的10点15分0秒触发任务

 

　　将上面HelloQuartz例子中SimpleTrigger换成CronTrigger，代码如下。

　　代码清单3：CronTrigger调度器

　　将上面HelloQuartz例子中SimpleTrigger换成CronTrigger，代码如下。

1 import java.text.ParseException; 2 import org.quartz.CronTrigger; 3 import org.quartz.JobDetail; 4 import org.quartz.Scheduler; 5 import org.quartz.SchedulerException; 6 import org.quartz.SchedulerFactory; 7 import org.quartz.impl.StdSchedulerFactory; 8  9 public class HelloQuartzScheduling {10 11     public static void main(String[] args) 12         throws SchedulerException, ParseException {13 14         SchedulerFactory schedulerFactory = new StdSchedulerFactory();15         Scheduler scheduler = schedulerFactory.getScheduler();16 17         JobDetail jobDetail = new JobDetail("helloQuartzJob", 18                 Scheduler.DEFAULT_GROUP, HelloQuartzJob.class);19 20         String cronExpression = "30/5 * * * * ?"; // 每分钟的30s起，每5s触发任务        21         CronTrigger cronTrigger = new CronTrigger("cronTrigger", 22                 Scheduler.DEFAULT_GROUP, cronExpression);23 24         scheduler.scheduleJob(jobDetail, cronTrigger);25 26         scheduler.start();27     }28 29 }

　　CronTrigger使用HolidayCalendar类可以排除某一段时间，比如说国庆节不执行调度任务，代码示例如下：

1 import java.text.ParseException; 2 import java.util.Calendar; 3 import org.quartz.CronTrigger; 4 import org.quartz.JobDetail; 5 import org.quartz.Scheduler; 6 import org.quartz.SchedulerException; 7 import org.quartz.SchedulerFactory; 8 import org.quartz.impl.StdSchedulerFactory; 9 import org.quartz.impl.calendar.HolidayCalendar;10 11 12 public class HelloQuartzScheduling {13 14     public static void main(String[] args) 15         throws SchedulerException, ParseException {16 17         SchedulerFactory schedulerFactory = new StdSchedulerFactory();18         Scheduler scheduler = schedulerFactory.getScheduler();19 20         JobDetail jobDetail = new JobDetail("helloQuartzJob", 21                 Scheduler.DEFAULT_GROUP, HelloQuartzJob.class);22 23         Calendar cal = Calendar.getInstance();24         cal.set(2012, Calendar.OCTOBER, 1); // 国庆节25 26         HolidayCalendar holidayCal = new HolidayCalendar();27         holidayCal.addExcludedDate(cal.getTime()); // 排除该日期28 29         // addCalendar(String calName, Calendar calendar, 30         //             boolean replace, boolean updateTriggers)31         scheduler.addCalendar("calendar", holidayCal, true, false);32 33         String cronExpression = "30/5 * * * * ?"; // 每5s触发任务        34         CronTrigger cronTrigger = new CronTrigger("cronTrigger", 35                 Scheduler.DEFAULT_GROUP, cronExpression);36 37         cronTrigger.setCalendarName("calendar");38 39         scheduler.scheduleJob(jobDetail, cronTrigger);40 41         scheduler.start();42     }43 44 }　　

　　JobStore: 任务持久化

　　Quartz支持任务持久化，这可以让你在运行时增加任务或者对现存的任务进行修改，并为后续任务的执行持久化这些变更和增加的部分。中心概念是JobStore接口。默认的是RAMJobStore。

 

　　

　　配置文件

　　上述没有用到任何的配置文件。Quartz支持配置文件，它的好处是比编写代码简单，且修改后不需要重新编译源码。

 

　　配置quartz.properties特性文件

　　quartz.properties文件定义了Quartz应用运行时行为，还包含了许多能控制Quartz运转的属性。它应放在工程的classpath中。

　　代码清单5：quartz.properties

1 #============================================================================   2 # Configure Main Scheduler Properties   3 #============================================================================ 4  5 # 实例名 6 org.quartz.scheduler.instanceName = QuartzScheduler  7 # 实例ID 8 org.quartz.scheduler.instanceId = AUTO 9 10 #============================================================================11 # Configure ThreadPool  12 #============================================================================13 org.quartz.threadPool.class = org.quartz.simpl.SimpleThreadPool14 # 线程个数15 org.quartz.threadPool.threadCount = 316 org.quartz.threadPool.threadPriority = 517 18 #============================================================================19 # Configure JobStore  20 #============================================================================21 org.quartz.jobStore.misfireThreshold = 6000022 org.quartz.jobStore.class = org.quartz.simpl.RAMJobStore23 24 #============================================================================25 # Configure Plugins 26 #============================================================================27 org.quartz.plugin.triggHistory.class = org.quartz.plugins.history.LoggingJobHistoryPlugin28 # org.quartz.plugins.xml.JobInitializationPlugin是Quartz自带的插件，29 # 默认时，这个插件会在 classpath 中搜索名为 quartz_jobs.xml 30 # 的文件并从中加载 Job 和 Trigger 信息31 # v1.8之前用JobInitializationPlugin32 #org.quartz.plugin.jobInitializer.class = org.quartz.plugins.xml.JobInitializationPlugin33 org.quartz.plugin.jobInitializer.class = org.quartz.plugins.xml.XMLSchedulingDataProcessorPlugin34 org.quartz.plugin.jobInitializer.fileNames = quartz_jobs.xml35 org.quartz.plugin.jobInitializer.failOnFileNotFound = true36 org.quartz.plugin.jobInitializer.scanInterval =1037 org.quartz.plugin.jobInitializer.wrapInUserTransaction = false38 39 # 关闭quartz新版本检测功能40 org.quartz.scheduler.skipUpdateCheck = true

　　quartz从版本1.8开始，配置文件有所改动，以前quartz自带的插件是JobInitializationPlugin，而1.8中是XMLSchedulingDataProcessorPlugin. xml。

　　代码清单6：quartz_jobs.xml格式 

1 
             2 
          
              6    
           
               7        
               8        
            
             *
               9        
              10        
            
             *
              11        
              12        
            
               13            
               14            
               15            
               16        
              17        
            
               18            
               19            
               20            
               21        
              22    
             23   24    
           
              25        
              26        
            
             true or false
              27        
              28        
            
             true or false
              29        
              30    
             31   32    
           
              33        
            
               34            
             
              JobName
               35            
             
              JobGroup
               36            
               37            
               38            
               39            
               40            
               41            
               42            
               43            
             
                44                
                45                
              
                 46                    
                 47                    
                 48                
                49            
               50        
              51        
            
               52            
               53            
             
                54                
                55                
                56                
                57                
                58                
                59                
                60                
                61                
              
                 62                    
               
                 63 
                 64 
                 65 
                 66                
                67                
                68                
                69                
                70                
                71                
                72            
               73            
             
                74                
                75                
                76                
                77                
                78                
                79                
                80                
                81                
              
                 82                    
               
                 83 
                 84 
                 85 
                 86                
                87                
                88                
                89                
                90                
                91                
                92            
               93            
             
                94                
                95                
                96                
                97                
                98                
                99                
               100                
               101                
              
                102                    
               
                 103 
                 104 
                 105 
                106                
               107                
               108                
               109                
               110                
               111                
               112            
              113        
             114    
            115 
          

　　代码清单7：quartz_jobs.xml示例

1 
             2 
          
              6        7    
           
               8        
            
             *
             
               9        
            
             *
            
              10    
             11       12    
           
              13        
            
             true
              14        
            
             false
               15    
             16       17    
           
              18        
            
               19            
             
              helloQuartzJob
               20            
             
              DEFAULT
               21            
             
              简单的quartz使用
               22            
             
              HelloQuartzJob
               23            
             
              false
               24            
             
              true
               25            
             
              false
               26        
              27        
            
               28        
             
              29                 
              
               trigger
                   30               
              
               DEFAULT
                   31               
              
               helloQuartzJob
                   32               
              
               DEFAULT
               33              
              
               30/5 * * * * ?
              34        
                35        
            36    
                 37 
          

　　代码清单8：Quartz任务调度

1 public class HelloQuartzScheduling { 2      3     public static void main(String[] args)  4        throws SchedulerException, ParseException { 5         6        SchedulerFactory schedulerFactory = new StdSchedulerFactory(); 7        Scheduler scheduler = schedulerFactory.getScheduler(); 8         9        scheduler.start();              10     }   11 }

　　spring中的？的特殊用处：

　　1、如官方文档解释的那样，问号(?)的作用是指明该字段‘没有特定的值’；

　　2、星号(*)和其它值，比如数字，都是给该字段指明特定的值，只不过用星号(*)代表所有可能值；

　　3、cronExpression对日期和星期字段的处理规则是它们必须互斥，即只能且必须有一个字段有特定的值，另一个字段必须是‘没有特定的值’；

　　4、问号(?)就是用来对日期和星期字段做互斥的。