Springboot中@scheduled注解解析

 更新时间:2023年09月25日 10:18:03   作者:MrMoving  
这篇文章主要介绍了Springboot中@scheduled注解解析,定时任务就是在指定时间执行程序,或周期性执行计划任务,Java中实现定时任务的方法有很多,本文从从JDK自带的一些方法来实现定时任务的需求,需要的朋友可以参考下

Springboot中@scheduled注解解析

在这里插入图片描述

关于该注解的详细属性介绍这里不做记录。也可直接参考源码注释 (部分详细内容写好后意外被某N吃了,这里只大致记录一下)

使用细节

1. 需要配合@EnableScheduling注解使用

@EnableScheduling可以加在启动类上或者配置类上

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Import(SchedulingConfiguration.class)
@Documented
public @interface EnableScheduling {
}

可以看出它没有任何属性。所以只有一个@Import在起作用,引入了SchedulingConfiguration,它的作用在xml文件中相当于:

<task:annotation-driven>
@Configuration(proxyBeanMethods = false)
@Role(BeanDefinition.ROLE_INFRASTRUCTURE)
public class SchedulingConfiguration {
	@Bean(name = TaskManagementConfigUtils.SCHEDULED_ANNOTATION_PROCESSOR_BEAN_NAME)
	@Role(BeanDefinition.ROLE_INFRASTRUCTURE)
	public ScheduledAnnotationBeanPostProcessor scheduledAnnotationProcessor() {
		return new ScheduledAnnotationBeanPostProcessor();
	}
}

同样的,SchedulingConfiguration也非常非常的简单。只是向容器注入了一个ScheduledAnnotationBeanPostProcessor,核心逻辑所在类

2. @Scheduled主要有三种配置执行时间的方式

注解的方法必须是无参的

cron 参考cron表达式

fixedRate 表示自上一次执行开始之后多长时间执行,以毫秒为单位

fixedDelay 表示上一次执行完毕之后多长时间执行,单位也是毫秒。

后两种方式可以配置初始间隔时间initialDelay

3. 该注解允许重复注解,即一个方法可以按不同的规则作为多个任务执行。

@Repeatable(Schedules.class)
public @interface Scheduled {
}

method方法分别会在每天0点以及每周三12点执行一次

    @Scheduled(cron = "0 0 0 * * ?")
    @Scheduled(cron = "0 0 12 ? * WED")
    public void method() {
        System.err.println("hello world");
    }

4. 控制定时任务的执行顺序

默认是同步执行的,因为使用的默认线程池是单一线程的,逻辑在ScheduledTaskRegistrar类中

如果对执行顺序有要求的定时任务(前提是任务的执行是单线程串行的),有如下两种情况:

  • 在某一时刻同时执行 如任务A在零点初始化数据,任务B每分钟更新数据。那么在零点,必须是任务A先执行,其次才是B。但加锁只能保证线程安全,不能保证执行顺序。在这种情况下,我们可以借助redis设置获取锁的顺序,亦或标志字进行执行顺序的判断。
  • 总是同时执行 在任务间隔相同的情况下,一般为业务的解耦,不应操作共享资源,应当放至同一个定时任务中执行。

spring在初始化bean后,通过“postProcessAfterInitialization”拦截到所有的用到“@Scheduled”注解的方法,并解析相应的的注解参数,按顺序放入“定时任务列表”等待后续处理;之后在“定时任务列表”中统一按顺序执行相应的定时任务(注册顺序取决于类以及方法的位置前后,执行顺序还要考虑@Scheduled注解的参数配置方式,所以实际上我们并不能依赖于这种默认顺序)

5. 异步执行任务

有两种方式:

  • 配合@Async注解
  • 指定任务调度的线程池

6. 在Spring项目中使用@Scheduled注解,配合配置文件定义简单定时任务

