Spring 注解速查：@Scheduled

在学习中容易碰到各种各样的注解，查完后还是容易忘记，打算做个注解速查系列，方便自己忘记可以回来速查，也方便大家快速找到想要的知识

@Scheduled

在现代应用中，定时任务非常重要，能够帮助我们定期执行数据处理、清理过期数据或发送定期通知。Spring 框架提供了 @Scheduled 注解，让定时任务的实现变得简单。

@Scheduled 注解是 Spring 框架提供的，用于在特定的时间间隔或特定的时间点自动调度执行某个方法。

它通常用于定时任务的实现，允许开发者在后台执行不需要用户手动触发的任务。

@Scheduled 注解中常见的几个属性：

fixedRate

fixedRate: 以固定的频率执行任务，单位为毫秒。这个属性表示方法执行的时间间隔，不管前一个任务是否执行完，都会每隔设定的时间执行一次。

• 例如：@Scheduled(fixedRate = 5000) 表示每 5 秒执行一次被注解标识的方法。
• 注意：如果任务执行时间超过设定间隔，可能会导致任务重叠。

fixedDelay

fixedDelay: 以固定的延迟执行任务。它不同于 fixedRate，fixedDelay 会在上一次任务完成后，再等待指定的时间再执行。

• 例如：@Scheduled(fixedDelay = 5000)，如果上一次任务执行了 2 秒，那么方法会在上一次任务完成后的 5 秒后再次执行。
• 适合需要确保前一个任务完成后再执行的情况。

initialDelay

initialDelay: 指定任务的初始延迟时间。这个属性在任务启动时会等待一段时间，然后再开始执行。

• 例如：@Scheduled(initialDelay = 10000, fixedRate = 5000) 表示第一次任务会在 10 秒后开始，然后每隔 5 秒执行一次。

cron表达式

cron: 使用 cron 表达式来定义复杂的调度规则。Cron 表达式允许你更灵活地控制任务的执行时间，比如在某个具体的时间点或者周期性的某个时间范围内运行任务。

• 例如：@Scheduled(cron = "0 0 * * * ?") 表示每小时的整点执行任务。
• 例如：@Scheduled(cron = "0/5 * * * * ? ")与@Scheduled(fixedRate = 5000) 是等价的
• 使用 cron 表达式定义复杂的调度规则，允许更灵活地控制任务执行时间，提供更多的使用场景。
• 可以借助在线Cron表达式生成器-奇Q工具网)来编写复杂的 cron 表达式

总结

合理使用 @Scheduled 注解，可以轻松实现定时任务，提升应用的自动化程度和工作效率。在项目中应根据具体需求选择合适的调度策略。

参考资料

有关 @Scheduled 注解的详细信息和用法，请参见以下文档：Scheduled (Spring Framework 6.1.13 API)。