Spring Boot零配置启动原理

Hydra大约 7 分钟SpringBoot配置

在创建传统SpringMVC项目时,需要复杂的配置文件,例如:

  • web.xml,加载配置spring容器,配置拦截
  • application.xml,配置扫描包,扫描业务类
  • springmvc.xml,扫描controller,视图解析器等
  • ……

而Spring Boot为我们提供了一种极简的项目搭建方式,看一下Spring Boot项目的启动类:

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

简单的一行代码,即可启动一个Spring Boot程序,那么在实际运行中是如何做到零配置启动的呢?下面从源码角度进行分析。

@SpringBootApplication

首先看一下@SpringBootApplication这个组合注解,除去元注解外,它还引入了其他三个重要的注解:

@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan

@SpringBootConfiguration

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Configuration
public @interface SpringBootConfiguration {
}

从源码可以看到,其实@SpringBootConfiguration并没有额外功能,它只是Spring中@Configuration的派生注解,用于标注配置类,完成Bean的配置与管理。

@ComponentScan

Spring中的注解,用于包的扫描,并把声明了特定注解的类交给spring的ioc容器。

@EnableAutoConfiguration

Spring Boot有中一个非常重要的理念就是约定大于配置。而自动配置这一机制的核心实现就是靠@EnableAutoConfiguration注解完成的。

图片
图片

可以看出,在@EnableAutoConfiguration注解中,使用@Import导入了AutoConfigurationImportSelector这个类,实现了ImportSelector接口的selectImports()方法。spring中会把selectImports()方法返回的String数组中的类的全限定名实例化为bean,并交给spring容器管理。

图片
图片

查看其中的getAutoConfigurationEntry方法:

图片
图片

在执行完getCandidateConfigurations后,把众多类的全限定名存储到了一个List中。

图片
图片

SpringFactoriesLoader这个类非常重要,属于Spring框架的一种扩展方案,提供一种了配置查找的功能支持。其主要功能就是读取配置文件META-INF/spring.factories,决定要加载哪些类。

图片
图片

当然,并不是所有spring.factories中的类都会被加载到spring容器中,很多情况下需要按照需求所需的情况引入,依赖条件注解@Conditional进行判断。例如ServletWebServerFactoryAutoConfiguration

图片
图片

只有在classpath下存在ServletRequest这一类时,才将ServletWebServerFactoryAutoConfiguration作为配置类导入spring容器中。

SpringApplication

SpringApplication提供了一个简单的方式以启动Spring boot程序,查看SpringApplication.run方法调用。在此创建了一个SpringApplication的实例,并调用了它的run方法:

图片
图片

看一下创建实例的过程源码:

图片
图片

主要完成了这几件事情:

  • 设置资源加载器,用于将资源加载到加载器中
  • 判断当前项目类型是什么? 提供了NONESERVLETREACTIVE 三种类型备选
  • 使用SpringFactoriesLoader查找并加载所有可用的ApplicationContextInitializer
  • 使用SpringFactoriesLoader查找并加载所有可用的监听器ApplicationListener
  • 推断并设置main方法的定义

SpringApplication完成初始化后,调用run方法,下面对run方法中核心代码进行分析:

图片
图片

按照图中标注序号进行分析:

1、spring监听器的使用,要获取这些监听器的对象,就要知道其全路径。通过SpringFactoriesLoader查找spring.factories获得,之后再调用它们的started()方法

2、 创建并配置当前Spring Boot应用将要使用的Environment,根据监听器和默认应用参数来准备所需要的环境

3、打印Banner

4、创建spring应用上下文。根据之前推断的项目类型,决定该为当前SpringBoot应用创建什么类型的ApplicationContext并创建完成

5、准备应用上下文,首先将之前准备好的Environment设置给创建好的ApplicationContext使用。然后遍历调用所有ApplicationContextInitializerinitialize方法来对已经创建好的ApplicationContext进行进一步的处理。最后,遍历调用所有SpringApplicationRunListenercontextPrepared()方法

