Spring Boot核心原理实现及核心注解类

简介: Spring Boot核心原理实现及核心注解类

Spring Boot最核心的功能就是“自动配置”,这一切都基于“约定优于配置”的原则。那么Spring Boot是如何约定,又是如何实现自动配置功能的呢?下面带大家来通过源码学习Spring Boot的核心运作原理以及最核心的注解@EnableAutoConfiguration来进行讲解。



1.1核心运行原理

使用Spring Boot时我们只需引入对应的Starters,Spring Boot启动时便自会动加载相关依赖,配置相应的初始化参数,以最快捷、简单的形式对第三方软件进行集成,这便是Spring Boot的自动配置功能。先从整体上看一下Spring Boot实现该运作机制涉及到的核心部分,如图2-1。image.png图中描述了Spring Boot自动配置运作过程中涉及的几个核心功能及其相互之间的关系。

它们包括:@EnableAutoConfiguration、spring.factories、各组件对应的AutoConfiguration类、@Conditional注解以及各种Starters。

如果用一句话来描述整个过程就是:Spring Boot通过@EnableAutoConfiguration注解开启自动配置,加载spring.factories中注册的各种AutoConfiguration类,当某个AutoConfiguration类满足其注解@Conditional指定的生效条件(Starters提供的依赖、配置或Spring容器中是否存在某个Bean等)时,那么实例化该AutoConfiguration类中定义的Bean(组件等),并注入Spring容器,至此就完成了依赖框架的自动配置。

先从概念及功能上了解一下上图所属部分的作用及相互关系,后面章节会针对每个功能及组件进行源代码级别的讲解。@EnableAutoConfiguration:该注解由组合注解@SpringBootApplication引入,完成自动配置开启,扫描各个jar包下的spring.factories文件,并加载其中注册的AutoConfiguration类等。

spring.factories:配置文件,位于jar包的META-INF目录下,按照指定格式注册了自动配置的AutoConfiguration类,也可以包含其他类型待注册的类。该配置文件不仅存在于Spring Boot项目中,也可以存在于自定义的自动配置(或Starter)项目中。

AutoConfiguration类:自动配置类,代表了Spring Boot中一类以XXAutoConfiguration命名的自动配置类。其中定义了三方组件集成Spring所需初始化的Bean和条件。

@Conditional:条件注解及其衍生注解,使用在AutoConfiguration类上,当满足该条件注解时才会实例化AutoConfiguration类。

Starters:三方组件的依赖及配置,Spring Boot已经预置的组件。Spring Boot默认的Starters项目往往是只包含了一个pom依赖的项目。如果自定义的starter,该项目还需包含spring.factories文件、AutoConfiguration类和其他配置类。

以上在概念层面了解了Spring Boot自动配置的整体流程和基本运作原理,下面重点看一下@EnableAutoConfiguration注解的功能。



1.2运作原理源码解析之

@EnableAutoConfiguration

@EnableAutoConfiguration是开启自动配置的注解,在创建的Spring Boot项目中并不能直接看到此注解,它是由组合注解@SpringBootApplication引入。下面,我们首先了解一下入口类和@SpringBootApplication注解,然后再深入了解@EnableAutoConfiguration注解的构成与作用。



1.2.1入口类和

@SpringBootApplication注解

Spring Boot项目创建完成会默认生成一个*Application的入口类。默认情况下,无论通过IDEA或通过官网创建基于Maven的Spring Boot项目,入口类的命名规则为:artifactId+Application。通过该类的main方法即可启动Spring Boot项目。


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


关于main方法并无特别之处,就是一个标准的Java应用的main方法,这里是启动Spring Boot项目的入口。默认情况下,按照上述命名规则并包含main方法的类,我们以下称作“入口类”。在入口类中,我们可以看到Spring Boot创建的代码中(除单元测试外)唯一的一个注解就是@SpringBootApplication。它是Spring Boot项目的核心注解,用于开启自动配置,准确说是该注解内组合的@EnableAutoConfiguration开启了自动配置。@SpringBootApplication部分源代码如下:


@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan(excludeFilters = {
      @Filter(type = FilterType.CUSTOM, classes = TypeExcludeFilter.class),
      @Filter(type = FilterType.CUSTOM,
            classes = AutoConfigurationExcludeFilter.class) })
