springboot 项目起步讲解及自动装配原理

梦里梦外; 2024-05-23 18:54 63阅读 0赞

![168c1abc67f4402ebfc99ff077a3e4da.gif][]

> 哈喽~大家好，这篇看看springboot 项目起步讲解及自动装配原理。
> 
> ?个人主页：[个人主页][Link 1]
> 
> ? 系列专栏：[【Java框架】 ][Java_]
> 
> ?与这篇相关的文章：
> 
> <table> 
>  <tbody> 
>   <tr> 
>    <td>&nbsp;【JAVAEE框架】MyBatis与Spring的整合（上）</td> 
>    <td><a href="https://blog.csdn.net/aasd23/article/details/127166622?spm=1001.2014.3001.5501" title="【JAVAEE框架】MyBatis与Spring的整合（上）_程序猿追的博客-CSDN博客" rel="nofollow">【JAVAEE框架】MyBatis与Spring的整合（上）_程序猿追的博客-CSDN博客</a></td> 
>   </tr> 
>   <tr> 
>    <td>【JAVAEE框架】浅谈 AOP 及代码实现</td> 
>    <td><a href="https://blog.csdn.net/aasd23/article/details/126893196" title="【JAVAEE框架】浅谈 AOP 及代码实现_程序猿追的博客-CSDN博客" rel="nofollow">【JAVAEE框架】浅谈 AOP 及代码实现_程序猿追的博客-CSDN博客</a></td> 
>   </tr> 
>   <tr> 
>    <td>【JAVAEE框架】浅谈 Spring 框架的两大核心思想 AOP 与 IOP</td> 
>    <td><a href="https://blog.csdn.net/aasd23/article/details/126890139" title="【JAVAEE框架】浅谈 Spring 框架的两大核心思想 AOP 与 IOP_程序猿追的博客-CSDN博客" rel="nofollow">【JAVAEE框架】浅谈 Spring 框架的两大核心思想 AOP 与 IOP_程序猿追的博客-CSDN博客</a></td> 
>   </tr> 
>  </tbody> 
> </table>

号外号外，我最近发现了一个非常棒的人工智能学习网站，它的内容通俗易懂，风趣幽默，让人印象深刻。我想和大家分享这个网站，[点击链接][Link 2]即可访问。

**目录**

一、前言

1、SpringBoot 简介

二、SpringBoot 入门案例

1、准备

2、测试一下

3、效果展示

三、SpringBoot 自动装配原理

1、SpringBoot 自动装配原理（自个认为）

2、举个例子

3、getRunListeners

4、spring.factories

5、@SpringBootConfiguration

6、@ComponentScan

7、@EnableAutoConfiguration

五、总结

--------------------

## 一、前言 ##

### 1、SpringBoot 简介 ###

SpringBoot 是由 Pivotal 团队提供的全新框架，其设计目的是用来简化 Spring 应用的初始搭建以及开发过程。

我们在学习 Spring 的时候说过 Spring 框架是为了简化开发的，而 SpringBoot 是为了简化 Spring 开发的，由此可见，使用 SpringBoot 开发将会更加的方便简捷。

## 二、SpringBoot 入门案例 ##

### 1、准备 ###

