目錄
- 前言
- 介紹
- 一 cron的結構
- 二 各域的含義
- 三 常用cron表達式
- 實例
- 1 后臺添加定時任務處理類
- 2 前端新建定時任務信息
- 3 點擊執行一次
- 4 啟動定時任務
前言
在實際項目開發中Web應用有一類不可缺少的，那就是定時任務。 定時任務的場景可以說非常廣泛，比如某些視頻網站，購買會員后，每天會給會員送成長值，每月會給會員送一些電影券； 比如在保證最終一致性的場景中，往往利用定時任務調度進行一些比對工作；比如一些定時需要生成的報表、郵件；比如一些需要定時清理數據的任務等。定時任務在我們軟件開發中應用得實在太廣泛了，下面就讓我們來一起學習學習。
介紹
一 cron的結構
Cron表達式是一個字符串，以5個或6個空格隔開，分為6個或7個域，每一個域代表一個含義，Cron有如下兩種語法格式：
- 七個域
Seconds Minutes Hours DayOfMonth Month DayOfWeek Year
即corn從左到右（用空格隔開）：秒 分 小時 月份中的日期 月份 星期中的日期 年份
- 六個域
Seconds Minutes Hours DayOfMonth Month DayOfWeek
即corn從左到右（用空格隔開）：秒 分 小時 月份中的日期 月份 星期中的日期
二 各域的含義
| 域 | 允許值 | 允許的特殊字符 |
|---|---|---|
| 秒（Seconds） | 0~59的整數 | , - * / 四個字符 |
| 分（Minutes） | 0~59的整數 | , - * / 四個字符 |
| 0~59的整數 | 0~23的整數 | , - * / 四個字符 |
| 日期（DayOfMonth） | 1~31的整數（但是你需要考慮你月的天數） | ,- * ? / L W C 八個字符 |
| 月份（Month） | 1~12的整數或者 JAN-DEC | , - * / 四個字符 |
| 星期（DayOfWeek） | 1~7的整數或者 SUN-SAT （1=SUN） | , - * ? / L C # 八個字符 |
| 年(可選，留空)（Year） | 1970~2099 | , - * / 四個字符 |
每一個域都能使用數字，但還可以出現如下特殊字符，允許的特殊字符含義如下：
| 特殊字符 | 含義 |
|---|---|
* | 表示匹配該域的任意值。假如在Minutes域使用*, 即表示每分鐘都會觸發事件 |
? | 只能用在DayOfMonth和DayOfWeek兩個域。也匹配域的任意值，但實際不會。因為DayOfMonth和DayOfWeek會相互影響。例如想在每月的20日下午15點觸發定時任務，不管20日到底是星期幾，則只能使用如下寫法： 0 0 15 20 * ?, 其中最后一位只能用？，而不能使用*，如果使用*表示不管星期幾都會觸發，實際上并不是這樣。 |
- | 表示范圍。例如在Minutes域使用5-20，表示從5分到20分鐘每分鐘觸發一次 |
/ | 表示起始時間開始觸發，然后每隔固定時間觸發一次。例如在Minutes域使用5/20,則意味著從第5分鐘開始觸發一次后每隔20分鐘觸發即25，45等分別觸發一次. |
, | 表示列出枚舉值。例如：在Minutes域使用5,20，則意味著在5和20分每個時間點觸發一次。 |
L | 英文單詞Last的首字母表示最后，只能出現在DayOfWeek和DayOfMonth域。如果在DayOfWeek域使用5L,意味著在最后的一個星期四觸發。如果在DayOfMonth域使用5L 表達倒數第5天觸發。 |
W | 英文Workday的首字母，表示有效工作日(周一到周五),只能出現在DayOfMonth域，系統將在離指定日期的最近的有效工作日觸發事件。例如：在 DayOfMonth使用5W，如果5日是星期六，則將在最近的工作日：星期五，即4日觸發。如果5日是星期天，則在6日(周一)觸發；如果5日在星期一到星期五中的一天，則就在5日觸發。另外一點，W的最近尋找不會跨過月份 。 |
LW | 這兩個字符可以連用，表示在某個月最后一個工作日。 |
# | 用于確定每個月第幾個星期幾，只能出現在DayOfWeek域。例如在4#2，表示某月的第二個星期三。 |
C | 該字符只在DayOfMonth域和DayOfWeek域中使用，英文Calendar的首字母。指和calendar關聯后計算出來的值， 如果日期沒有被關聯，則相當于日歷中所有日期。例如 5C 在日期字段中就相當于日歷 5 日以后的第一天。 1C 在星期字段中相當于星期日后的第一天。該特殊字符很少用到，不理解也沒有關系。 |
注意
cron 表達式對特殊字符的大小寫不敏感，對代表星期的縮寫英文大小寫也不敏感。
三 常用cron表達式
| 表達式 | 說明 |
|---|---|
0 0 2 1 * ? * | 表示在每月的1日的凌晨2點調整任務 |
0 15 10 ? * MON-FRI | 表示周一到周五每天上午10:15執行作業 |
0 15 10 ? * 6L 2002-2006 | 表示2002-2006年的每個月的最后一個星期五上午10:15執行作業 |
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觸發 |
注意：
（1）有些子表達式能包含一些范圍或列表
例如：子表達式（天（星期））可以為 “MON-FRI”，“MON，WED，FRI”，“MON-WED,SAT”，“”字符代表所有可能的值。
因此，“”在子表達式（月）里表示每個月的含義，“*”在子表達式（天（星期））表示星期的每一天。
（2）“/”字符用來指定數值的增量
例如：在子表達式（分鐘）里的“0/15”表示從第0分鐘開始，每15分鐘。
在子表達式（分鐘）里的“3/20”表示從第3分鐘開始，每20分鐘（它和“3，23，43”）的含義一樣。
（3）“?”字符僅被用于天（月）和天（星期）兩個子表達式，表示不指定值
當2個子表達式其中之一被指定了值以后，為了避免沖突，需要將另一個子表達式的值設為“?”。
（4）“L” 字符僅被用于天（月）和天（星期）兩個子表達式，它是單詞“last”的縮寫，但是它在兩個子表達式里的含義是不同的。
在天（月）子表達式中，“L”表示一個月的最后一天。
在天（星期）自表達式中，“L”表示一個星期的最后一天，也就是SAT。
如果在“L”前有具體的內容，它就具有其他的含義了。
例如：“6L”表示這個月的倒數第６天，“FRIL”表示這個月的最一個星期五。
注意：在使用“L”參數時，不要指定列表或范圍，因為這會導致問題。
實例
若依后臺動態管理定時任務
1 后臺添加定時任務處理類
支持Bean調用、Class類調用
MyTask.java
/*** @Description* @Author liql* @DateTime 2024-06-04 10:54* @Version 1.0*/
@Component("myTask")
public class MyTask {public void ryMultipleParams(String s, Boolean b){if(b){System.out.println(StringUtils.format("執行多參方法： 字符串類型{}，布爾類型{}", s, b));}else {System.out.println("不會打印參數");}}public void ryParams(String params){System.out.println("執行有參方法，參數：" + params);}public void ryNoParams(){System.out.println("執行無參方法-------------------------------------");}
}2 前端新建定時任務信息
系統監控 -> 定時任務->新增
點擊新增的彈窗臺下
- 任務名稱：自定義，如：定時查詢任務狀態
- 任務分組：根據字典sys_job_group配置
- 調用目標字符串：設置后臺任務方法名稱參數
Bean調用示例：
需要添加對應Bean注解@Component或@Service。調用目標字符串： ryTask.ryParams(‘ry’)
Class類調用示例：
添加類和方法指定包即可。調用目標字符串：com.ruoyi.quartz.task.RyTask.ryParams(‘ry’)
方法參數詳解：
字符串（需要單引號’'標識 如：ryTask.ryParams(’ry’)）
布爾類型（需要true false標識 如：ryTask.ryParams(true)）
長整型（需要L標識 如：ryTask.ryParams(2000L)）
浮點型（需要D標識 如：ryTask.ryParams(316.50D)）
整型（純數字即可）
-
執行表達式：可查詢官方cron表達式介紹
輸入：2/5 * * ? * *
表示：從第二秒鐘開始觸發，每隔5秒觸發一次。 -
執行策略：定時任務自定義執行策略
立即執行（所有misfire的任務會馬上執行）打個比方，如果9點misfire了，在10：15系統恢復之后，9點，10點的misfire會馬上執行
執行一次（會合并部分的misfire，正常執行下一個周期的任務）假設9，10的任務都misfire了，系統在10：15分起來了。只會執行一次misfire，下次正點執行。
放棄執行(所有的misfire不管，執行下一個周期的任務)
- 并發執行：是否需要多個任務間同時執行
- 備注：定時任務描述信息
3 點擊執行一次
測試定時任務是否正常及調度日志是否正確記錄，如正常執行表示任務配置成功。
4 啟動定時任務