在Spring的配置文件中添加定时任务相关配置:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:task="http://www.springframework.org/schema/task"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
       http://www.springframework.org/schema/beans/spring-beans.xsd
       http://www.springframework.org/schema/task
       http://www.springframework.org/schema/task/spring-task.xsd">
    <!-- 指定定时任务的执行者为下面定义的bean,这样就不会是默认的单线程执行任务了 --> 
	  <task:annotation-driven scheduler="schedule"/>
    <!-- 相当于引入了名为schedule的ThreadPoolTaskScheduler对象 -->
    <task:scheduler id="schedule" pool-size="5"/>
</beans>

不使用注解也能定义任务,DemoTask上未使用任何注解

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:task="http://www.springframework.org/schema/task"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
       http://www.springframework.org/schema/beans/spring-beans.xsd
       http://www.springframework.org/schema/task
       http://www.springframework.org/schema/task/spring-task.xsd">
		<bean id="demoTask" class="tasks.DemoTask"/>
		<!-- 不指定scheduler会默认去找名为taskScheduler的bean,那么注解形式和xml形式的定时任务使用的就不是同一个线程池 -->
		<task:annotation-driven scheduler="scheduledjob"/>
    <task:scheduler id="scheduledjob" pool-size="10"/>  
    <!-- 这里不指定schedule的话,也是会默认去找名为taskScheduler的bean-->
    <task:scheduled-tasks scheduler="scheduledjob">
        <task:scheduled ref="demoTask" method="method2" fixed-rate="2000"/>
    </task:scheduled-tasks>
</beans>

约定大于配置,如果对配置不熟悉,建议scheduler的id使用默认的taskScheduler,且要么都默认不指定scheduler,要么都指定为同一个scheduler

ThreadPoolTaskScheduler

该类为默认的定时任务执行管理者,内部包装了一个ScheduledThreadPoolExecutor线程池,默认核心线程数为1,也解释了为什么spring定时任务默认是单线程的。

private volatile int poolSize = 1;
	@Nullable
	private ScheduledExecutorService scheduledExecutor;
	this.scheduledExecutor = createExecutor(this.poolSize, threadFactory, rejectedExecutionHandler);

7. 任务未完成

如果某个cron格式的定时任务执行未完成会出现什么现象呢?

答:此任务一直无法执行完成,无法设置下次任务执行时间,之后会导致此任务后面的所有定时任务无法继续执行,也就会出现所有的定时任务“失效”现象。

所以应用springBoot中定时任务的方法中,一定不要出现“死循环”、“http持续等待无响应”现象,否则会导致定时任务程序无法正常。

8. 任务执行时间过长

A任务执行时间过长,可能的影响,是否会影响此任务的下一次执行,以及影响其他任务B的准时执行

供参考标准使用方式

@Configuration
@EnableScheduling
public class ScheduledExecutorConfig implements SchedulingConfigurer {
    private final int corePoolSize = 10;
    private final String feature = "ScheduledTask";
    @Override
    public void configureTasks(ScheduledTaskRegistrar scheduledTaskRegistrar) {
        // 方式一:创建一个ScheduledThreadPoolExecutor
        scheduledTaskRegistrar.setScheduler(taskExecutor());
        // 方式二 :可议直接使用一个TaskScheduler  然后设置上poolSize等参数即可
//        ThreadPoolTaskScheduler taskScheduler = new ThreadPoolTaskScheduler();
//        taskScheduler.setPoolSize(corePoolSize);
//        taskScheduler.initialize(); // 手动初始化,同样会创建一个ScheduledThreadPoolExecutor
//        scheduledTaskRegistrar.setTaskScheduler(taskScheduler);
        // 题外话,通过这我们可以捕获到ScheduledTaskRegistrar,从而我们可以通过接口动态的去改变或添加任务
        scheduledTaskRegistrar.addFixedRateTask(() -> System.out.println("执行定时任务1: " + System.currentTimeMillis()), 1000);
    }
    @Bean(destroyMethod = "shutdown")
    public ScheduledExecutorService taskExecutor() {
        return new ScheduledThreadPoolExecutor(corePoolSize, new ThreadFactoryConfig(feature));
    }
}