新建项目选择 Spring Initializr，网址填写 [https://start.aliyun.com/][https_start.aliyun.com]（阿里云的网站）

![f03c27dcde8744789eb933b2609971c4.png][]

选择要使用的开发工具，常用的有（Spring Web、Lombok、Mysql Driver、Oracle Driver 等）

![4e7e6dff858a45a1bf8f158f612a4c43.png][]

**注：**

1、在创建好的工程中不需要创建配置类

2、创建好的项目会自动生成其他的一些文件，而这些文件目前对我们来说没有任何作用，所以可以将这些文件删除。

可以删除的目录和文件如下：**.mvn、.gitignore、HELP.md、mvnw、mvnw.cmd**

### **2、测试一下** ###

新建实体类 User

@Data
    @NoArgsConstructor
    @AllArgsConstructor
    @ToString
    public class User {
    
        private String username;
        private String password;
    
    }

**新建控制层类**

@Controller
    @RequestMapping("/user")
    public class HelloAction {
    
        @RequestMapping("/userDetail")
        @ResponseBody
        public User userDetail() {
            User user = new User("123", "456");
    
            return user;
        }
    
    }

**application.yml 文件配置**

server:
      port: 8081
      servlet:
        context-path: /

一个配置端口号，另一个配置应用的上下文路径。

找到我们的启动类，点击启动

![0f6d38c783ba4b79974bb8377cd919f4.png][]

访问路径

[http://localhost:8081/user/userDetail][http_localhost_8081_user_userDetail]

### 3、效果展示 ###

![73d644775e9149d6b27fb546c812b308.png][]

## 三、SpringBoot 自动装配原理 ##

### 1、SpringBoot 自动装配原理（自个认为） ###

我们创建的一个新工程，默认的 SpringApplication.run 传入启动类的class以及main方法的参数。

eg：

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

按住ctrl 点击 run

首先我们从SpringApplication的run方法开始分析，在该方法中调用重载的run方法。

在重载的run方法中，创建了一个SpringApplication实例，并调用重载run方法。

![870de2a1f4264a539a3a620dbe72acf5.png][]

点击 SpringApplication 进去

在SpringApplication构造函数中调用了重载的构造函数。

![0bb32a17e6e94593a463510db1ea151a.png][]

在重载的构造函数中，完成了当前环境的推断以及ApplicationContextInitializer实现类实例化以及ApplicationListener实现类的实例化等。

### 2、举个例子 ###

我们建了一个web的项目，也许大家比较好奇SpringBoot是如何推断当前运行环境，这里我们就先分析这个推断运行环境逻辑。

在SpringApplication的重载的构造函数中点击 deduceFromClasspath

![cd4e7472a2b6402180749c938121dac6.png][]

跳转到 deduceFromClasspath

![8d218797b30b44c89c30689153060d37.png][]

这里判断 是什么类型默认为 SERVLET。

当然 SpringApplication 不止做了这些初始化。

明白SpringBoot是如何推断当前运行环境后，接下来我们就分析SpringBoot的核心方法 run方法。

### 3、**getRunListeners**  ###

**getRunListeners** 首先来分析getRunListeners方法，在该方法中，通过getSpringFactoriesInstances方法来获取classpath下META-INF/spring.factories文件中key为org.springframework.boot.SpringApplicationRunListener的value，然后并进行实例化，将结果作为参数传入到SpringApplicationRunListeners的构造函数中，最后返回该实例。

private SpringApplicationRunListeners getRunListeners(String[] args) {
        Class<?>[] types = new Class<?>[] { SpringApplication.class, String[].class };
        return new SpringApplicationRunListeners(logger,
                getSpringFactoriesInstances(SpringApplicationRunListener.class, types, this, args));
    }

![4cf21dff17ee4cf2b19e20971312cfa4.png][]

### **4、spring.factories** ###

**spring.factories**用键值对的方式记录了所有需要加入容器的类，EnableAutoConfigurationImportSelector的selectImports方法返回的类名，来自spring.factories文件内的配置信息，这些配置信息的key等于EnableAutoConfiguration，因为spring boot应用启动时使用了EnableAutoConfiguration注解，所以EnableAutoConfiguration注解通过import注解将EnableAutoConfigurationImportSelector类实例化，并且将其selectImports方法返回的类名实例化后注册到spring容器。

即spring.factories文件是帮助spring-boot项目包以外的bean（即在pom文件中添加依赖中的bean）注册到spring-boot项目的spring容器中。由于@ComponentScan注解只能扫描spring-boot项目包内的bean并注册到spring容器中，因此需要@EnableAutoConfiguration注解来注册项目包外的bean。而spring.factories文件，则是用来记录项目包外需要注册的bean类名。

我们在来看看 @SpringBootApplication 注解

点击 @SpringBootApplication ，发现他其实是个**复合注解**

@Target({ElementType.TYPE})
    @Retention(RetentionPolicy.RUNTIME)
    @Documented

这三个不用管，这是大部分的复合注解都有的，主要看这三个。

@SpringBootConfiguration
    @EnableAutoConfiguration
    @ComponentScan

### 5、@SpringBootConfiguration ###

先来看第一个：@SpringBootConfiguration

进入这个注解之后会发现

![06aef2e985e944a3bafb65aabe1488d0.png][]

就是一个@Configuration啊，一个JavaConfig配置类

**@Configuration用于定义配置类**，可替换xml配置文件，被注解的类内部包含有一个或多个被@Bean注解的方法，这些方法将会被AnnotationConfigApplicationContext或AnnotationConfigWebApplicationContext类进行扫描，并用于构建bean定义，初始化Spring容器。

@Configuration  // 标记为配置类
    public class MyConfig {
    
        @Bean // 给容器添加组件，以方法名作为组件的id，返回类型就是组件的类型，返回值就是组件在容器中的实例
        public Book defaultBook() {
            return new Book("白夜行", "东野圭吾", "人民邮电出版社");
        }
    
        @Bean // 给容器添加组件，以方法名作为组件的id，返回类型就是组件的类型，返回值就是组件在容器中的实例
        public Periodical defaultPeriodical() {
            return new Periodical("时代经贸", "赵建锁", "北京财贸职业学院");
        }
    
    }

test 类

@SpringBootTest
    class ConfigurationApplicationTests {
    
        @Autowired
        MyConfig myConfig;
    
        @Test
        void contextLoads() {
            System.out.println(myConfig.defaultBook());
            System.out.println(myConfig.defaultPeriodical());
        }
    
    }

![e67748e060244373a7ec496cb90c8682.png][]

![0337f7171821466cba873a7f84a98ede.png][]

### 6、@ComponentScan ###

这个注解相信大家都认识了，组件扫描

这个扫描的范围是：SpringBoot主启动类的同级路径及子路径

![9c8faee7d0a54a838503c88d96277cf3.png][]

### 7、@EnableAutoConfiguration ###

@EnableAutoConfiguration 点击进去，核心：@Import(AutoConfigurationImportSelector.class)

![43499fab727c438b80717795ba0323e7.png][]

看看AutoConfigurationImportSelector，它是实现了 DeferredImportSelector 的一个类，使用了 selectImports 这个方法，返回值类型是String\[\]，返回的是要加载的Config配置文件的全包名，通过返回这个全包名，我们就能自动装配上这些配置文件下定义的bean对象，从而达到了自动装配的目的！

继续反推，看到 AutoConfigurationEntry 这个类，发现**autoConfigurationEntry**中保存着我们需要的配置信息，它是通过**getAutoConfigurationEntry**方法获取的，于是我们继续深入，进入getAutoConfigurationEntry方法

![37630d1bc9b54804863a987f4c8a74fd.png][]

发现返回了两个参数 configurations, exclusions。

configurations显然使我们需要的配置文件，也是我们最关心的，而exclusions字面意思是排除，也就是不需要的，那我们接下来应该关注configurations到底是怎么来的。

方法参数里面有个 **Annotation**(注解) 加上configurations，确定一行代码

List<String> configurations = this.getCandidateConfigurations(annotationMetadata, attributes);

点击getCandidateConfigurations，查看

![f6a2140ee8284172964778c9fa56a9c7.png][]

有一串英文 “No auto configuration classes found in META-INF/spring.factories. If you are using a custom packaging, make sure that file is correct.”，意思是“在META-INF/spring.factories中找不到自动配置类。如果您使用的是自定义打包，请确保文件正确。”

在前面看到配置文件就叫**spring.factories**，存放的路径是**META-INF/spring.factories**，很明显就是这个路径下的文件

![cde76f6ffc1241068484559f9d1eb07f.png][]

这里的**EnableAutoConfiguration**注解，正是我们此行的起点啊…

到这里，自动装配到底是什么，应该比较清楚了，原来他是帮我们加载了各种已经写好的Config类文件，实现了这些JavaConfig配置文件的重复利用和组件化

自动装配笔记参考于[这篇博客][Link 3]

## 五、总结 ##

自动配置简单来说呢，就是将第三方的组件**自动装载到IOC容器**里面，不需要开发人员再去编写相关的配置，在SpringBoot应用里面呢只需要加上**@SpringBootApplication注解就可以实现自动配置**，SpringBootApplication它是一个复合注解，真正实现自动装配的注解是**@EnableAutoConfiguration注解**。自动装配的实现呢主要依靠三个核心的关键技术：

**1、引入Starter**，启动依赖组件的时候，这个组件里面必须包括@Configuration配置类，然后我需要通过Bean注解去声明需要装配到IOC容器里面的Bean对象

**2、这个配置类是放在第三方的jar包里面**，然后通过Spring Boot中约定大于配置的理念，去把配置类的全路径放在件META\_INF/Spring.factories文件里面，SpringBoot就可以知道第三方jar包里面配置类的位置，它主要是依靠Spring里面的SpringFactorierLoader来完成的

**3、SpringBoot拿到所有第三方jar包声明的配置类之后**，再通过ImportSelector这样一个接口来实现对这些配置类的动态加载，从而去完成自动装配这样的一个动作。

**4、个人理解**

SpringBoot是约定优于配置这一理念下的一个产物，所以在很多的地方都会看到这一类的思想，它的出现让开发人员可以更加聚焦在业务代码的编写上，而不需要去关系和业务无关的配置，其实自动装配的思想在springframework3.x版本里面的@enable注解，就已经有了实现的一个雏形，@enable注解时候一个模块驱动的意思，就是说我们只要增加@enable注解，就可以自动打开某个功能，而不需要针对这个功能去做Bean的配置，@enable注解的底层是帮我们自动完成这样的一个模块相关bean的注入

> **不积跬步无以至千里，趁年轻，使劲拼，给未来的自己一个交代！向着明天更好的自己前进吧！**
> 
> ![d5358fcd619443fe98143f2fd5fef762.gif][]

[168c1abc67f4402ebfc99ff077a3e4da.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/23/62c2609649094e139781a631ce519bfc.gif
[Link 1]: https://blog.csdn.net/aasd23?spm=1000.2115.3001.5343
[Java_]: https://blog.csdn.net/aasd23/category_12005462.html
[Link 2]: https://www.captainbed.cn/zhui
[https_start.aliyun.com]: https://start.aliyun.com/
[f03c27dcde8744789eb933b2609971c4.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/23/7b6c7caeb72f45bdb0892ba5653070d4.png
[4e7e6dff858a45a1bf8f158f612a4c43.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/23/3d759ad0e73a4a11aa92d260acfbd75e.png
[0f6d38c783ba4b79974bb8377cd919f4.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/23/df8f6fea029947799e415bbcf327e7d5.png
[http_localhost_8081_user_userDetail]: http://localhost:8081/user/userDetail
[73d644775e9149d6b27fb546c812b308.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/23/d697587c29064fda8f3ddf6758bcb6c3.png
[870de2a1f4264a539a3a620dbe72acf5.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/23/af0b57ab1b8f4b3896f2a8e76c9cb002.png
[0bb32a17e6e94593a463510db1ea151a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/23/851497e94dea4aedaa03c0ba15be02cc.png
[cd4e7472a2b6402180749c938121dac6.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/23/eaaba208a0af40b6ae5c182d9123f0ec.png
[8d218797b30b44c89c30689153060d37.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/23/a78d60f97cc54328999219b6dda65396.png
[4cf21dff17ee4cf2b19e20971312cfa4.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/23/d03ba42129d54569b4b2ce0ab0cf79cd.png
[06aef2e985e944a3bafb65aabe1488d0.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/23/946505528c5c4bd6af8d8712b851e0d6.png
[e67748e060244373a7ec496cb90c8682.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/23/f142d18fe75a42498ac8212add922e1f.png
[0337f7171821466cba873a7f84a98ede.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/23/c846f32968fd4afb9c68a592df0b4007.png
[9c8faee7d0a54a838503c88d96277cf3.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/23/47c3ead2391e4bb8a65767c96dd86fed.png
[43499fab727c438b80717795ba0323e7.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/23/982c8b6ce3694d078e600807b84c7981.png
[37630d1bc9b54804863a987f4c8a74fd.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/23/011f845997d848f9bffc2e7c42a2d409.png
[f6a2140ee8284172964778c9fa56a9c7.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/23/7269d3f5490140bcb7f9748ea6ee948c.png
[cde76f6ffc1241068484559f9d1eb07f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/23/8a4051b9f8f841d1b40f20211642d441.png
[Link 3]: https://blog.csdn.net/weixin_43826242/article/details/106005176?ops_request_misc=%257B%2522request%255Fid%2522%253A%2522166700721416782391861965%2522%252C%2522scm%2522%253A%252220140713.130102334..%2522%257D&request_id=166700721416782391861965&biz_id=0&utm_medium=distribute.pc_search_result.none-task-blog-2~all~top_positive~default-1-106005176-null-null.142%5Ev62%5Epc_new_rank,201%5Ev3%5Econtrol_2,213%5Ev1%5Econtrol&utm_term=springboot%E8%87%AA%E5%8A%A8%E8%A3%85%E9%85%8D%E5%8E%9F%E7%90%86&spm=1018.2226.3001.4187
[d5358fcd619443fe98143f2fd5fef762.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/23/2bab9c9eeede4181826d9dc16314074e.gif