Quartz实现定时功能 job.xml文件的配置

  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集成在一起，并进行了封装，使用起来还是很方便的。    
  150.   
posted @ 2010-04-13 11:26  饺子吃遍天  阅读(266)  评论(0)  编辑  收藏  举报