或者在一个配置类中直接注入TaskScheduler

    @Bean
    public TaskScheduler taskScheduler() {
        ThreadPoolTaskScheduler scheduler = new ThreadPoolTaskScheduler();
        scheduler.setPoolSize(10);
        return scheduler;
    }   

其他

Task在平时业务开发中确实使用非常的广泛,但在分布式环境下,其实已经很少使用Spring自带的定时器了,而使用分布式任务调度框架:Elastic-job、xxl-job等

到此这篇关于Springboot中@scheduled注解解析的文章就介绍到这了,更多相关@scheduled注解内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • java使用观察者模式异步短信/邮箱提醒用户群

    java使用观察者模式异步短信/邮箱提醒用户群

    这篇文章主要为大家详细介绍了java使用观察者模式异步短信和邮箱提醒用户群,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2018-11-11
  • SpringBoot自定义启动界面的实现代码

    SpringBoot自定义启动界面的实现代码

    实现自定义启动动画是一项有趣的任务,虽然Spring Boot本身不提供内置的动画功能,但可以通过一些技巧来实现,本文主要以Demo的形式展示,再者下面的Demo都可以联合使用,需要的朋友可以参考下
    2024-07-07
  • 分析mybatis运行原理

    分析mybatis运行原理

    Mybatis是一个优秀的持久层框架,它对JDBC操作数据库的过程进行封装,使开发者只需要关注sql本身。我们原来使用JDBC操作数据库,需要手动的写代码去注册驱动、获取connection、获取statement等等,现在Mybaits帮助我们把这些事情做了,我们只需要关注我们的业务sql即可
    2021-06-06
  • java分布式面试接口如何保证幂等及概念理解

    java分布式面试接口如何保证幂等及概念理解

    这篇文章主要为大家介绍了java分布式面试中接口如何保证幂等的问题解答以及概念描述,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步
    2022-03-03
  • SpringBoot的@RestControllerAdvice作用详解

    SpringBoot的@RestControllerAdvice作用详解

    这篇文章主要介绍了SpringBoot的@RestControllerAdvice作用详解,@RestContrllerAdvice是一种组合注解,由@ControllerAdvice,@ResponseBody组成,本质上就是@Component,需要的朋友可以参考下
    2024-01-01
  • String类型传递是值传递,char[]类型传递是引用传递的实现

    String类型传递是值传递,char[]类型传递是引用传递的实现

    下面小编就为大家带来一篇String类型传递是值传递,char[]类型传递是引用传递的实现。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看不
    2016-09-09
  • 一文带你学会Java中ScheduledThreadPoolExecutor使用

    一文带你学会Java中ScheduledThreadPoolExecutor使用

    ScheduledThreadPoolExecutor是Java并发包中的一个类,同时也是 ThreadPoolExecutor的一个子类,本文主要为大家介绍一下ScheduledThreadPoolExecutor使用,需要的可以参考下
    2024-12-12
  • Java线程中的Timer和TimerTask原理详解

    Java线程中的Timer和TimerTask原理详解

    这篇文章主要介绍了Java线程中的Timer和TimerTask原理详解,Timer和TimerTask成对出现,Timer是定时器,TimerTask是定时任务,换句话说,定时任务TimerTask是给定时器Timer执行的具体任务,需要的朋友可以参考下
    2023-10-10
  • SpringBoot中的@ConditionalOnMissingBean注解使用详解

    SpringBoot中的@ConditionalOnMissingBean注解使用详解

    这篇文章主要介绍了SpringBoot中的@ConditionalOnMissingBean注解使用详解,@ConditionalOnMissingBean作用在@Bean定义上,也就是说在容器加载它作用的Bean时,检查容器中是否存在目标类型,需要的朋友可以参考下
    2024-01-01
  • Springboot上传文件与物理删除功能

    Springboot上传文件与物理删除功能

    文章介绍了在Springboot中实现文件上传和删除的功能,实现了图片的上传与删除,删除数据库记录时,同步删除了文件,结合实例代码给大家讲解的非常详细,感兴趣的朋友跟随小编一起看看吧
    2026-01-01

最新评论