本文分享自微信公众号 - 猿天地（cxytiandi）。
如有侵权，请联系 support@oschina.cn 删除。
本文参与 “OSC 源创计划”，欢迎正在阅读的你也加入，一起分享。

CommandLineRunner与ApplicationRunner的介绍

本篇文章给大家带来的内容是关于commandlinerunner与applicationrunner的介绍，有一定的参考价值，有需要的朋友可以参考一下，希望对你有所帮助。

CommandLineRunner和ApplicationRunner是Spring Boot所提供的接口，他们都有一个run()方法。所有实现他们的Bean都会在Spring Boot服务启动之后自动地被调用。

由于这个特性，它们是一个理想地方去做一些初始化的工作，或者写一些测试代码。

CommandLineRunner

使用Application实现

在我们新建好工程后，为了简单我们直接使用Application类实现CommandLineRunner接口，这个类的注解@SpringBootApplication会为我们自动配置。

package cn.examplecode.sb2runner;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class Sb2runnerApplication implements CommandLineRunner {

    private static Logger logger = LoggerFactory.getLogger(Sb2runnerApplication.class);

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

    @Override
    public void run(String... args) throws Exception {
        logger.info("服务已启动，执行command line runner。");

        for (int i = 0; i <p>接下来我们直接启动服务，查看日志如下，发现run()方法被正常地执行了：</p><pre>Tomcat started on port(s): 8080 (http) with context path ''''
Started Sb2runnerApplication in 2.204 seconds (JVM running for 3.161)
服务已启动，执行command line runner。

参数传递

run()方法有个可变参数args，这个参数是用来接收命令行参数的，我们下面来加入参数来测试一下：

然后重启服务，观察日志，可以看到参数被正常地接收到了：

Tomcat started on port(s): 8080 (http) with context path ''''
Started Sb2runnerApplication in 1.888 seconds (JVM running for 2.41)
服务已启动，执行command line runner。
args[0]: --param=sth

命令行参数传递

之前我们说过使用Spring Boot的一大优势就是可以将工程直接打包成一个jar包而不需要单独部署。打包成jar包后可以直接执行该jar包进行服务的启动，这样在执行jar包时我们就可以传入命令行参数，让CommandLineRunner接收参数。

这种场景在服务器上特别常用。比如我们想执行某个操作，又不想对外部暴露，此时可以使用CommandLineRunner作为该操作的入口。

下面我们就打成jar包来演示一下。

1. 进入终端界面，开始打包

1. 打包完成后，执行该jar包，记得先把IDE的服务停掉。

可以从日志中看到我们也正常地获取到了参数。通过传递参数，在业务逻辑上我们可以根据不同的参数而执行不同的操作。

上面我们提到的只是一个CommandLineRunner，如果我们有多个CommandLineRunner怎么办呢？怎么控制它们执行的顺序呢？

下面我们就来介绍如何指定执行的顺序。

指定执行顺序

Spring Boot为我们提供了一个注解"@Order"，可以用来指定执行的顺序，比如我们工程里面有三个CommandLineRunner:

@Component
@Order(1)
public class CommandRunner1 implements CommandLineRunner {

    private static Logger logger = LoggerFactory.getLogger(CommandRunner1.class);

    @Override
    public void run(String... args) throws Exception {
        logger.info("执行第一个command line runner...");
    }

}


@Component
@Order(2)
public class CommandRunner2 implements CommandLineRunner {

    private static Logger logger = LoggerFactory.getLogger(CommandRunner2.class);

    @Override
    public void run(String... args) throws Exception {
        logger.info("执行第二个command line runner...");
    }
    
}

@Component
@Order(3)
public class CommandRunner3 implements CommandLineRunner {

    private static Logger logger = LoggerFactory.getLogger(CommandRunner3.class);

    @Override
    public void run(String... args) throws Exception {
        logger.info("执行第三个command line runner...");
    }
    
}

我们可以在该类的上面直接加入@Order注解，然后Spring Boot就会按照我们注解指定的顺序从小到大的执行了。很简单，是不是？

Tomcat started on port(s): 8080 (http) with context path ''''
Started Sb2runnerApplication in 1.764 seconds (JVM running for 2.292)
执行第一个command line runner...
执行第二个command line runner...
执行第三个command line runner...

ApplicationRunner

ApplicationRunner与CommandLineRunner做的事情是一样的，也是在服务启动之后其run()方法会被自动地调用，唯一不同的是ApplicationRunner会封装命令行参数，可以很方便地获取到命令行参数和参数值。

@Component
public class ApplicationRunner1 implements ApplicationRunner {

    private static Logger logger = LoggerFactory.getLogger(ApplicationRunner1.class);

    @Override
    public void run(ApplicationArguments args) throws Exception {
        logger.info("执行application runner...");
        logger.info("获取到参数: " + args.getOptionValues("param"));
    }
}

执行结果：

我们可以发现，通过run()方法的参数ApplicationArguments可以很方便地获取到命令行参数的值。

所以如果你的工程需要获取命令行参数的话，建议你使用ApplicationRunner。

总结

无论是CommandLineRunner还是ApplicationRunner，它们的目的都是在服务启动之后执行一些操作。如果需要获取命令行参数时则建议使用ApplicationRunner。

另一种场景是我们在服务器上需要执行某个操作，比如修正数据库用户的数据，而又找不到合适的执行入口，那么这就是它们理想的使用场景了。

以上就是CommandLineRunner与ApplicationRunner的介绍的详细内容，更多请关注php中文网其它相关文章！

CommandLineRunner与ApplicationRunner的介绍ApplicationRunner

CommandLineRunner和ApplicationRunner是Spring Boot所提供的接口，他们都有一个run()方法。所有实现他们的Bean都会在Spring Boot服务启动之后自动地被调用。

由于这个特性，它们是一个理想地方去做一些初始化的工作，或者写一些测试代码。

CommandLineRunner

使用Application实现

在我们新建好工程后，为了简单我们直接使用Application类实现CommandLineRunner接口，这个类的注解@SpringBootApplication会为我们自动配置。

package cn.examplecode.sb2runner;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class Sb2runnerApplication implements CommandLineRunner {

    private static Logger logger = LoggerFactory.getLogger(Sb2runnerApplication.class);

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

    @Override
    public void run(String... args) throws Exception {
        logger.info(服务已启动，执行command line runner。);

        for (int i = 0; i < args.length; ++i) {
            logger.info(args[{}]: {}, i, args[i]);
        }
    }
}

接下来我们直接启动服务，查看日志如下，发现run()方法被正常地执行了：

Tomcat started on port(s): 8080 (http) with context path ''
Started Sb2runnerApplication in 2.204 seconds (JVM running for 3.161)
服务已启动，执行command line runner。

参数传递

run()方法有个可变参数args，这个参数是用来接收命令行参数的，我们下面来加入参数来测试一下：

然后重启服务，观察日志，可以看到参数被正常地接收到了：

Tomcat started on port(s): 8080 (http) with context path ''
Started Sb2runnerApplication in 1.888 seconds (JVM running for 2.41)
服务已启动，执行command line runner。
args[0]: --param=sth

命令行参数传递

之前我们说过使用Spring Boot的一大优势就是可以将工程直接打包成一个jar包而不需要单独部署。打包成jar包后可以直接执行该jar包进行服务的启动，这样在执行jar包时我们就可以传入命令行参数，让CommandLineRunner接收参数。

这种场景在服务器上特别常用。比如我们想执行某个操作，又不想对外部暴露，此时可以使用CommandLineRunner作为该操作的入口。

下面我们就打成jar包来演示一下。

1. 进入终端界面，开始打包

1. 打包完成后，执行该jar包，记得先把IDE的服务停掉。

可以从日志中看到我们也正常地获取到了参数。通过传递参数，在业务逻辑上我们可以根据不同的参数而执行不同的操作。

上面我们提到的只是一个CommandLineRunner，如果我们有多个CommandLineRunner怎么办呢？怎么控制它们执行的顺序呢？

下面我们就来介绍如何指定执行的顺序。

指定执行顺序

Spring Boot为我们提供了一个注解@Order，可以用来指定执行的顺序，比如我们工程里面有三个CommandLineRunner:

@Component
@Order(1)
public class CommandRunner1 implements CommandLineRunner {

    private static Logger logger = LoggerFactory.getLogger(CommandRunner1.class);

    @Override
    public void run(String... args) throws Exception {
        logger.info(执行第一个command line runner...);
    }

}


@Component
@Order(2)
public class CommandRunner2 implements CommandLineRunner {

    private static Logger logger = LoggerFactory.getLogger(CommandRunner2.class);

    @Override
    public void run(String... args) throws Exception {
        logger.info(执行第二个command line runner...);
    }
    
}

@Component
@Order(3)
public class CommandRunner3 implements CommandLineRunner {

    private static Logger logger = LoggerFactory.getLogger(CommandRunner3.class);

    @Override
    public void run(String... args) throws Exception {
        logger.info(执行第三个command line runner...);
    }
    
}

我们可以在该类的上面直接加入@Order注解，然后Spring Boot就会按照我们注解指定的顺序从小到大的执行了。很简单，是不是？

Tomcat started on port(s): 8080 (http) with context path ''
Started Sb2runnerApplication in 1.764 seconds (JVM running for 2.292)
执行第一个command line runner...
执行第二个command line runner...
执行第三个command line runner...

ApplicationRunner

ApplicationRunner与CommandLineRunner做的事情是一样的，也是在服务启动之后其run()方法会被自动地调用，唯一不同的是ApplicationRunner会封装命令行参数，可以很方便地获取到命令行参数和参数值。

@Component
public class ApplicationRunner1 implements ApplicationRunner {

    private static Logger logger = LoggerFactory.getLogger(ApplicationRunner1.class);

    @Override
    public void run(ApplicationArguments args) throws Exception {
        logger.info(执行application runner...);
        logger.info(获取到参数:  + args.getoptionValues(param));
    }
}

执行结果：

我们可以发现，通过run()方法的参数ApplicationArguments可以很方便地获取到命令行参数的值。

所以如果你的工程需要获取命令行参数的话，建议你使用ApplicationRunner。

总结

无论是CommandLineRunner还是ApplicationRunner，它们的目的都是在服务启动之后执行一些操作。如果需要获取命令行参数时则建议使用ApplicationRunner。

另一种场景是我们在服务器上需要执行某个操作，比如修正数据库用户的数据，而又找不到合适的执行入口，那么这就是它们理想的使用场景了。

CommandLineRunner和ApplicationRunner

使用场景

我们在开发过程中会有这样的场景：需要在容器启动的时候执行一些内容，比如：读取配置文件信息，数据库连接，删除临时文件，清除缓存信息，在Spring框架下是通过ApplicationListener监听器来实现的。在Spring Boot中给我们提供了两个接口来帮助我们实现这样的需求。这两个接口就是我们今天要讲的CommandLineRunner和ApplicationRunner，他们的执行时机为容器启动完成的时候。

不同点

共同点：其一执行时机都是在容器启动完成的时候进行执行；其二这两个接口中都有一个run()方法；

不同点：ApplicationRunner中run方法的参数为ApplicationArguments，而CommandLineRunner接口中run方法的参数为String数组。

官方说明：

• Interface used to indicate that a bean should run when it is contained within   
• a SpringApplication. Multiple CommandLineRunner beans can be defined   
• within the same application context and can be ordered using the Ordered   
• interface or @Order annotation.   
• If you need access to ApplicationArguments instead of the raw String array consider using ApplicationRunner. 

使用Ordered接口或者Order注解修改执行顺序

问题提出: 如果有多个实现类，而我们需要按照一定的顺序执行的话，那么应该怎么办呢？

解决方案：其一可以在实现类上加上@Order注解指定执行的顺序；其二可以在实现类上实现Ordered接口来标识。

需要注意：数字越小，优先级越高，也就是@Order(1)注解的类会在@Order(2)注解的类之前执行。

今天的关于atom-grunt-runner 的配置和atom launcher的分享已经结束，谢谢您的关注，如果想了解更多关于CommandLineRunner 与 ApplicationRunner 接口的使用及源码解析、CommandLineRunner与ApplicationRunner的介绍、CommandLineRunner与ApplicationRunner的介绍ApplicationRunner、CommandLineRunner和ApplicationRunner的相关知识，请在本站进行查询。