引言
@Scheduled 是用于在 Spring 框架中为方法配置定时任务的注解,它允许在一定的时间间隔或在特定的时间点运行一个方法,我们一般将该方法放在服务类中。
主要属性介绍
属性名称 | 介绍 |
---|---|
fixedRate | 以指定的毫秒数间隔连续执行方法。每次执行开始的时间都是固定的间隔时间。 示例:@Scheduled(fixedRate = 5000) 表示该方法每5秒执行一次 |
fixedDelay | 以指定的毫秒数间隔执行方法。方法执行完毕后,等待给定的延迟时间,然后开始下一次执行。 示例:@Scheduled(fixedDelay = 5000) 表示方法执行完毕后等待5秒,然后再执行下一次。 |
cron | 使用Cron表达式配置定时任务。Cron表达式可以非常灵活地指定任务的执行时间。 示例:@Scheduled(cron = “0 0 * * * ?”) 表示每天的整点执行一次该方法 |
initialDelay | 在系统初始延迟时间之后开始首次执行。 示例:@Scheduled(initialDelay = 2000, fixedRate = 5000) 在系统初始后,延迟2秒后开始,然后每5秒执行一次 |
cron 语法
简单介绍
Cron 表达式是一种由6到7个字段组成的字符串,每个字段代表时间的一个部分。这些字段以空格分隔,依次是:
秒(0-59)
分钟(0-59)
小时(0-23)
日期(1-31)
月份(1-12或JAN-DEC)
星期(1-7或SUN-SAT,周日为1)
年份(可选)
通常你会看到6个字段的Cron表达式(年份通常不使用)。每个字段中的值可以是数字、特殊符号或者范围表示。
特殊符号
*(星号):表示所有可能的值。如在分钟字段中使用,表示每分钟触发。
?(问号):仅在日期和星期字段中使用。表示不指定值,通常是因为在另一个字段中已经指定了条件。
-(连字符):表示一个范围。例如,1-5表示从1到5的范围。
,(逗号):表示列出多个值。例如,1,3,5表示1、3和5。
/(斜杠):表示步长。例如,0/15在秒字段中表示从0秒开始每15秒触发。
L:在日期字段中表示最后一天;在星期字段中表示最后一个星期几。例如,L在日期字段中表示该月的最后一天,在星期字段中表示周六。
W:表示工作日(星期一至五)。例如,15W表示离15号最近的工作日。
#:在星期字段中使用,表示一个特定的星期几。例如,2#3表示每月的第三个星期二
例子
每天早上9点执行一次
@Scheduled(cron = "0 0 9 * * ?")
每月的第一个星期一早上10点执行
@Scheduled(cron = "0 0 10 ? * 2#1")
每周三和周五下午2点执行
@Scheduled(cron = "0 0 14 ? * 3,5")
每隔10分钟执行一次
@Scheduled(cron = "0 */10 * * * ?")
每个月的最后一天晚上11点执行
@Scheduled(cron = "0 0 23 L * ?")
使用 @Scheduled 注解注意事项
线程安全
@Scheduled 注解的方法可能会被多个线程同时执行。如果方法不是线程安全的,可能导致数据竞争和其他并发问题。因此,在使用 @Scheduled 注解时,确保方法是线程安全的。
执行时间
如果定时任务的执行时间比间隔时间长,会导致方法重叠执行。根据需要调整 fixedRate 参数或 fixedDelay 参数。
配置
确保在 Spring 配置文件中启用了任务调度。通常在主应用类或配置类中使用 @EnableScheduling 注解。
异常处理
在定时任务中要注意异常处理,以免任务在发生错误时被中断。可以通过捕获和记录异常,或者重试失败任务来提高可靠性。