9.2 Cron4jPlugin

  1. Cron4jPlugin是作为JFinal的Plugin而存在的，所以使用时需要在JFinalConfig中配置，如下是代码示例：
  1. Cron4jPlugin cp = new Cron4jPlugin();
  2. cp.addTask("* * * * *", new MyTask());
  3. me.add(cp);
  1. 如上所示创建插件、addTask传入参数，并添加到JFinal即完成了基本配置，上图所示红色箭头所指的第一个字符串参数是用于任务调度的cron表达式，第二个参数是Runnable接口的一个实现类，Cron4jPlugin会根据cron表达式调用MyTask中的run方法。
  3. 请注意，cron 表达式最多只允许五部分，每部分用空格分隔开来，这五部分从左到右依次表示分、时、天、月、周，其具体规则如下：

  • 分 ：从 0 到 59

  • 时 ：从 0 到 23

  • 天 ：从 1 到 31，字母 L 可以表示月的最后一天

  • 月 ：从 1 到 12，可以别名：jan", "feb", "mar", "apr", "may", "jun", "jul", "aug", "sep", "oct", "nov" and "dec"

  • 周 ：从 0 到 6，0 表示周日，6 表示周六，可以使用别名： "sun", "mon", "tue", "wed", "thu", "fri" and "sat"

  1. 如上五部分的分、时、天、月、周又分别支持如下字符，其用法如下：

  • 数字 n：表示一个具体的时间点，例如 5 表示 5 分这个时间点时执行

  • 逗号 , ：表示指定多个数值，例如 3,5 表示 3 和 5 分这两个时间点执行

  • 减号 -：表示范围，例如 1-3 表示 1 分、2 分再到 3 分这三个时间点执行

  • 星号 ：表示每一个时间点，例如 表示每分钟执行

  • 除号 /：表示指定一个值的增加幅度。例如 /5表示每隔5分钟执行一次（序列：0:00, 0:05, 0:10, 0:15 等等）。再例如3-18/5 * 是指在从3到18分钟值这个范围之中每隔5分钟执行一次（序列：0:03, 0:08, 0:13, 0:18, 1:03, 1:08 等等）。

  1. **常见错误**：cron4j在表达式中使用除号指定增加幅度时与linux稍有不同。例如在linux中表达式 10/3 * * * * 的含义是从第10分钟开始，每隔三分钟调度一次，而在cron4j中需要使用 10-59/3 * * * * 来表达。避免这个常见错误的技巧是：当需要使用除号指定增加幅度时，始终指定其范围。

基于上面的技巧，每隔2分钟调度一次的表达式为：0-59/2 或者 /2 ， 而不能是0/2 *

  1. 以上规则不是JFinal创造，是linux通用的cron表达式规则**（注意不是quartz规则）**，如果开发者本身具有这方面的知识，用起来会得心应手。原始文档链接：[http://www.sauronsoftware.it/projects/cron4j/manual.php](http://www.sauronsoftware.it/projects/cron4j/manual.php)
  5. **特别提醒：**Cron4jPlugin的cron表达式与linux一样只有5个部分，与quartz这个项目的7个部分不一样，但凡在网上搜索到的7部分cron表达式都不要试图应用在Cron4jPlugin之中。

< 9.1 概述

9.3 使用外部配置文件 >

原文: http://www.jfinal.com/doc/9-2