跳至主要內容

5. 特性-Spring Application

安图新大约 8 分钟

5. 特性-Spring Application

SpringApplication类是 Spring Boot 应用程序启动的核心,它提供了一种便捷的方式( SpringApplication.run())从 main方法启动整个 Spring 应用程序。默认情况下,SpringApplication 将执行以下步骤引导应用程序:

1、 创建一个ApplicationContext实例;
2、 注册一个CommandLinePropertySource以将命令行参数作为 Spring 属性;
3、 刷新应用程序上下文,加载所有单例 bean;
4、 触发CommandLineRunnerbeans;

1.SpringApplication 使用

@SpringBootApplication
public class SpringapplicationDetailApplication {



    public static void main(String[] args) {


        SpringApplication.run(SpringapplicationDetailApplication.class, args);
    }

}

启动程序看到以下的内容输出.

 .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _ | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::             (v3.0.0-M2)

2022-04-11 00:37:50.001  INFO 74256 --- [           main] m.r.s.SpringapplicationDetailApplication : Starting SpringapplicationDetailApplication using Java 17.0.2 with PID 74256
2022-04-11 00:37:50.003  INFO 74256 --- [           main] m.r.s.SpringapplicationDetailApplication : No active profile set, falling back to 1 default profile: "default"
2022-04-11 00:37:50.539  INFO 74256 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat initialized with port(s): 8080 (http)
2022-04-11 00:37:50.546  INFO 74256 --- [           main] o.apache.catalina.core.StandardService   : Starting service [Tomcat]
2022-04-11 00:37:50.546  INFO 74256 --- [           main] org.apache.catalina.core.StandardEngine  : Starting Servlet engine: [Apache Tomcat/10.0.18]
2022-04-11 00:37:50.604  INFO 74256 --- [           main] o.a.c.c.C.[Tomcat].[localhost].[/]       : Initializing Spring embedded WebApplicationContext
2022-04-11 00:37:50.606  INFO 74256 --- [           main] w.s.c.ServletWebServerApplicationContext : Root WebApplicationContext: initialization completed in 567 ms
2022-04-11 00:37:50.831  INFO 74256 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 8080 (http) with context path ''
2022-04-11 00:37:50.838  INFO 74256 --- [           main] m.r.s.SpringapplicationDetailApplication : Started SpringapplicationDetailApplication in 1.058 seconds (JVM running for 1.43)

默认情况下,会显示INFO日志消息,包括一些相关的启动细节,比如启动应用程序的用户。如果你需要设置除INFO之外的日志级别,请参见日志级别进行设置。应用程序版本是使用来自主应用程序类包的实现版本来确定的。可以通过将spring.main.log-startup-info设置为false来关闭启动信息日志记录。这也将关闭应用程序的 active profiles 的日志记录。

要在启动时添加额外的日志记录,你可以在SpringApplication的子类中重写logStartupInfo(boolean),

2.应用启动失败

如果应用程序启动失败,注册的failureanalyzer将有机会提供专用的错误消息和具体的操作来提示修复问题。例如,如果您在端口 8080 上启动一个 web 应用程序,并且该端口已经被使用,应该会看到类似如下的消息:

Identify and stop the process that is listening on port 8080 or configure this application to listen on another port.

Spring Boot 提供了大量的FailureAnalyzer实现,也可以自定义 自定义 FailureAnalyzeropen in new window
如果没有故障分析器能够处理异常,可以显示打印堆栈信息,方便知道具体发生了什么错误。只需要把org.springframework.boot.autoconfigure.logging.ConditionEvaluationReportLoggingListener类启用 debug 属性或启用 debug 日志,如果用 jar 启动可以使用如下方式:$ java -jar myproject-0.0.1-SNAPSHOT.jar --debug

3.懒加载

SpringApplication允许延迟初始化应用程序。当启用了延迟初始化时,bean 将在需要时创建,而不是在应用程序启动时创建。因此,启用延迟初始化可以减少应用程序启动所需的时间。在 web 应用程序中,启用延迟初始化会导致许多 web 相关的 bean 直到收到 HTTP 请求才被初始化。

