SpringBoot文档之SpringApplication的阅读笔记

SpringBoot文档之SpringApplication的阅读笔记

  • Reference

  • Core Features

  • SpringApplication

    使用SpringBoot开发应用,最简单的启动类,代码内容如下:

    import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
    
    @SpringBootApplication
    public class MyApplication {
    
        public static void main(String[] args) {
            SpringApplication.run(MyApplication.class, args);
        }
    
    }
    

    当SpringBoot应用程序启动失败时,通过定制FailureAnalyzer可以获得详细的错误描述信息。
    SpringBoot允许应用开发者注册自定义的FailureAnalyzer的实现类,实现方法可参考文档

    SpringBoot提供延迟初始化特性,允许Bean在使用时才完成构建和初始化操作,无需在启动时即完成全部Bean的构建和初始化操作。
    使用延迟初始化特性的优点,可以加快应用程序启动,缩短启动时间。
    使用延迟初始化特性的缺点,应用启动时只有部分必要的Bean完成了初始化,在处理业务时才会完成Bean的构建和初始化,可能掩盖一些程序逻辑层面的问题。
    使用延迟初始化特性时,需要考虑为Java应用分配足够的资源,避免触发Bean的构建和初始化,由于资源不足而失败。

    在配置文件中增加如下配置,可以启用延迟初始化特性:

    spring:
        main:
            lazy-initialization: true
    

    对于关键的Bean,不期望使用延迟初始化特性,可以在类名上增加注解@Lazy(false),关闭延迟初始化特性。

    如下是SpringBoot应用程序启动时在控制台输出的Banner。

    .   ____          _            __ _ _
    /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
    ( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
    \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
    '  |____| .__|_| |_|_| |_\__, | / / / /
    =========|_|==============|___/=/_/_/_/
    
    :: Spring Boot ::                (v3.3.2)
    

    SpringBoot允许开发者定制Banner,操作方法如下:

    • 在类路径中增加文件banner.txt
    • 使用属性spring.banner.location指定banner.txt的位置。

    SpringBoot在读取banner.txt时,默认文件编码为UTF-8。通过修改属性spring.banner.charset,可以修改解析banner.txt时的编码格式。

    关闭Banner,样例代码,如下:

    import org.springframework.boot.Banner;
    import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
    
    @SpringBootApplication
    public class MyApplication {
    
        public static void main(String[] args) {
            SpringApplication application = new SpringApplication(MyApplication.class);
            application.setBannerMode(Banner.Mode.OFF);
            application.run(args);
        }
    }
    

    SpringBoot框架在应用启动过程中,按序触发如下事件:

    • ApplicationStartingEvent
    • ApplicationEnvironmentPreparedEvent
    • ApplicationContextInitializedEvent
    • ApplicationPreparedEvent
    • ApplicationStartedEvent
    • AvailabilityChangeEvent
    • ApplicationReadyEvent
    • AvailabilityChangeEvent
    • ApplicationFailedEvent

    对于实现接口ApplicationContextAware的Bean,SpringBoot应用初始化过程中会自动注入ApplicationContext对象的实例。

    对于一般的应用开发者而言,对上述事件仅做基本了解即可。

    通过定义Bean来接收ApplicationArguments,可以读取SpringBoot应用启动时的命令行参数。
    SpringApplication运行后,执行一些业务相关的代码,可以定义实现接口ApplicationRunner或者CommandLineRunner的Bean。
    SpringBoot允许开发者定义多个实现ApplicationRunner或者CommandLineRunner的Bean,这些Bean之间的执行顺序,可以通过实现接口org.springframework.core.Ordered或者使用注解org.springframework.core.annotation.Order来定制。

    SpringBoot允许开发者通过实现ExitCodeGenerator接口的Bean来定制程序退出时的错误码,借以满足特定运行环境、特定业务场景的诉求。

    修改SpringBoot应用的配置文件,增加配置项spring.application.admin.enabled并指定为true,可以开启管理特性。

    假如开发者使用Java 21来开发、运行SpringBoot应用程序,可以考虑增加如下配置项,并指定为true,从而启用Java 21的virtual threads特性。

    • spring.threads.virtual.enabled
    • spring.main.keep-alive