Spring定时任务 - @Scheduled注解详解
文章目录
- 一、@Scheduled注解
- 二、参数详解
- 2.1、CRON_DISABLED
- 2.2、cron
- 2.3、zone
- 2.4、fixedDelay / fixedDelayString
- 2.5、fixedRate / fixedRateString
- 2.6、initialDelay / initialDelayString
- 三、总结
- 3.1、fixedDelay、fixedRate
以下内容基于org.springframework:spring-context:5.3.12.jar进行讲解@Scheduled中的属性
@Scheduled注解是spring boot提供的用于定时任务控制的注解,主要用于控制任务在某个指定时间执行,或者每隔一段时间执行.注意需要配合@EnableScheduling使用,配置@Scheduled主要有三种配置执行时间的方式,cron,fixedRate,fixedDelay。它的配置一共有8个参数。
一、@Scheduled注解
@Scheduled注解共有8个属性(其中有3组只是不同类型的相同配置)和一个常量CRON_DISABLED,源码如下:
/*** 标记要调度的方法的注释。 必须准确指定 cron、fixedDelay 或 fixedRate 属性之一。带注释的方法必须没有参数。 * 它通常有一个 void 返回类型; 如果不是,则在通过调度程序调用时将忽略返回值。@Scheduled 注解的处理是通过注册* 一个 ScheduledAnnotationBeanPostProcessor 来执行的。 这可以手动完成,或者更方便的是,通过 * <task:annotation-driven/> 元素或 @EnableScheduling 注释。* 此注释可用作元注释以创建具有属性覆盖的自定义组合注释。* @since 3.0* @see EnableScheduling* @see ScheduledAnnotationBeanPostProcessor* @see Schedules*/
@Target({ElementType.METHOD, ElementType.ANNOTATION_TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Repeatable(Schedules.class)
public @interface Scheduled {/*** 指示禁用触发器的特殊 cron 表达式值:“-”。* 这主要用于 ${...} 占位符,允许外部禁用相应的计划方法。* * @since 5.1* @see ScheduledTaskRegistrar#CRON_DISABLED*/String CRON_DISABLED = ScheduledTaskRegistrar.CRON_DISABLED;/*** 一个类似 cron 的表达式,扩展了通常的 UN*X 定义以包括秒、分、小时、月中的某一天、月份和星期几的触发器。* 例如,“0 * * * * MON-FRI”表示工作日每分钟一次(在分钟的顶部 - 第 0 秒)。* * 从左到右读取的字段解释如下:* <ul>* <li>second</li>* <li>minute</li>* <li>hour</li>* <li>day of month</li>* <li>month</li>* <li>day of week</li>* </ul>* 特殊值“-”表示禁用的 cron 触发器,主要用于由 ${...} 占位符解析的外部指定值。* @return 返回一个可以解析为 cron 计划的表达式* @see org.springframework.scheduling.support.CronSequenceGenerator*/String cron() default "";/*** 将解析 cron 表达式的时区。 默认:""(即使用服务器的本地时区)。* * @return java.util.TimeZone.getTimeZone(String) 接受的区域 ID,或指示服务器默认时区的空字符串* @since 4.0* @see org.springframework.scheduling.support.CronTrigger#CronTrigger(String, java.util.TimeZone)* @see java.util.TimeZone*/String zone() default "";/*** 在上次调用结束和下一次调用开始之间的固定时间段,单位:毫秒,默认:-1(不延迟)* * @return 延迟时长,单位:毫秒*/long fixedDelay() default -1;/*** 上次调用的结束和下一次调用的开始之间固定时间间隔字符串,单位:毫秒。 * * @return 延迟值字符串,单位:毫秒,例如占位符或* {@link java.time.Duration#parse java.time.Duration} 兼容值* @since 3.2.2*/String fixedDelayString() default "";/*** 在调用之间的固定时间段,单位:毫秒。* * @return 以毫秒为单位的周期*/long fixedRate() default -1;/*** 在调用之间的固定时间段字符串,单位:毫秒。* * @return 延迟值字符串,单位:毫秒,例如占位符或 * {@link java.time.Duration#parse java.time.Duration} 兼容值* @since 3.2.2*/String fixedRateString() default "";/*** 在第一次执行 fixedRate 或 fixedDelay 任务之前延迟的毫秒数。* * @return 初始延迟值,单位:毫秒* @since 3.2*/long initialDelay() default -1;/*** 在第一次执行 fixedRate 或 fixedDelay 任务之前延迟的毫秒数字符串。* @return 初始延迟值字符串,单位:毫秒,例如占位符或符合 java.time.Duration 的值* @since 3.2.2*/String initialDelayString() default "";}
二、参数详解
2.1、CRON_DISABLED
CRON_DISABLED 的值为- , 当cron表达式的值设置为-时表示禁用该定时任务。
测试示例:
@EnableScheduling
@Component
@Slf4j
public class ScheduleTest {//cron表达式为-时表示禁用该定时任务, 可以在application.properties中配置cron表达式达到动态开启/关闭定时任务的效果@Scheduled(cron = "-")public void test_1() {log.info("测试任务1: " + System.currentTimeMillis());}//在application.properties中配置cron表达式, 然后用${}动态获取@Scheduled(cron = "${schedule.test2Cron}")public void test_2() {log.info("测试任务2: " + System.currentTimeMillis());}}
2.2、cron
该参数接收一个cron表达式字符串,字符串以5或6个空格隔开,分开共6或7个域,每一个域代表一个含义,,其顺序和含义见对应注释说明,如下:
[秒] [分] [小时] [日] [月] [周] [年]
其中,[年]不是必须的域,可以省略[年],省略[年]则一共6个域。
| 域 | 必填 | 值的范围 | 允许的通配符 |
|---|---|---|---|
| 秒 | 是 | 0-59 | , - * / |
| 分 | 是 | 0-59 | , - * / |
| 时 | 是 | 0-23 | , - * / |
| 日 | 是 | 1-31 | , - * ? / L W |
| 月 | 是 | 1-12 / JAN-DEC | , - * / |
| 周 | 是 | 1-7 or SUN-SAT | , - * ? / L # |
| 年 | 否 | 1970-2099 | , - * / |
通配符说明:
*: 所有值。 例如:在 [分] 上设置 * 则每一分钟都会触发执行。
?: 不指定值。使用的场景为不需要关心当前设置这个字段的值。例如:要在每月的1号触发执行,而不关心是星期几,所以需要 [周] 上设置为?, 具体设置为:“0 0 0 1 * ?”。
-: 区间。例如:在 [时] 上设置 “1-3” ,则1,2,3点都会触发执行。
,: 指定多个值,例如在 [周] 上设置 “MON,WED,FRI” 表示周一,周三和周五触发。
/: 用于递增触发。如在 [秒] 上设置”5/15” 表示从5秒开始,每增15秒触发(5,20,35,50)。 在 [日] 上设置’1/3’所示每月1号开始,每隔三天触发一次。
L: 最后的意思(Last)。在 [日] 字段设置上,表示当月的最后一天(依据当前月份,如果是二月还会依据是否是润年[leap]), 在 [周] 上表示星期六,相当于”7”或”SAT”。如果在”L”前加上数字,则表示该数据的最后一个。例如在 [周] 上设置”6L”这样的格式,则表示“本月最后一个星期五”
W: 离指定日期的最近那个工作日(Work Day,周一至周五)。例如在[日] 上置”15W”,表示离每月15号最近的那个工作日触发。如果15号正好是周六,则找最近的周五(14号)触发, 如果15号是周未,则找最近的下周一(16号)触发.如果15号正好在工作日(周一至周五),则就在该天触发。如果指定格式为 “1W”,它则表示每月1号往后最近的工作日触发。如果1号正是周六,则将在3号下周一触发。(注: ”W”前只能设置具体的数字,不允许区间”-“)。
#: 序号(表示每月的第几个周几),例如在 [周] 上设置”6#3”表示在每月的第三个周六,注意如果指定”#5”,正好第五周没有周六,则不会触发该配置(适用于没有固定日期的节假日:如母亲节和父亲节) 。
注意:
1)’L’和 ‘W’可以一组合使用。如果在 [日] 上设置”LW”,则表示在本月的最后一个工作日触发
2)周字段的设置,若使用英文字母是不区分大小写的,即MON与mon相同。
3)cron属性如注释中所说,支持${ }表达式,可从spring配置文件中动态获取配置的cron表达式:
示例
- 每隔5秒执行一次:/5 * ?
- 每隔1分钟执行一次:0 /1 ?
- 每天23点执行一次:0 0 23 ?
- 每天凌晨1点执行一次:0 0 1 ?
- 每月1号凌晨1点执行一次:0 0 1 1 * ?
- 每月最后一天23点执行一次:0 0 23 L * ?
- 每周星期六凌晨1点实行一次:0 0 1 ? * L
- 在26分、29分、33分执行一次:0 26,29,33 * ?
- 每天的0点、13点、18点、21点都执行一次:0 0 0,13,18,21 ?
schedule:# 每5秒执行一次任务cron: 0/5 * * * * *# 任务间隔分钟数interval: 15
测试代码
@EnableScheduling
@Component
@Slf4j
public class ScheduleTest {//每5秒执行一次@Scheduled(cron = "${schedule.cron}")public void test_1() {log.info("测试任务1: " + System.currentTimeMillis());}@Scheduled(cron = "* 0/${schedule.interval} * * * *")public void test_2() {log.info("测试任务2: " + System.currentTimeMillis());}}
2.3、zone
时区,接收一个java.util.TimeZone#ID。cron表达式会基于该时区解析。默认是一个空字符串,即取服务器所在地的时区。比如我们一般使用的时区Asia/Shanghai。该字段我们一般留空。
示例:GMT-08:00、
@Scheduled(cron = "0 * * * * MON-FRI", zone = "Asia/Shanghai")
public void test(){logger.info("test: {}", dateFormat.format(new Date()));
}
2.4、fixedDelay / fixedDelayString
fixedDelay是配置的上一次任务执行结束到下一次执行开始的间隔时间,也就是说会等待上一次任务执行结束后,延迟间隔时间,再执行下一次任务
上一次执行完毕时间点之后多长时间再执行,long型。如:
//将一个方法以上一个调用任务的完成之间为基准,在上一个任务完成之后,5s后再执行该方法。
// 上次任务执行结束后5秒再执行下一次
@Scheduled(fixedDelay = 5000)
fixedDelayString与 fixedDelay意思相同,String类型。唯一不同是支持占位符。如:
// 上次任务执行结束后5秒再执行下一次@Scheduled(fixedDelayString = "5000")
占位符的使用
@Scheduled(fixedDelayString = "${schedule.fixed-delay}")public void testFixedDelayString() {System.out.println("schedule running: " + System.currentTimeMillis());}
2.5、fixedRate / fixedRateString
fixedRate是配置上一次任务执行开始到下一次执行开始的间隔时间,不会等待上一次任务执行完成就会调度下一次任务,将其放入等待队列中
上一次开始执行时间点之后多长时间再执行,long型。如:
//上一次开始执行时间点之后5秒再执行//将一个方法以固定速率5s调用一次执行,这个周期是一个任务开始时间为基准,从上一个任务开始执行后5秒后再调用一次。@Scheduled(fixedRate = 5000)
fixedRateString与 fixedRate 意思相同,String类型。唯一不同是支持占位符。
2.6、initialDelay / initialDelayString
第一次延迟多长时间后再执行,long型。如:
// 第一次延迟5秒后执行,之后按fixedRate的规则每10秒执行一次@Scheduled(initialDelay = 5000, fixedRate = 10000)
initialDelayString与 initialDelay 意思相同,String类型。唯一不同是支持占位符。
三、总结
3.1、fixedDelay、fixedRate
1、fixedDelay是配置的上一次任务执行结束到下一次执行开始的间隔时间,也就是说会等待上一次任务执行结束后,延迟间隔时间,再执行下一次任务
2、fixedRate是配置上一次任务执行开始到下一次执行开始的间隔时间,不会等待上一次任务执行完成就会调度下一次任务,将其放入等待队列中
3、fixedRate配置了上一次任务的开始时间到下一次任务的开始时间的间隔,每次任务都会执行;
4、fixedDelay配置了上一次任务的结束时间到下一次任务的开始时间的间隔,每次任务都会执行;
5、cron表达式配置了在哪一刻执行任务,会在配置的任务开始时间判断任务是否可以执行,如果能则执行,不能则会跳过本次执行;
6、如果是强调任务间隔的定时任务,建议使用fixedRate和fixedDelay,如果是强调任务在某时某分某刻执行的定时任务,建议使用cron表达式。
相关文章:
Spring定时任务 - @Scheduled注解详解
文章目录 一、Scheduled注解二、参数详解2.1、CRON_DISABLED2.2、cron2.3、zone2.4、fixedDelay / fixedDelayString2.5、fixedRate / fixedRateString2.6、initialDelay / initialDelayString 三、总结3.1、fixedDelay、fixedRate 以下内容基于org.springframework:spring-con…...
超详细超实用!!!AI编程之cursor编写设计模式接口隔离原则实例(七)
云风网 云风笔记 云风知识库 一、设计模式接口隔离原则定义 客户端不应该被迫依赖于它不使用的方法,一个类对另一个类的依赖应该建立在最小的接口上。要为各个类建立它们需要的专用接口,而不要试图去建立一个很庞大的接口供所有依赖它的类去调用。 接口…...
解决在Nignx下Thinkphp路由不生效问题
Nignx下Tp框架路由不生效 问题的原因在于ThinkPHP通过URL后缀匹配方法,默认没有后缀会尝试访问默认的index方法。 解决方案:在URL末尾添加/后缀或者修改路由配置文件route.php中的规则。 如果还是没解决建议换apache...
『功能项目』QFrameWork框架重构OnGUI【63】
我们打开上一篇62QFrameWork背包框架的项目, 上文将功能实现在一个脚本中 本章要做的事情让脚本实现背包框架思想 首先按照图示创建脚本: 创建脚本:Item.cs namespace QFramework {public class Item{//道具public string Key;public string …...
4款AI生成PPT工具推荐,提升工作效率
在如今的工作环境中,PPT制作是许多技术人员不可避免的任务,尤其是在汇报、展示技术方案、以及项目进展时。随着AI技术的快速发展,使用AI生成PPT成为了提高效率的一种新趋势。本文将介绍几款适合程序员、技术人员的AI生成PPT工具,帮…...
3.postman脚本语言、接口关联(json引用(变量)、脚本用正则表达式)、断言封装、自动化构造接口请求(Postman工具)
一、Postman的脚本语言 1.使用js语言 2.pm变量 pm.sendRequest():发送HTTP请求 二、自动化实现接口关联 1.JSON引用 2.正则表达式(在test下编写如下脚本) //获取响应 console.log(responseBody) //re的方式获取token let token responseBody.match(&quo…...
基于SpringBoot框架的订餐系统设计与实现
文未可获取一份本项目的java源码和数据库参考。 选题的背景 伴随着当今计算机技术的日益发展,各种网络软件以及应用也是层出不穷,日新月异,大家都争先恐后的推出自己的产品来占领这一个广阔的市场。现在网上购物的软件系统种类繁多…...
基于JAVA+SpringBoot+Vue的医院后台管理系统
基于JAVASpringBootVue的医院后台管理系统 前言 ✌全网粉丝20W,csdn特邀作者、博客专家、CSDN[新星计划]导师、java领域优质创作者,博客之星、掘金/华为云/阿里云/InfoQ等平台优质作者、专注于Java技术领域和毕业项目实战✌ 🍅文末附源码下载链接🍅 哈…...
基于SSM+Vue+MySQL的农家乐预约管理系统
系统展示 用户前台界面 管理员后台界面 农家乐后台界面 系统背景 随着乡村旅游的兴起,农家乐作为一种结合农业体验与休闲度假的新型旅游模式,受到了广大游客的青睐。然而,传统农家乐在预约管理方面存在效率低下、信息不透明等问题,…...
全新热门电商API接口,实现闲鱼商品详细搜索功能
近年来,电商行业蓬勃发展,API(Application Programming Interface)接口已经成为电商平台的重要组成部分。API接口不仅可以实现平台间的数据交互,还可以为开发者提供丰富的功能,满足用户多样化的需求。在这个…...
求10 个整数中最大值
我们需要10个整数之中求出10个整数之中的最大值所以我们先要将10个整数先放置到一个容器之中,我们初期就使用数组的形式存放10个数组即设置数组arr[10],我们要将10个数组之中的数字输出出来,我们这里使用的是遍历循环输出数组。我们这里是使用…...
数据结构不再难懂:带你轻松搞定排序算法
数据结构入门学习(全是干货)——排序算法(下) 1 快速排序 1.1 算法概述 快速排序采用分而治之的策略,与归并排序相似。其核心在于选择一个主元(pivot)作为分割点。 分而治之 主元(pivot)>…...
YOLOv8 OBB win10+ visual 2022移植部署
前言 想做一个目标旋转角度检测的工程,但是网上多少python的,或者linux的。在win10 visual 2022移植部署,记录一下。 参考 这篇文章没有C win10 环境下的部署教程,我相对于是对此做了补充。 1、下载工程 https://github.com/sh…...
E+H超声波物位仪FMU42-ATB2A22A
EH超声波物位仪FMU42-ATB2A22A是一款由德国EH(恩德斯豪斯)公司生产的超声波物位计,具有高精度、非接触式测量等特点,广泛应用于液体、浆料和粗料的物位测量。以下是对该产品的详细介绍: 一、产品特点 高精度测量&…...
Linux风险应对策略:保障系统安全的有效措施
Linux作为一种开源操作系统,因其稳定性和安全性被广泛应用于服务器、嵌入式系统和个人电脑等多个领域。然而,随着网络攻击手段的不断演变,Linux系统也面临着各种安全风险。本文将探讨Linux系统的主要风险及其应对策略,帮助用户提升…...
芝法酱学习笔记(0.3)——SpringBoot下使用mybatis做增删改查和报表
零、前言 书接上回,我们搭建了windows下的开发环境,并给出了一个hello world级别的多模块SpringBoot项目。 毕竟java后端开发,离不开数据库的操作,为方便后面内容的讲解,这里再做一期铺垫,core模块下新增一…...
windows msys2 编译x264 32位动态库
一、打开mingw32 查看gcc版本 gcc --version 提示找不到gcc,可以安装gcc pacman -S gcc 二、进入x264-master目录 cd /d/x264-master 执行 ./configure --prefix/d/x264-master/Bin --disable-asm --enable-static --enable-shared --disable-thread其中--disa…...
【pytorch】relu的实现逻辑
笔者最近在尝试实现AlexNet的底层算子,基于pytorch的框架,本文主要记录一下pytorch中是如何实现relu算子的。 首先最外层是位于torch\nn\modules\activation.py,主要代码如下: __constants__ ["inplace"]inplace: bool…...
【Python篇】深入机器学习核心:XGBoost 从入门到实战
文章目录 XGBoost 完整学习指南:从零开始掌握梯度提升1. 前言2. 什么是XGBoost?2.1 梯度提升简介 3. 安装 XGBoost4. 数据准备4.1 加载数据4.2 数据集划分 5. XGBoost 基础操作5.1 转换为 DMatrix 格式5.2 设置参数5.3 模型训练5.4 预测 6. 模型评估7. 超…...
简单学习 原码反码补码 学会了你才是真正的程序员了
一、简单介绍原码反码补码 首先我们需要知道的是原码反码补码是一个人为的行为,因为机器看的都是所谓的补码,这个反码只是作为补码的到原码也就是人能看懂的跳板,所以计算机无论是计算器里面的东西还是他底层运行的二进制代码都是补码&#x…...
铭豹扩展坞 USB转网口 突然无法识别解决方法
当 USB 转网口扩展坞在一台笔记本上无法识别,但在其他电脑上正常工作时,问题通常出在笔记本自身或其与扩展坞的兼容性上。以下是系统化的定位思路和排查步骤,帮助你快速找到故障原因: 背景: 一个M-pard(铭豹)扩展坞的网卡突然无法识别了,扩展出来的三个USB接口正常。…...
挑战杯推荐项目
“人工智能”创意赛 - 智能艺术创作助手:借助大模型技术,开发能根据用户输入的主题、风格等要求,生成绘画、音乐、文学作品等多种形式艺术创作灵感或初稿的应用,帮助艺术家和创意爱好者激发创意、提高创作效率。 - 个性化梦境…...
基于大模型的 UI 自动化系统
基于大模型的 UI 自动化系统 下面是一个完整的 Python 系统,利用大模型实现智能 UI 自动化,结合计算机视觉和自然语言处理技术,实现"看屏操作"的能力。 系统架构设计 #mermaid-svg-2gn2GRvh5WCP2ktF {font-family:"trebuchet ms",verdana,arial,sans-…...
Zustand 状态管理库:极简而强大的解决方案
Zustand 是一个轻量级、快速和可扩展的状态管理库,特别适合 React 应用。它以简洁的 API 和高效的性能解决了 Redux 等状态管理方案中的繁琐问题。 核心优势对比 基本使用指南 1. 创建 Store // store.js import create from zustandconst useStore create((set)…...
ESP32读取DHT11温湿度数据
芯片:ESP32 环境:Arduino 一、安装DHT11传感器库 红框的库,别安装错了 二、代码 注意,DATA口要连接在D15上 #include "DHT.h" // 包含DHT库#define DHTPIN 15 // 定义DHT11数据引脚连接到ESP32的GPIO15 #define D…...
el-switch文字内置
el-switch文字内置 效果 vue <div style"color:#ffffff;font-size:14px;float:left;margin-bottom:5px;margin-right:5px;">自动加载</div> <el-switch v-model"value" active-color"#3E99FB" inactive-color"#DCDFE6"…...
令牌桶 滑动窗口->限流 分布式信号量->限并发的原理 lua脚本分析介绍
文章目录 前言限流限制并发的实际理解限流令牌桶代码实现结果分析令牌桶lua的模拟实现原理总结: 滑动窗口代码实现结果分析lua脚本原理解析 限并发分布式信号量代码实现结果分析lua脚本实现原理 双注解去实现限流 并发结果分析: 实际业务去理解体会统一注…...
C++ 求圆面积的程序(Program to find area of a circle)
给定半径r,求圆的面积。圆的面积应精确到小数点后5位。 例子: 输入:r 5 输出:78.53982 解释:由于面积 PI * r * r 3.14159265358979323846 * 5 * 5 78.53982,因为我们只保留小数点后 5 位数字。 输…...
AI编程--插件对比分析:CodeRider、GitHub Copilot及其他
AI编程插件对比分析:CodeRider、GitHub Copilot及其他 随着人工智能技术的快速发展,AI编程插件已成为提升开发者生产力的重要工具。CodeRider和GitHub Copilot作为市场上的领先者,分别以其独特的特性和生态系统吸引了大量开发者。本文将从功…...
Unit 1 深度强化学习简介
Deep RL Course ——Unit 1 Introduction 从理论和实践层面深入学习深度强化学习。学会使用知名的深度强化学习库,例如 Stable Baselines3、RL Baselines3 Zoo、Sample Factory 和 CleanRL。在独特的环境中训练智能体,比如 SnowballFight、Huggy the Do…...
