SimpleTrigger

copy from http://shanyou.blog.51cto.com/363653/73999

 

1. 使用Quartz实现定时功能    
2.     
3. Quartz是一个完全由java编写的开源作业调度框架,具体的介绍可到http://www.opensymphony.com/quartz/官方网站查看。   
4.     
5. Quartz的几个核心的接口和类为：   
6.     
7. Job接口：自己写的“定时程序”实现此接口的void execute(JobExecutionContext arg0)方法,Job还有一类为有状态的StatefulJob接口，如果我们需要在上一个作业执行完后，根据其执行结果再进行下次作业的执行，则需要实现此接口。   
8. Trigger抽象类：调度类(Scheduler)在时间到时调用此类，再由trigger类调用指定的定时程序。   
9. Quertz中提供了两类触发器为：SimpleTrigger,CronTrigger。前者用于实现比较简单的定时功能，例如几点开始，几点结束，隔多长时间执行，共执行多少次等，后者提供了使用表达式来描述定时功能，因此适用于比较复杂的定时描述，例如每个月的最后一个周五，每周的周四等。   
10. JobDetail类：具体某个定时程序的详细描述，包括Name,Group,JobDataMap等。   
11. JobExecutionContext类：定时程序执行的run-time的上下文环境，用于得到当前执行的Job的名字，配置的参数等。   
12. JobDataMap类：用于描述一个作业的参数，参数可以为任何基本类型例如String,float等，也可为某个对象的引用.   
13. JobListener,TriggerListener接口：用于监听触发器状态和作业扫行状态，在特写状态执行相应操作。   
14. JobStore类：在哪里执行定进程序，可选的有在内存中，在数据库中。   
15.     
16. 简单的定时程序：   
17.     
18. public class TestJob implements Job   
19. {   
20.    public TestJob(){}   
21.    public void execute(JobExecutionContext arg0) throws JobExecutionException   
22.    {   
23.       String name = context.getJobDetail().getJobDataMap().getString("name");   
24.       System.out.println("job executing..."+name);   }   
25. }   
26.     
27. public class QuartzTest   
28. {   
29.  public static void main(String[] args)   
30.  {   
31.     QuartzTest test = new QuartzTest();   
32.     try  
33.    {   
34.       test.startSchedule();   
35.    }   
36.   catch (Exception e)   
37.   {   
38.      e.printStackTrace();   
39.   }   
40.  }   
41.  public void startSchedule() throws Exception   
42.  {   
43.      Scheduler scheduler = StdSchedulerFactory.getDefaultScheduler();   
44.      JobDetail jobDetail =   
45.       new JobDetail("testJob", Scheduler.DEFAULT_GROUP, TestJob.class);   
46.       //结束时间        
47.      long end = System.currentTimeMillis() + 9000L;   
48.     //执行10次，每3秒执行一次，到9秒后结束   
49.      SimpleTrigger trigger = new SimpleTrigger("test",null,new Date(),new Date(end),10,3000L);   
50.       scheduler.scheduleJob(jobDetail, trigger);   
51.      scheduler.start();   
52.  }   
53. }   
54.     
55. 执行上面这个类基本实现了一个简单的定时程序。但问题是现在这个类只能应用在application中，在web环境里执行还需要添加一些配置,例如添加servlet,添加配置文件quartz.properties或者quartz-job.xml(在ＸＭＬ文件里以配置方式定义triiger,定时描述等）。   
56.     
57. web应用中使用   
58.     
59. 在web.xml中添加QuartzInitializerServlet，Quartz为能够在web应用中使用，提供了一个QuartzInitializerServlet和一个QuartzInitializerListener，用于在加载web应用时，对quartz进行初始化。我在使用servlet时加载成功，在使用listener时不成功，不知道怎么回事？   
60.   
61.     
62.   
63. servlet配置：    
64. <servlet>    
65.    <servlet-name>QuartzInitializer</servlet-name>    
66.    <servlet-class>org.quartz.ee.servlet.QuartzInitializerServlet</servlet-class>    
67.    <init-param>   
68.      <param-name>shutdown-on-unload</param-name>   
69.      <param-value>true</param-value>   
70.    </init-param>   
71.    <init-param>   
72.     <param-name>config-file</param-name>   
73.     <param-value>quartz.properties</param-value>    
74.    </init-param>   
75.    <load-on-startup>2</load-on-startup>   
76.  </servlet>   
77. listener配置可以看源码，主要的上面的参数配置为<context-param>,再加一个<listener>.   
78.     
79. 上面提到了quartz.properties,这是自行指定的，Quartz提供了一个默认的配置文件，可以满足基本的j2se应用，如果在web应用中，我们想把job,trigger配置都写到文件中，就需要自己来写，并指定在初始化时加载我们自己的quratz.properties，位置放在classes下。   
80.     
81. #============================================================================   
82. # Configure Main Scheduler Properties     
83. #============================================================================   
84. org.quartz.scheduler.instanceName = org.quartz.scheduler.instanceId = AUTO   
85. #============================================================================   
86. # Configure ThreadPool     
87. #============================================================================   
88. org.quartz.threadPool.class = org.quartz.simpl.SimpleThreadPool   
89. org.quartz.threadPool.threadCount = 3  
90. org.quartz.threadPool.threadPriority = 5  
91. #============================================================================   
92. # Configure Plugins    
93. #============================================================================   
94. org.quartz.plugin.triggHistory.class = org.quartz.plugins.history.LoggingJobHistoryPlugin   
95. org.quartz.plugin.jobInitializer.class = org.quartz.plugins.xml.JobInitializationPlugin   
96. org.quartz.plugin.jobInitializer.fileName = /scheduler/quartz_jobs.xml   
97. org.quartz.plugin.jobInitializer.overWriteExistingJobs = true  
98. org.quartz.plugin.jobInitializer.failOnFileNotFound = true  
99. org.quartz.plugin.jobInitializer.scanInterval = 10  
100.     
101. quartz要使用插件来加载自己的xml配置文件，上边我们指定了在初始化时加载classes\scheduler\quartz_jobs.xml，默认的是加载classes\quartz_jobs.xml文件。   
102.     
103. quartz_jobs.xml文件：   
104. <?xml version='1.0' encoding='utf-8'?>   
105. <quartz>   
106.  <job>   
107. 　　 <job-detail>   
108.   　　<name>test</name>   
109.   　　<group>DEFAULT</group>   
110.   　　<description>testJobhere</description>   
111.   　　<job-class>TestJob</job-class>   
112.   　　<job-data-map allows-transient-data="true">   
113.    　　<entry>   
114.     　　<key>name</key>   
115.    　　 <value>test</value>   
116.    　　</entry>   
117.    </job-data-map>   
118.  　　</job-detail>   
119. 　　 <trigger>   
120.              <cron>   
121.                   <name>testCron</name>   
122.                   <group>DEFAULT</group>   
123.                   <job-name>test</job-name>   
124.                  <job-group>DEFALUT</job-group>   
125.                  <cron-expression>0/3 * * * * ?</cron-expression>   
126.              </cron>   
127.        </trigger>   
128. 　 </job>   
129. </quartz>   
130.   
131.     
132. 上面配置了一个作业，并声明一个参数Name；配置了一个CronTrigger,每三秒执行一次。如果要配置SimpleTrigger ,可以使用<simple>标签。   
133.     
134. 上面与Job对应的类为TestJob，源码为：   
135. public class TestJob implements Job   
136. {   
137.  public TestJob(){}   
138.  public void execute(JobExecutionContext context) throws JobExecutionException   
139.  {   
140.      String name = context.getJobDetail().getJobDataMap().getString("name");   
141.      System.out.println("job executing..."+name);   
142.  }   
143. }   
144.     
145. 在quartz_job.xml文件中还可以指定TriggerListener,JobListener等，可以使用<trigger-listener>,<job-listener>标签来指定。   
146.     
147. 由于quartz目前文档不是很多，大部分都是看源码。总体看Quartz提供的CronTrigger使用表达式方式描述定时规律这个功能还是很强大的，在其源码中有很多例子。   
148.     
149. spring已经把quartz集成在一起，并进行了封装，使用起来还是很方便的。

 

 

 

如果需要让任务只在某个时刻执行一次，或者，在某个时刻开始，然后按照某个时间间隔重复执行，简单地说，如果你想让触发器在 2007 年 8月20日上 午 11 ： 23 ： 54 秒执行，然后每个隔 10 秒钟重复执行一次，并且这样重复 5 次。那么 SimpleTrigger 就可以满足你的要求。

通过这样的描述，你可能很惊奇地发现 SimpleTrigger 包括这些属性：开始时间，结束时间，重复次数，重复间隔。所有这属性都是你期望它所应具备的，只有 end-time 属性有一些条目与之关联。

重复次数可能是 0 ，正数或者一个常量值 SimpleTrigger.REPEAT_INDEFINITELY 。重复间隔时间属性可能是 0 ，正的 long 型，这个数字以毫秒为单位。注意：如果指定的重复间隔时间是 0 ，那么会导致触发器按照 ‘ 重复数量 ’ 定义的次数并发触发（或者接近并发）。

Quartz.TriggerUtils类对处理这样的循环也提供了很多支持。

EndTime（如果这个属性被设置）属性会覆盖重复次数属性，这对创建一个每隔 10 秒就触发一次直到某个时间结束的触发器非常有用，这就可以不计算开始时间和结束时间之间的重复数量。也可以指定一个结束时间，然后使用 REPEAT_INDEFINITELY 作为重复数量。（甚至可以指定一个大于结束时间之前实际重复次数的整数作为重复次数）。一句话，EndTime属性控制权高于重复次数属性。
   
    SimpleTrigger有几个不同的构造函数，下面我们来看看这结果构造函数：

One of SimpleTrigger's Constructors SimpleTrigger 的未触发指令

public SimpleTrigger(string name, 
                       string group, 
                       DateTime startTime,
                       NullableDateTime endTime endTime, 
                       int repeatCount, 
                       long repeatInterval)

SimpleTrigger Example 1 - Create a trigger that fires exactly once, ten seconds from now

SimpleTrigger trigger = new SimpleTrigger("myTrigger" ,
                                          null ,
                                          DateTime.Now.AddSeconds(10 ),
                                          null ,
                                          0 ,
                                          0L);

SimpleTrigger Example 2 - Create a trigger that fires immediately, then repeats every 60 seconds, forever

SimpleTrigger trigger2 = new SimpleTrigger("myTrigger" ,
                                null ,
                                DateTime.Now,
                                null ,
                                SimpleTrigger.REPEAT_INDEFINITELY,
                                60 * 1000);

SimpleTrigger Example 3 - Create a trigger that fires immediately, then repeats every 10 seconds until 40 seconds from now

SimpleTrigger trigger = new SimpleTrigger("myTrigger",
                                          "myGroup",
                                          DateTime.Now,
                                          DateTime.Now.AddSeconds(40),
                                          SimpleTrigger.REPEAT_INDEFINITELY,
                                          10 * 1000);

    
SimpleTrigger Misfire Instructions——

“ 未触发 ” 发生时， SimpleTrigger 有几个指令可以用来通知 Quartz 进行相关处理。（ “ 未触发 ” 在上节课中介绍过了）。这些指令以常量形式定义在 SimpleTrigger 本身，这些指令如下：

Misfire Instruction Constants of SimpleTrigger

MISFIRE_INSTRUCTION_FIRE_NOW

MISFIRE_INSTRUCTION_RESCHEDULE_NOW_WITH_EXISTING_REPEAT_COUNT

MISFIRE_INSTRUCTION_RESCHEDULE_NOW_WITH_REMAINING_REPEAT_COUNT

MISFIRE_INSTRUCTION_RESCHEDULE_NEXT_WITH_REMAINING_COUNT

MISFIRE_INSTRUCTION_RESCHEDULE_NEXT_WITH_EXISTING_COUNT

回顾前面的课程你可以知道，每个触发器都有一个 Trigger.MISFIRE_INSTRUCTION_SMART_POLICY 指令可用，并且，这个指令对于每个类型的触发器都是缺省的。

自由、创新、研究、探索……