Spring的@Scheduled注解使用介绍

た入场券 2023-02-18 03:06 4阅读 0赞

#### 一、介绍 ####

注解@Scheduled 可以作为一个触发源添加到一个方法中，经常用于做定时任务

#### 二、举例 ####

1.  以固定延迟时间5秒钟调用一次方法，这个周期是以上一次调用任务的**完成时间**为基准。即在上一个任务完成之后，延迟5s后再次执行方法

@Scheduled(fixedDelay = 5000)
    public void test() {
    }

1.  以固定速率5s来调用一次方法，这个周期是以上一次调用任务**开始时间**为基准。即从上一个任务开始执行之后，隔5s再次调用该方法

@Scheduled(fixedRate = 5000)
    public void test() {
    }

1.  每天凌晨两点执行任务

@Scheduled(cron = "0 0 2 * * ?")　
    public void test() {
    }

#### 三、cron表达式 ####

cron表达式可实现复杂的定时任务，至少由6个（或7个）**空格**分隔的时间元素组成

##### 3.1 结构 #####

corn从左到右（用空格隔开）：秒 分 小时 月份中的日期 月份 星期中的日期 年份

<table> 
 <thead> 
  <tr> 
   <th>时间元素</th> 
   <th>取值范围</th> 
   <th>特殊字符</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>秒</td> 
   <td>0～59</td> 
   <td>, - * / 四个字符</td> 
  </tr> 
  <tr> 
   <td>分钟</td> 
   <td>0～59</td> 
   <td>, - * / 四个字符</td> 
  </tr> 
  <tr> 
   <td>小时</td> 
   <td>0～23</td> 
   <td>, - * / 四个字符</td> 
  </tr> 
  <tr> 
   <td>日期</td> 
   <td>0~31，考虑月的天数</td> 
   <td>,- * ? / L W C 八个字符</td> 
  </tr> 
  <tr> 
   <td>月份</td> 
   <td>0～11</td> 
   <td>, - * / 四个字符</td> 
  </tr> 
  <tr> 
   <td>星期</td> 
   <td>1~7 1=SUN 或 SUN，MON，TUE，WED，THU，FRI，SAT</td> 
   <td>, - * ? / L C # 八个字符</td> 
  </tr> 
  <tr> 
   <td>年份 (可选, 留空)</td> 
   <td>1970～2099</td> 
   <td>, - * / 四个字符</td> 
  </tr> 
 </tbody> 
</table>

**注意：**  
（1）每个时间元素都可以是一个值(如6)，一个连续区间(9-12)，一个间隔时间(8-18/4)(/表示每隔4小时)，一个列表(1,3,5)，通配符  
（2）由于"日期"和"星期"这两个元素是**互斥的**，必须要对其中一个设置?  
（3）表达式中的 \* ：**所有可能的值**  
（4）表达式中的 / ：起始时间开始触发，然后每隔固定时间触发一次。例如在Minutes域使用5/20，则意味着5分钟触发一次，而25，45等分别触发一次  
（5）表达式中的 ? ：仅被用于**日期**和**星期**两个子表达式，表示**不指定值**  
（6）表达式中的 L ：仅被用于**日期**和**星期**两个子表达式，它是单词“last”的缩写，但是它在两个子表达式里的含义是不同的。***在日期子表达式中，“L”表示一个月的最后一天；在星期自表达式中，“L”表示一个星期的最后一天，也就是SAT***。如果在“L”前有具体的内容，它就具有其他的含义了。例如：“6L”表示这个月的倒数第６天，“ＦＲＩＬ”表示这个月的最后一个星期五。**在使用“L”参数时，不要指定列表或范围，因为这会导致问题**  
（7）表达式中的 - ：表示范围。例如在Minutes域使用5-20，表示从5分钟到20分钟每分钟触发一次  
（8）表达式中的 , ：表示列出枚举值。例如：在Minutes域使用5,20，则意味着在5分钟和20分钟每分钟触发一次  
（9）表达式中的 W : 表示有效工作日(周一到周五)，只能出现在**日期**域，系统将在离指定日期的最近的有效工作日触发事件。例如：在日期域使用5W，如果5日是星期六，则将在最近的工作日：星期五，即4日触发。如果5日是星期天，则在6日(周一)触发；如果5日在星期一到星期五中的一天，则就在5日触发。另外一点，W的最近寻找不会跨过月份  
（10）表达式中的 LW : 这两个字符可以连用，表示在某个月最后一个工作日，即最后一个星期五  
（11）表达式中的 \# : 用于确定每个月第几个星期几，只能出现在日期域。例如在4\#2，表示某月的第二个星期三。

0 0 10,14,16 \* \* ? 每天上午10点，下午2点，4点  
0 0/30 9-17 \* \* ? 朝九晚五工作时间内每半小时  
0 0 12 ? \* WED 表示每个星期三中午12点  
“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期间的每1分钟触发  
“0 0/5 14 \* \* ?” 在每天下午2点到下午2:55期间的每5分钟触发  
“0 0/5 14,18 \* \* ?” 在每天下午2点到2:55期间和下午6点到6:55期间的每5分钟触发  
“0 0-5 14 \* \* ?” 在每天下午2点到下午2:05期间的每1分钟触发  
“0 10,44 14 ? 3 WED” 每年三月的星期三的下午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” 每月的第三个星期五上午10:15触发