spring定时器(Quartz)的使用

女爷i 2022-07-16 19:22 172阅读 0赞

## quartz核心概念    ##

<table> 
 <tbody> 
  <tr> 
   <td>scheduler&nbsp;&nbsp;</td> 
   <td>任务调度器</td> 
  </tr> 
  <tr> 
   <td> <p>trigger</p> </td> 
   <td> <p>触发器，用于定义任务调度时间规则</p> </td> 
  </tr> 
  <tr> 
   <td> <p>job</p> </td> 
   <td> <p>任务，即被调度的任务</p> </td> 
  </tr> 
  <tr> 
   <td> <p>misfire</p> </td> 
   <td> <p>错过的，指本来应该被执行但实际没有被执行的任务调度</p> </td> 
  </tr> 
 </tbody> 
</table>

**Job**：是一个接口，只有一个方法void execute(JobExecutionContext context)，开发者实现该接口定义运行任务，JobExecutionContext类提供了调度上下文的各种信息。Job运行时的信息保存在JobDataMap实例中；

**JobDetail**：Quartz在每次执行Job时，都重新创建一个Job实例，所以它不直接接受一个Job的实例，相反它接收一个Job实现类，以便运行时通过newInstance()的反射机制实例化Job。因此需要通过一个类来描述Job的实现类及其它相关的静态信息，如Job名字、描述、关联监听器等信息，JobDetail承担了这一角色。

**Trigger**：是一个类，描述触发Job执行的时间触发规则。主要有SimpleTrigger和CronTrigger这两个子类。当仅需触发一次或者以固定时间间隔周期执行，SimpleTrigger是最适合的选择；而CronTrigger则可以通过Cron表达式定义出各种复杂时间规则的调度方案：如每早晨9:00执行，周一、周三、周五下午5:00执行等；

**Calendar**：org.quartz.Calendar和java.util.Calendar不同，它是一些日历特定时间点的集合（可以简单地将org.quartz.Calendar看作java.util.Calendar的集合——java.util.Calendar代表一个日历时间点，无特殊说明后面的Calendar即指org.quartz.Calendar）。一个Trigger可以和多个Calendar关联，以便排除或包含某些时间点。假设，我们安排每周星期一早上10:00执行任务，但是如果碰到法定的节日，任务则不执行，这时就需要在Trigger触发机制的基础上使用Calendar进行定点排除。

**Scheduler**：代表一个Quartz的独立运行容器，Trigger和JobDetail可以注册到Scheduler中，两者在Scheduler中拥有各自的组及名称，组及名称是Scheduler查找定位容器中某一对象的依据，Trigger的组及名称必须唯一，JobDetail的组和名称也必须唯一（但可以和Trigger的组和名称相同，因为它们是不同类型的）。Scheduler定义了多个接口方法，允许外部通过组及名称访问和控制容器中Trigger和JobDetail。

Scheduler可以将Trigger绑定到某一JobDetail中，这样当Trigger触发时，对应的Job就被执行。一个Job可以对应多个Trigger，但一个Trigger只能对应一个Job。可以通过SchedulerFactory创建一个Scheduler实例。Scheduler拥有一个SchedulerContext，它类似于ServletContext，保存着Scheduler上下文信息，Job和Trigger都可以访问SchedulerContext内的信息。SchedulerContext内部通过一个Map，以键值对的方式维护这些上下文数据，SchedulerContext为保存和获取数据提供了多个put()和getXxx()的方法。可以通过Scheduler\# getContext()获取对应的SchedulerContext实例；

**ThreadPool**：Scheduler使用一个线程池作为任务运行的基础设施，任务通过共享线程池中的线程提高运行效率。

### 定时执行的时间属性cronExpression介绍：    ###

1.       Seconds  
    2.              Minutes  
    3.            Hours  
    4.              Day-of-Month  
 5.              Month  
    6.              Day-of-Week  
    7.              Year (可选字段)  
  
“\*” 代表整个时间段.  
每一个字段都有一套可以指定有效值，如