6、这里最终调用了Spring中AbstractApplicationContextrefresh方法,可以说这个refresh方法是Spring中最重要的方法之一,完成了Bean工厂创建,后置管理器注册,Bean实例化等最重要的工作。这一步工作完成后,spring的ioc容器就完成了

7、如果有Bean实现了CommandLineRunner接口并重写了run方法,则遍历执行CommandLineRunner中的方法

手写 Starter

Starter是Spring boot的核心思想之一,在使用spring boot来搭建项目时,往往只需要引入官方提供的starter,就可以直接使用,而不用再进行复杂的配置工作。

一方面,是前面说过的通过动态spi扩展可以直接从starter的META-INF/spring.factories中决定什么类将被实例化为bean交给spring容器管理。另一方面,starter的父pom中往往已经包含了需要导入的依赖,以mybatis-spring-boot-starter这一starter为例,点开后可以看见它已经将依赖的坐标全部为我们导入了。

图片
图片

总的来说,使用starter可以完成以下功能:

  • 启用功能,注意不是实现功能
  • 依赖管理,starter帮我们引入需要的所有依赖

讲完了关于starter的原理,下面讲讲如何构造一个自己的starter。官方为我们提供了一个命名规范,建议第三方starter命名应当遵循thirdpart-spring-boot-starter这一格式,那我们就来手写一个my-spring-boot-starter,通过这个过程来学习如何完成属性的配置。

1、创建一个maven的普通project,在pom中添加parent节点

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.2.6.RELEASE</version>
    <relativePath/>
</parent>

2、引入自动装配的依赖

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-autoconfigure</artifactId>
    </dependency>
</dependencies>

3、实现自己的功能需求

public class SayhiImpl implements ISayhi {
    @Autowired
    MyProperties properties;
    @Override
    public void welcome() {
        String name=properties.getName();
        System.out.println(name+" hello spring boot");
    }
}

如果希望能够在其他项目中使用的时候,通过yml或property文件对这个属性进行赋值,就要写一个对属性进行赋值操作的类,并使用@ConfigurationProperties注解

@ConfigurationProperties("spring.sayhi")
public class MyProperties {
    private String name="";
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
}

4、如果希望上面开发的功能在springboot启动的时候就加入项目进行管理,就需要有一个代表当前starer自动装配的类

@Configuration
@ConditionalOnClass
//使配置文件生效
@EnableConfigurationProperties(MyProperties.class)
public class MyAutoConfiguration {
    @Bean
    //条件注解,仅当ioc容器中不存在指定类型的bean时,才会创建bean
    @ConditionalOnMissingBean
    public ISayhi sayhi(){
        return new SayhiImpl();
    }
}

5、在resources创建META-INF,创建spring.factories文件,在里面写入:

org.springframework.boot.autoconfigure.EnableAutoConfiguration=com.test.MyAutoConfiguration

6、使用maven打包

mvn clean install

测试工程

1、新建一个测试工程,在pom文件中引入上面打包的坐标

<dependency>
    <groupId>com.test</groupId>
    <artifactId>my-spring-boot-starter</artifactId>
    <version>1.0-SNAPSHOT</version>
</dependency>

2、使用yml进行属性的配置

spring:
  sayhi:
    name: hydra

3、运行测试

@SpringBootApplication
public class TestApplication implements CommandLineRunner {
    @Autowired
    private ISayhi sayhi;
    public static void main(String[] args) {
        SpringApplication application=new SpringApplication(TestApplication.class);
        application.run(args);
    }
    @Override
    public void run(String... args) throws Exception {
        sayhi.welcome();
    }
}

结果:

hydra hello spring boot

如果在之前为name设置了默认值,那么在不在yml中对name进行配置的话就会打印默认值。这也就是为什么springboot在启动tomcat时会自动为我们设置为8080端口的原因,从这再一次体现了“约定大于配置”这一理念。