public @interface SpringBootApplication {
   // 排除指定自动配置类
   @AliasFor(annotation = EnableAutoConfiguration.class)
   Class<?>[] exclude() default {};
// 排除指定自动配置类名
   @AliasFor(annotation = EnableAutoConfiguration.class)
   String[] excludeName() default {};
// 指定扫描的基础包,激活注解组件的初始化
   @AliasFor(annotation = ComponentScan.class, attribute = "basePackages")
   String[] scanBasePackages() default {};
// 指定扫描的类,用于初始化
   @AliasFor(annotation = ComponentScan.class, attribute = "basePackageClasses")
   Class<?>[] scanBasePackageClasses() default {};
// 指定是否代理@Bean方法以强制执行bean的声明周期行为。
@AliasFor(annotation = Configuration.class)
boolean proxyBeanMethods() default true;
}


通过源代码可以看出,该注解提供了以下成员属性(注解中的成员变量以方法的形式体现):exclude:根据类(Class)排除指定的自动配置,该成员属性覆盖了@SpringBootApplication 中组合的@EnableAutoConfiguration中定义的exclude成员属性。

excludeName:根据类名排除指定的自动配置,同样覆盖了@EnableAutoConfiguration中的excludeName的成员属性。

scanBasePackages:指定扫描的基础package,用于激活@Component等注解类的初始化。

scanBasePackageClasses:扫描指定的类,用于组件的初始化。

proxyBeanMethods:指定是否代理@Bean方法以强制执行bean的声明周期行为。此功能需要通过运行时生成CGLIB子类来实现方法拦截,该子类有一定的限制,比如配置类及其方法不允许声明为final等。默认值为true,允许配置类中进行“inter-bean references”(bean之间的引用)以及对该配置的@Bean方法的外部调用。如果@Bean方法都是自包含的,并且仅提供了容器使用的普通工程方法的功能,则可设置为false,避免处理CGLIB子类。Spring Boot 2.2新增该成员属性,后面章节涉及到的自动配置类中基本都会使用,一般情况下都配置为false。

以上源代码会发现,大量使用了@AliasFor注解,该注解用于桥接到其他注解,该注解的属性中指定了所桥接的注解类。如果点进去查看,会发现@SpringBootApplication定义的属性,在其他注解中已经定义过了。之所以使用@AliasFor注解并重新在@SpringBootApplication中定义,更多的意义是为了减少用户使用多注解带来的麻烦。@SpringBootApplication注解中组合了@SpringBootConfiguration、@EnableAutoConfiguration和@ComponentScan。因此,在实践过程中也可以使用这三个注解来替代@SpringBootApplication。在早期版本中并没有@SpringBootConfiguration注解,后新增了@SpringBootConfiguration并在其内组合了@Configuration。@EnableAutoConfiguration注解组合了@AutoConfigurationPackage。忽略掉一些基础注解和元注解,@SpringBootApplication注解的组合结构可以参考图2-2。


image.png


在上图中,@SpringBootApplication除了组合元注解之外,核心包括:用于激活Spring Boot自动配置的@EnableAutoConfiguration、用于激活@Component扫描的@ComponentScan、用于激活配置类的@Configuration。其@ComponentScan注解和@Configuration注解在Spring的日常使用中经常用到,不再赘述,而关于@EnableAutoConfiguration正是我们下面要详细介绍的。




1.2.2注解@EnableAutoConfiguration

功能解析

在未使用Spring Boot的情况下,Bean的生命周期由Spring来管理,然而Spring无法自动配置@Configuration注解的类。而Spring Boot所做的核心之一就是根据约定可以自动化的管理该注解标注的类。用来实现该功能的组件之一便是@EnableAutoConfiguration注解。

@EnableAutoConfiguration位于spring-boot-autoconfigure包内,当使用@SpringBootApplication注解时,该注解会自动生效。

@EnableAutoConfiguration的主要功能是启动Spring应用程序上下文时进行自动配置,它会尝试猜测并配置你可能需要的Bean。自动配置通常是基于项目classpath中引入的类和已定义的Bean来实现的。在此过程中,被自动配置的组件来自项目自身和项目依赖的jar包中。


