SpringBoot2.x基础篇：使用CommandLineRunner或ApplicationRunner

知识改变命运，撸码使我快乐，2020继续游走在开源界

点赞再看，养成习惯

给我来个Star吧，点击了解下基于SpringBoot的组件化接口服务落地解决方案

如果你想要使用SpringBoot构建的项目在启动后运行一些特定的代码，那么CommandLineRunner、ApplicationRunner都是很好的选择。

推荐阅读

• SpringBoot2.x 教程汇总

使用方式

我们以CommandLineRunner创建了一个简单的例子，如下所示：

/**
 * {@link CommandLineRunner}接口使用示例
 *
 * @author 恒宇少年
 */
@Component
public class CommandLineRunnerExample implements CommandLineRunner {
    /**
     * 实例化本类的日志采集器
     */
    static LoggingCollector logging = LoggingCollectorFactory.getCollector(CommandLineRunnerExample.class);

    @Override
    public void run(String... args) throws Exception {
        // 执行特定的代码
        logging.debug("main方法参数列表：{}", args);
    }
}

CommandLineRunner接口的定义很简单，只提供了一个名为#run()的方法，我们只需要实现该方法做一些自定义的业务逻辑即可，ApplicationRunner接口的使用方式也是一样的。

两者的区别？

从源码上分析，CommandLineRunner与ApplicationRunner两者之间只有#run()方法的参数不一样而已。

CommandLineRunner：

@FunctionalInterface
public interface CommandLineRunner {

    /**
     * Callback used to run the bean.
     * @param args incoming main method arguments
     * @throws Exception on error
     */
    void run(String... args) throws Exception;

}

ApplicationRunner：

@FunctionalInterface
public interface ApplicationRunner {

    /**
     * Callback used to run the bean.
     * @param args incoming application arguments
     * @throws Exception on error
     */
    void run(ApplicationArguments args) throws Exception;

}

CommandLineRunner#run()方法的参数是启动SpringBoot应用程序main方法的参数列表，而ApplicationRunner#run()方法的参数则是ApplicationArguments对象。

在之前的文章中也提到过ApplicatgionArguments对象，并使用它获取外部的配置参数，查看：应用程序在启动时访问启动项参数。

建议：如果你在项目启动时需要获取类似 "--xxx" 的启动参数值建议使用ApplicationRunner

什么时候会被调用？

我们已经了解CommandLineRunner与ApplicationRunner两个接口的使用以及区别，是不是很想知道SpringBoot在启动时在什么时候调用它们的呢？

我们大家都知道SpringBoot应用程序的启动主要归功于SpringApplication这个类，我们在创建项目时在启动类内会调用SpringApplication#run()方法，如下所示：

public static void main(String[] args) {
  SpringApplication.run(LoggingServiceApplication.class, args);
}

那我们来查看下SpringApplication类#run()方法的源码，根据查看方法之间的相互调用，最终我们会定位到org.springframework.boot.SpringApplication#run(java.lang.String...)这个方法，阅读该方法时发现有关调用Runner的定义，如下所示：

// 省略部分源码
listeners.started(context);
callRunners(context, applicationArguments);
// 省略部分源码

#callRunnners()方法的调用确实是在应用程序启动完成后，而且把ApplicationContext与ApplicationArguments对象都作为参数进行了传递，那么我们来看看这个方法究竟干了些什么事情？

SpringApplication#callRunners：

private void callRunners(ApplicationContext context, ApplicationArguments args) {
  List