延迟初始化的一个缺点是,它会延迟发现应用程序的错误问题。如果配置错误的 bean 是延迟初始化的,那么在启动期间将不再发生错误,问题只会在 bean 初始化时才会变得明显。还必须注意确保 JVM 有足够的内存来容纳应用程序的所有 bean,而不仅仅是那些在启动期间被初始化的 bean。由于这些原因默认情况下不启用延迟初始化

使用延迟初始化三种方式:

  //延迟加载bean方法1
        SpringApplicationBuilder lazyInitialization = new SpringApplicationBuilder(SpringapplicationDetailApplication.class);
        lazyInitialization.lazyInitialization(true).run(args);
 //延迟加载bean方法2
        SpringApplication application = new SpringApplication(SpringapplicationDetailApplication.class);
        application.setLazyInitialization(true);
        application.run(args);

//延迟加载bean方法3 application.properties
spring.main.lazy-initialization=true

如果希望针对某一个 bean 配置延迟加载,可以使用注解@Lazy(),参数默认 true。

    @Bean
    //应用启动时bean不初始化,使用时菜初始化
    @Lazy()
    public CustomerBean customerBean() {


        return new CustomerBean();
    }

4.自定义启动 Banner

Spring Boot 应用程序在启动时,日志会显示如下内容:

 .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _ | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::             (v3.0.0-M2)

这个 banner 内容是可以自定义。在项目resource目录中添加一个banner.txt文件,文件中添加需要启动时展示的内容。如果为了美观可以从https://www.bootschool.net/asciiopen in new window输入自己想要生存的内容,然后复制到 banner.txt 即可。例如复制以下内容到resource/banner.txt:

.-. .-..---..-.   .-.   .----. .---..---..---. .-..-..-..---. .--..----..----..---. .---.
| |=| || |- | |__ | |__ | || |  \ \ | |-'| |-`< | || . || |'_ |-`< | || || || || |'   -||
-' -'---'----'----'----' ---'-'  -'-'-'-'-'-'-/ --'----'----' -'  ---'

${spring-boot.version}

启动应用程序看到如下结果 :
 
在 banner.txt 文件中可以使用以下变量,获取对应系统属性值。

变量描述
${application.version}应用版本号: 1.0.0
${application.formatted-version}应用格式化版本号:v1.0.0
${spring-boot.version}spring boot 版本号3.0.0-M2
${spring-boot.formatted-version}spring boot 格式化版本号v3.0.0-M2.
${Ansi.NAME} (or ${AnsiColor.NAME}, ${AnsiBackground.NAME}, ${AnsiStyle.NAME})NAME是ANSI转义代码的名称。具体详情参考AnsiPropertySource。
${application.title}应用程序的标题,定义在MANIFEST

除了使用文件的形式设置启动的 banner 内容,还可以使用代码的方式实现:

 SpringApplication application = new SpringApplication(SpringapplicationDetailApplication.class);
        application.setBanner(new Banner() {


            @Override
            public void printBanner(Environment environment, Class<?> sourceClass, PrintStream out) {


                out.println("我是用代码设置的banner");
            }
        });
        application.run(args);

spring.main.banner-mode属性可以控制 banner 输出,它有三个方式console输出到控制台(默认值),log输出到日志,off直接关闭不输出。

5.定制 SpringApplication

如果 SpringApplication 的默认值不符合你的需求,你可以创建一个本地实例并对其进行定制。例如,要关闭 banner,你可以这样写:

@SpringBootApplication
public class MyApplication {


    public static void main(String[] args) {


        SpringApplication application = new SpringApplication(MyApplication.class);
        application.setBannerMode(Banner.Mode.OFF);
        application.run(args);
    }

}

传递给SpringApplication的构造函数参数是 Spring
bean 的配置源。在大多数情况下,这些是对@Configuration类的引用,但它们也可以是对@Component类的直接引用。

也可以使用 application.properties 来配置SpringApplication,详细配置见外部配置

6.流畅的构建器 API

如果你需要构建一个ApplicationContext层次结构(具有父/子关系的多个上下文),或者你更喜欢使用一个流畅的构建器 API,你可以使用SpringApplicationBuilder

new SpringApplicationBuilder()
        .sources(Parent.class)
        .child(Application.class)
        .bannerMode(Banner.Mode.OFF)
        .run(args);

在创建 ApplicationContext 层次结构时存在一些限制。例如,Web 组件必须包含在子上下文中,父上下文中和子上下文中都使用相同的 Environment。非必要情况下使用SpringApplication静态方法更方便。

7.Web 环境

SpringApplication 总会创建正确的 ApplicationContext。用来确定WebApplicationType的算法如下:

  • 如果存在 Spring MVC,那么使用 AnnotationConfigServletWebServerApplicationContext
  • 如果不存在 Spring MVC,但是存在 Spring WebFlux,那么使用 AnnotationConfigReactiveWebServerApplicationContext
  • 其它的使用 AnnotationConfigApplicationContext

如果在同一个应用程序中使用Spring MVCSpring WebFlux中的WebClient,那么默认情况下会使用Spring MVC。可以通过调用setWebApplicationType(WebApplicationType)轻松覆盖它。也可以通过调用setApplicationContextClass(…)来完全控制ApplicationContext类型。

8.访问程序参数

如果需要访问传递给SpringApplication.run()的应用程序参数,你可以注入org.springframework.boot.ApplicationArguments bean。ApplicationArguments接口提供了对原始String[]参数以及解析过的选项和非选项参数的访问,如下例所示

@Component
public class MyBean {



    public MyBean(ApplicationArguments args) {


        boolean debug = args.containsOption("debug");
        List<String> files = args.getNonOptionArgs();
        if (debug) {


            System.out.println(files);
        }
        // if run with "--debug logfile.txt" prints ["logfile.txt"]
    }

}

Spring Boot 启动时向 Spring Environment 注册一个CommandLinePropertySource。你也可以通过使用@Value注释注入单个应用程序参数。

9.ApplicationRunner & CommandLineRunner

如果需要在SpringApplication启动后运行一些特定的代码,可以实现ApplicationRunnerCommandLineRunner接口。这两个接口以相同的方式工作,并提供一个run方法,该方法在SpringApplication.run()完成之前被调用。
这个约定非常适合于那些在应用程序启动后但在它开始接受流量之前运行的任务。

CommandLineRunner接口以字符串数组的形式提供对应用程序参数的访问,而ApplicationRunner使用前面讨论过的ApplicationArguments接口。

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


    @Override
    public void run(String... args) throws Exception {


        System.out.println("MyCommandLineRunner...." + args);
    }
}

@Component
@Order(2)
public class MyApplicationRunner implements ApplicationRunner {


    @Override
    public void run(ApplicationArguments args) throws Exception {


        System.out.printf("MyApplicationRunner..");
    }
}

如果定义了几个CommandLineRunnerApplicationRunner bean,它们必须以特定的顺序调用,你可以另外实现org.springframework.core.Ordered接口或使用org.springframework.core.annotation.Order注解。

10.应用程序退出

每个SpringApplication都向 JVM 注册一个关闭钩子,以确保ApplicationContext在退出时优雅地关闭。所有标准的Spring生命周期回调(比如DisposableBean接口或@PreDestroy注释)都可以被使用。此外,如果bean希望在调用SpringApplication.exit()时返回特定的退出代码,则可以实现org.springframework.boot.ExitCodeGenerator接口。然后,可以将这个退出代码传递给System.exit()以将其作为状态代码返回,如下面的示例所示

@SpringBootApplication
public class MyApplication {



    @Bean
    public ExitCodeGenerator exitCodeGenerator() {


        return () -> 42;
    }

    public static void main(String[] args) {


        System.exit(SpringApplication.exit(SpringApplication.run(MyApplication.class, args)));
         //Process finished with exit code 42
    }

}

此外,ExitCodeGenerator接口也可以通过异常实现。当遇到这样的异常时,Spring Boot返回由实现的getExitCode()方法提供的退出代码。

   @Bean
    public ExitCodeExceptionMapper exitCodeExceptionMapper(){


        return exception -> {


            if(exception instanceof NullPointerException){


                return -1;
            }
            return 0;
        };
    }

上次编辑于:
贡献者: Andy