玩转 Spring Boot 原理篇(核心注解知多少)

本文解析了SpringBoot中@SpringBootApplication注解的内部组成及其功能,包括@SpringBootConfiguration、@EnableAutoConfiguration和@ComponentScan等关键注解,阐述了它们如何简化配置并支持组件扫描和自动配置。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

0. 

25006cff43a3dae3af4afa649a3f701f.png

0.0. 历史文章整理

玩转 Spring Boot 入门篇

玩转 Spring Boot 集成篇(MySQL、Druid、HikariCP)

玩转 Spring Boot 集成篇(MyBatis、JPA、事务支持)

玩转 Spring Boot 集成篇(Redis)

玩转 Spring Boot 集成篇(Actuator、Spring Boot Admin)

玩转 Spring Boot 集成篇(RabbitMQ)

玩转 Spring Boot 集成篇(@Scheduled、静态、动态定时任务)

玩转 Spring Boot 集成篇(任务动态管理代码篇)

玩转 Spring Boot 集成篇(定时任务框架Quartz)

玩转 Spring Boot 原理篇(源码环境搭建)

0.1. Spring Boot 核心注解知多少?

在《架构真经》开篇就提到了大道至简、分而治之,感觉 Spring Boot 的设计个人感觉也有点类似。

其实,伴随业务的发展,系统的架构又何尝不是周而复始的经历着万物之始,大道至简,分而治之,衍化至繁的重构迭代的一个过程呢。

那么,从全局上一览 Spring Boot 核心注解设计,会有何感想?

a18712c37405b9c3886c18a464db4061.png

上图是结合 Spring Boot 源码梳理的一些核心注解整理,从表现形式能够体会到 Spring Boot 的一种高度封装的思想,一个 @SpringBootApplication 注解背后隐藏了诸多注解,Spring Boot 着实让程序员简化了配置,可以直面业务研发。

1. 万物之始,大道至简

1d07b27be92c5a0e039bb69c5a07d3b6.png

学习 Spring Boot 的核心注解,就从应用程序入口处配置的 @SpringBootApplication 注解着手。

1.1. @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 {
    // ... ...
}

通过源代码可以看出,@SpringBootApplication 注解内部是包含 @SpringBootConfiguration、@EnableAutoConfiguration、@ComponentScan  等 3 个重要的注解的一个复合注解,功能上可谓是一箭(注解) N 雕(功能)。

2. 分而治之

2.1 @SpringBootConfiguration

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

该注解标明该类使用 Spring 基于 JavaConfig 的注解,通过源代码可以看到 SpringBootConfiguration 注解是对 @Configuration 进行的封装,而 @Configuration 主要用于定义配置类,可以替换 xml 配置文件(想想之前的<beans>...</beans>),被注解的类内部包含有一个或多个被 @Bean 注解的方法,这些方法将会被扫描,并用于构建 Bean 定义,初始化 Spring 容器。


2.2 @ComponentScan

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE})
@Documented
@Repeatable(ComponentScans.class)
public @interface ComponentScan {
    // ... ...
}

@ComponentScan 该注解用来启动组件扫描,比如@Controller 注解、@Service 注解等,都可以被 @ComponentScan 注解扫描到。

2.3 @EnableAutoConfiguration

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@AutoConfigurationPackage
@Import({AutoConfigurationImportSelector.class})
public @interface EnableAutoConfiguration {
    // ... ...
}

@EnableAutoConfiguration 是 Spring Boot 自动装配的关键,可以开启自动配置的功能(有关自动装配的原理,后面会单独去剖析)。

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@AutoConfigurationPackage // 自动配置包
@Import(AutoConfigurationImportSelector.class) // 作用是导入需要自动配置的组件
public @interface EnableAutoConfiguration {


  /**
   * Environment property that can be used to override when auto-configuration is
   * enabled.
   */
  String ENABLED_OVERRIDE_PROPERTY = "spring.boot.enableautoconfiguration";


  /**
   * Exclude specific auto-configuration classes such that they will never be applied.
   * @return the classes to exclude
   */
  Class<?>[] exclude() default {};


  /**
   * Exclude specific auto-configuration class names such that they will never be
   * applied.
   * @return the class names to exclude
   * @since 1.3.0
   */
  String[] excludeName() default {};


}

从 @EnableAutoConfiguration 源代码可以看出,其内部引入了 @AutoConfigurationPackage 和 @Import 这两个注解。@AutoConfigurationPackage 的作用是自动配置包;@Import 则是导入需要自动配置的组件。

99229251612deb21081f39b4081a14e9.png

回头瞅瞅,Spring Boot 对 @SpringBootConfiguration、@EnableAutoConfiguration、@ComponentScan  等重要的注解的配置做了简化封装,在代码开发时只需 @SpringBootApplication 这一个复合注解就轻松开启 Spring 组件扫描和 Spring Boot 自动配置的功能,可谓是化繁为简,So Cool~。

3. 例行回顾

本文基于源码对 Spring Boot 的核心注解设计大概了解,重在体会 Spring Boot 架构的设计思想。

文末提到了 @EnableAutoConfiguration 这个 Spring Boot 自动装配的功臣,哪么 Spring Boot 自动装配是如何实现的呢?下次我们将顺着主线往下捋,感兴趣的可以顺着我画的这个流程图先自己体会体会自动装配的思想。

a7b8c208373672f18ab6806edb58a062.png

一起聊技术、谈业务、喷架构,少走弯路,不踩大坑,会持续输出更多精彩分享,欢迎关注,敬请期待!

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值