举个例子:如果将tomcat-embedded.jar添加到classpath下,那么@EnableAutoConfiguration会认为你准备使用TomcatServletWebServerFactory类,并帮你初始化相关配置。与此同时如果自定义了基于ServletWebServerFactory的Bean,那么,它将不会进行TomcatServletWebServerFactory类的初始化。这一系列的操作判断,都由Spring Boot来完成。


下面我们来看一下@EnableAutoConfiguration注解的源代码:

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@AutoConfigurationPackage
@Import(AutoConfigurationImportSelector.class)
public @interface EnableAutoConfiguration {
// 用来覆盖配置来开启/关闭自动配置的功能
   String ENABLED_OVERRIDE_PROPERTY = "spring.boot.enableautoconfiguration";
// 根据类(Class)排除指定的自动配置
   Class<?>[] exclude() default {};
// 根据类名排除指定的自动配置
   String[] excludeName() default {};
}


该注解提供了一个常量和两个成员参数的定义:

ENABLED_OVERRIDE_PROPERTY:可以用来覆盖配置来开启/关闭自动配置的功能。


exclude:根据类(Class)排除指定的自动配置


excludeName:根据类名排除指定的自动配置。

正如上面所说,@EnableAutoConfiguration会猜测你所需要使用的Bean,但如果在实战中你并不需要它预置初始化的Bean,则可通过该注解的exclude或excludeName参数来进行有针对性的排除。

比如,当不需要数据库的自动配置时,可通过以下两种方式让其自动配置失效:

// 通过@SpringBootApplication排除DataSourceAutoConfiguration
@SpringBootApplication(exclude = DataSourceAutoConfiguration.class) 
public class SpringLearnApplication {
}

或:

// 通过@EnableAutoConfiguration排除DataSourceAutoConfiguration
@Configuration
@EnableAutoConfiguration(exclude = DataSourceAutoConfiguration.class)
public class DemoConfiguration {
}


需要注意的是,被@EnableAutoConfiguration注解的类所在package还具有特定的意义,通常会被作为扫描注解@Entity的根路径。这也是为什么在使用@SpringBootApplication注解时需要将被注解的类放在顶级package下的原因,如果放在较低层级,则它所在package的同级或上级中的类则无法被扫描到。

而对于入口类和其main方法来说,并不依赖@SpringBootApplication注解或@EnableAutoConfiguration,也就是说该注解可以使用在其他类上,而非入口类上,同样生效。



1.3 AutoConfigurationImportSelector源码解析

@EnableAutoConfiguration的关键功能是通过@Import注解导入的ImportSelector来完成的。从源码得知@Import(AutoConfigurationImportSelector.class)是@EnableAutoConfiguration注解的组成部分,也是自动配置功能的核心实现者。它又可以分为两部分:@Import和对应的ImportSelector。本节重点讲解@Import的基本使用和ImportSelector的实现类AutoConfigurationImportSelector。



1.3.3.AutoConfigurationImportSelector功能概述

下面,通过一张流程图来从整体上了解AutoConfigurationImportSelector功能及流程图。

图中省略了外部通过@Import注解调用该类的部分。image.png当AutoConfigurationImportSelector被@Import注解引入之后,它的selectImports方法会被调用并执行其实现的自动装配逻辑。读者朋友需注意的selectImports方法几乎涵盖了组件自动装配的所有处理逻辑。通过上图从整体上了解了AutoConfigurationImportSelector的概况及操作流程,关于AutoConfigurationImportSelector的详细实现可参考Spring Boot中的源码进行逐步分析,本篇文章就不再进行过多拓展。



1.4小结

本篇文章围绕Spring Boot的核心功能展开,带大家从总整体上了解Spring Boot自动配置的原理以及自动配置核心组件的运作过程。只有掌握了这些基础的组建及其功能,在后续集成其他三方类库的自动配置时才能够更加清晰的了解它们都运用了自动配置的哪些功能。