Seconds(秒)       ：可以用数字0－59 表示，  
Minutes(分)                  ：可以用数字0－59 表示，  
Hours(时)                        ：可以用数字0-23表示,  
Day-of-Month(天) ：可以用数字1-31 中的任一一个值，但要注意一些特别的月份  
Month(月)                      ：可以用0-11 或用字符串   “JAN, FEB, MAR, APR, MAY, JUN,JUL, AUG, SEP, OCT, NOV and DEC” 表示  
Day-of-Week(每周)：可以用数字1-7表示（1 ＝ 星期日）或用字符口串“SUN, MON, TUE, WED, THU,FRI and SAT”表示  
  
“/”：为特别单位，表示为“每”如“0/15”表示每隔15分钟执行一次,“0”表示为从“0”分开始,“3/20”表示表示每隔20分钟执行一次，“3”表示从第3分钟开始执行  
“?”：表示每月的某一天，或第周的某一天  
“L”：用于每月，或每周，表示为每月的最后一天，或每个月的最后星期几如“6L”表示“每月的最后一个星期五”  
“W”：表示为最近工作日，如“15W”放在每月（day-of-month）字段上表示为“到本月15日最近的工作日”  
““\#”：是用来指定“的”每月第n个工作日,例 在每周（day-of-week）这个字段中内容为"6\#3" or "FRI\#3"则表示“每月第三个星期五”

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分每分触发    
    
    0 0/5 14 * * ?    每天下午的 2点到2点59分(整点开始，每隔5分触发)    
    
    0 0/5 14,18 * * ?    每天下午的 2点到2点59分、18点到18点59分(整点开始，每隔5分触发)    
    
    0 0-5 14 * * ?    每天下午的 2点到2点05分每分触发    
    
    0 10,44 14 ? 3 WED    3月分每周三下午的 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    每月的第三周的星期五开始触发    
    
    0 0 12 1/5 * ?    每月的第一个中午开始每隔5天触发一次    
    
    0 11 11 11 11 ?    每年的11月11号 11点11分触发(光棍节)

开发配置

### 需要的jar包 ###

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

### 1、spring的配置 ###

<?xml version="1.0" encoding="UTF-8"?>
    
    <beans xmlns="http://www.springframework.org/schema/beans"
    	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    	xmlns:util="http://www.springframework.org/schema/util"
    	xsi:schemaLocation="http://www.springframework.org/schema/beans 
    	http://www.springframework.org/schema/beans/spring-beans-3.0.xsd 
    	http://www.springframework.org/schema/util 
    	http://www.springframework.org/schema/util/spring-util-3.0.xsd"
    	default-lazy-init="true">
    
    	
    	<bean id="localQuartzScheduler" class="org.springframework.scheduling.quartz.SchedulerFactoryBean"
    		lazy-init="false">
    		
    		<property name="triggers">
    			<list>
    				<ref bean="one" />
    				<ref bean="two" />
    			</list>
    		</property>
    		
    		<property name="quartzProperties">
    			<props>
    				<prop key="org.quartz.threadPool.threadCount">5</prop>
    			</props>
    		</property>
    		
    		<property name="startupDelay" value="1" />
    	</bean>
    	
    	<bean id="one" class="org.springframework.scheduling.quartz.CronTriggerBean">
    		<property name="jobDetail" ref="taskOne" />
    		<property name="cronExpression" value="0 0 6 * * ?" />
    	</bean>
    	<bean id="taskOne" class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">
    		<property name="targetObject" ref="TimedTask" />
    		<property name="targetMethod" value="timedTaskOne" />
    	</bean>
    	
    	<bean id="two" class="org.springframework.scheduling.quartz.CronTriggerBean">
    		<property name="jobDetail" ref="taskTwo" />
    		<property name="cronExpression" value="0 0 0 1-31/3 * ?" />
    	</bean>
    	<bean id="taskTwo" class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">
    		<property name="targetObject" ref="TimedTask" />
    		<property name="targetMethod" value="timedTaskTwo" />
    	</bean>
    	
    	<bean id="TimedTask" class="org.software.manager.quartz.TimedTask" />
    </beans>

### 2、Class类(多个定时可以写在同一个类中) ###

package org.software.manager.quartz;
    
    /**
     * 定时器
     */
    public class TimedTask {
        /**
         * 定时任务1
         */
        public void timedTaskOne() {
            // 定时任务1业务代码
        }
    
        /**
         * 定时任务2
         */
        public void timedTaskTwo() {
            // 定时任务2业务代码
        }
    }