SpringBoot - 实现启动时执行指定任务(CommandLineRunnerApplicationRunner)

Posted 张志翔 ̮

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了SpringBoot - 实现启动时执行指定任务(CommandLineRunnerApplicationRunner)相关的知识,希望对你有一定的参考价值。

有时一些特殊的任务需要在系统启动时执行,例如配置文件加载、数据库初始化等操作。Spring Boot 提供了两种解决方案:CommandLineRunner 和 ApplicationRunner。二者使用方式大体一致,差别主要体现在参数上。
一、使用 CommandLineRunner

1,基本介绍

Spring Boot 项目在启动时会遍历所有的 CommandLineRunner 的实现类并调用其中的 run 方法。

  • 如果整个系统中有多个 CommandLineRunner 的实现类,那么可以使用 @Order 注解对这些实现类的调用顺序进行排序(数字越小越先执行)。
  • run 方法的参数是系统启动是传入的参数,即入口类中 main 方法的参数(在调用 SpringApplication.run 方法时被传入 Spring Boot 项目中)

2,使用样例

(1)首先在项目中添加两个 CommandLineRunner 新建两个类,它们内容分别如下,就是把启动时传入的参数打印出来:

@Component
@Order(1)
public class MyCommandLineRunner1 implements CommandLineRunner 
    @Override
    public void run(String... args) throws Exception 
        System.out.println("Runner1>>>"+ Arrays.toString(args));
    

 
@Component
@Order(2)
public class MyCommandLineRunner2 implements CommandLineRunner 
    @Override
    public void run(String... args) throws Exception 
        System.out.println("Runner2>>>"+ Arrays.toString(args));
    

(2)我们可以配置在系统启动时需要传入的参数,这里以 intelliJ IDEA 为例,单击右上角的编辑启动配置。

(3)在弹出页中编辑 Program arguments 栏目,在里面填写需要传入的参数。如果有多个参数,参数之间使用空格隔开。这里我们既配了选项参数,也配了非选项参数。

如果我们将项目打包,以 jar 包的形式运行。那么这些参数可以跟在启动命令后面:

java -jar springboot-demo-0.0.1-SNAPSHOT.jar --name=zhangsan --age=25 zhangsan1 251

(4)启动项目,控制台输出如下:

二、使用 ApplicationRunner
 

1,基本介绍

(1)ApplicationRunner 用法和 CommandLineRunner 基本一致。项目在启动时会遍历所有的 ApplicationRunner 的实现类并调用其中的 run 方法。

如果整个系统中有多个 ApplicationRunner 的实现类,同样可以使用 @Order 注解对这些实现类的调用顺序进行排序(数字越小越先执行)。

(2)ApplicationRunner 与 CommandLineRunner 的区别主要体现在 run 方法的参数上。不同于 CommandLineRunner 中的 run 方法的数组参数,ApplicationRunner 里 run 方法的参数是一个 ApplicationArguments 对象。

ApplicationArguments 区分选项参数和非选项参数:

  • 对于非选项参数:我们可以通过 ApplicationArguments 的 getNonOptionArgs() 方法获取,获取到的是一个数组。
  • 对于选项参数:可以通过 ApplicationArguments 的 getOptionNames() 方法获取所有选项名称。通过 getOptionValues() 方法获取实际值(它会返回一个列表字符串)。

2,使用样例

(1)首先在项目中添加两个 ApplicationRunner,它们内容分别如下,就是把启动时传入的参数打印出来:

@Component
@Order(1)
public class MyApplicationRunner1 implements ApplicationRunner 
    @Override
    public void run(ApplicationArguments args) throws Exception 
        List<String> nonOptionArgs = args.getNonOptionArgs();
        System.out.println("Runner1[非选项参数]>>> " + nonOptionArgs);
        Set<String> optionNames = args.getOptionNames();
        for(String optionName: optionNames) 
            System.out.println("Runner1[选项参数]>>> name:" + optionName
                    + ";value:" + args.getOptionValues(optionName));
        
    

 
@Component
@Order(2)
public class MyApplicationRunner2 implements ApplicationRunner 
    @Override
    public void run(ApplicationArguments args) throws Exception 
        List<String> nonOptionArgs = args.getNonOptionArgs();
        System.out.println("Runner2[非选项参数]>>> " + nonOptionArgs);
        Set<String> optionNames = args.getOptionNames();
        for(String optionName: optionNames) 
            System.out.println("Runner2[选项参数]>>> name:" + optionName
                    + ";value:" + args.getOptionValues(optionName));
        
    

(2)启动项目,控制台输出如下:

以上是关于SpringBoot - 实现启动时执行指定任务(CommandLineRunnerApplicationRunner)的主要内容,如果未能解决你的问题,请参考以下文章

springboot框架实现启动项目执行指定代码

SpringBoot任务调度

springboot启动项目时执行任务,从数据库或者redis获取系统参数

SpringBoot——实现系统启动任务

SpringBoot启动任务

SpringBoot入门十一,启动后自动执行指定代码