目录
相关文章
|
29天前
|
缓存 Java 开发者
【Spring】原理:Bean的作用域与生命周期
本文将围绕 Spring Bean 的作用域与生命周期展开深度剖析,系统梳理作用域的类型与应用场景、生命周期的关键阶段与扩展点,并结合实际案例揭示其底层实现原理,为开发者提供从理论到实践的完整指导。
|
13天前
|
缓存 监控 Java
SpringBoot @Scheduled 注解详解
使用`@Scheduled`注解实现方法周期性执行,支持固定间隔、延迟或Cron表达式触发,基于Spring Task,适用于日志清理、数据同步等定时任务场景。需启用`@EnableScheduling`,注意线程阻塞与分布式重复问题,推荐结合`@Async`异步处理,提升任务调度效率。
285 127
|
28天前
|
人工智能 Java 开发者
【Spring】原理解析:Spring Boot 自动配置
Spring Boot通过“约定优于配置”的设计理念,自动检测项目依赖并根据这些依赖自动装配相应的Bean,从而解放开发者从繁琐的配置工作中解脱出来,专注于业务逻辑实现。
|
3月前
|
Java Spring 容器
SpringBoot自动配置的原理是什么?
Spring Boot自动配置核心在于@EnableAutoConfiguration注解,它通过@Import导入配置选择器,加载META-INF/spring.factories中定义的自动配置类。这些类根据@Conditional系列注解判断是否生效。但Spring Boot 3.0后已弃用spring.factories,改用新格式的.imports文件进行配置。
755 0
|
15天前
|
XML Java 数据格式
常用SpringBoot注解汇总与用法说明
这些注解的使用和组合是Spring Boot快速开发和微服务实现的基础,通过它们,可以有效地指导Spring容器进行类发现、自动装配、配置、代理和管理等核心功能。开发者应当根据项目实际需求,运用这些注解来优化代码结构和服务逻辑。
118 12
|
28天前
|
传感器 Java 数据库
探索Spring Boot的@Conditional注解的上下文配置
Spring Boot 的 `@Conditional` 注解可根据不同条件动态控制 Bean 的加载,提升应用的灵活性与可配置性。本文深入解析其用法与优势,并结合实例展示如何通过自定义条件类实现环境适配的智能配置。
探索Spring Boot的@Conditional注解的上下文配置
|
2月前
|
Java 关系型数据库 数据库
深度剖析【Spring】事务:万字详解,彻底掌握传播机制与事务原理
在Java开发中,Spring框架通过事务管理机制,帮我们轻松实现了这种“承诺”。它不仅封装了底层复杂的事务控制逻辑(比如手动开启、提交、回滚事务),还提供了灵活的配置方式,让开发者能专注于业务逻辑,而不用纠结于事务细节。
|
29天前
|
Java 测试技术 编译器
@GrpcService使用注解在 Spring Boot 中开始使用 gRPC
本文介绍了如何在Spring Boot应用中集成gRPC框架,使用`@GrpcService`注解实现高效、可扩展的服务间通信。内容涵盖gRPC与Protocol Buffers的原理、环境配置、服务定义与实现、测试方法等,帮助开发者快速构建高性能的微服务系统。
144 0
|
3月前
|
前端开发 Java 数据库连接
SpringBoot参数校验底层原理和实操。深度历险、深度解析(图解+秒懂+史上最全)
SpringBoot参数校验底层原理和实操。深度历险、深度解析(图解+秒懂+史上最全)
SpringBoot参数校验底层原理和实操。深度历险、深度解析(图解+秒懂+史上最全)
|
3月前
|
缓存 安全 Java
Spring 框架核心原理与实践解析
本文详解 Spring 框架核心知识,包括 IOC(容器管理对象)与 DI(容器注入依赖),以及通过注解(如 @Service、@Autowired)声明 Bean 和注入依赖的方式。阐述了 Bean 的线程安全(默认单例可能有安全问题,需业务避免共享状态或设为 prototype)、作用域(@Scope 注解,常用 singleton、prototype 等)及完整生命周期(实例化、依赖注入、初始化、销毁等步骤)。 解析了循环依赖的解决机制(三级缓存)、AOP 的概念(公共逻辑抽为切面)、底层动态代理(JDK 与 Cglib 的区别)及项目应用(如日志记录)。介绍了事务的实现(基于 AOP
123 0