SpringBoot 入门篇（二） SpringBoot常用注解以及自动配置

一时失言乱红尘 2022-05-22 00:51 239阅读 0赞

### 一、SpringBoot常用注解 ###

### 二、SpringBoot自动配置机制 ###

SpringBoot版本：1.5.13.RELEASE  
对应官方文档链接：[https://docs.spring.io/spring-boot/docs/1.5.13.RELEASE/reference/htmlsingle/][https_docs.spring.io_spring-boot_docs_1.5.13.RELEASE_reference_htmlsingle]

上一篇：[SpringBoot 入门篇（一） Hello World][SpringBoot _ Hello World]

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

### 一、SpringBoot常用注解 ###

在上一篇文章中[https://blog.csdn.net/zhichao\_qzc/article/details/80642111][SpringBoot _ Hello World]引用了官方文档的入门例子，这个例子中只是告诉我们如何去快速上手SpringBoot，我们实际开发中，肯定不会在一个类中把所有业务处理包圆，通常会划分出Controller层、Service层、Dao层等。SpringBoot官方文档给出了如何去规划我们的代码，并且如何正确使用它们。  
  官方文档给出了一个常用的代码层次划分结构图

![1240][]

官方文档推荐将包含main方法的类放到项目的根包下，并且使用@SpringBootApplication注解进行标注，该注解会将当前类所在路径作为基准目录，扫描基准目录下所有类（包含子目录中的类）。  
  @SpringBootApplication是SpringBoot提供的一个常用注解，它包含了另外3个很常用的注解，分别是@EnableAutoConfiguration，@ComponentScan和@Configuration。

@SpringBootApplication // 等价于 @Configuration + @EnableAutoConfiguration + @ComponentScan
    public class Application {
    
        public static void main(String[] args) {
            SpringApplication.run(Application.class, args);
        }
    
    }

（1）@EnableAutoConfiguration是SpringBoot提供的一个注解，它的作用是启动SpringBoot的自动配置机制；  
（2）@ComponentScan是Spring框架提供的一个注解，它能扫描项目中所有的组件（@Component, @Service, @Repository, @Controller等进行标注的类）并将其注册到Spring容器；  
（3）@Configuration是Spring框架提供的一个注解，它能替代传统的xml配置文件，将Spring框架中的xml文件以Java类的形式替代，去XML是SpringBoot的一个重要思想。  
  在项目中我们可以将类同时标注@EnableAutoConfiguration、@ComponentScan和@Configuration，所起的作用和@SpringBootApplication是相同的，但需要注意的是，@EnableAutoConfiguration、@ComponentScan和@Configuration这3个注解并非是捆绑销售，我们可以将他们任意组合。官方文档中给出了如下的一个例子

@Configuration
    @EnableAutoConfiguration
    @Import({ MyConfig.class, MyAnotherConfig.class })
    public class Application { 
    
        public static void main(String[] args) {
                SpringApplication.run(Application.class, args);
        }
    
    }

可以看到，代码中并没有使用@ComponentScan注解，而是使用@Import注解来导入组件并将其声明成一个bean。当然，如果我们对XML文件念念不忘，我们可以使用@ImportResource注解来导入XML文件，@Import和@ImportResource都是Spring框架提供的注解。

@Configuration
    @EnableAutoConfiguration
    @ImportResource(locations={
       "classpath:applicationContext.xml"})
    public class Application { 
    
        public static void main(String[] args) {
                SpringApplication.run(Application.class, args);
        }
    
    }

### 二、SpringBoot自动配置机制 ###

SpringBoot总是尝试根据我们的jar依赖，来为我们的项目进行一些自动配置以减轻开发者环境搭建的负担，例如我们项目中依赖了spring-boot-starter-web，SpringBoot则会自动为我们进行web环境的配置（如添加内置Tomcat、配置SpringMVC等）。  
  SpringBoot自动配置的幕前黑手就是上一节中提到的@EnableAutoConfiguration注解。SpringBoot自动配置是非入侵的，我们可以开启我们自己的配置来替代自动配置，例如如果我们添加了自己的数据源配置，则SpringBoot默认内置的数据库服务则不会起作用。  
  我们可以在启动时加入 –debug 参数来查看当前有那些自动配置，命令行直接执行java -jar *\**.jar –debug即可。如果想在IDEA中查看，则首先进行如下配置

![1240 1][]

![1240 2][]

执行main方法即可看到当前有那些自动配置

![1240 3][]

如果我们不需要某些自动配置，可以通过@EnableAutoConfiguration注解的exclude或者excludeName属性来指定不需要的自动配置，需要注意的是，当不需要的进行自动配置的类不在classpath下时，此时只能通过excludeName属性指定类的全路径名来排除不需要的自动配置。当然，还有一种办法是在SpringBoot配置文件中指定spring.autoconfigure.exclude，SpringBoot配置文件一般是指classpath下默认的application.properties或者application.yml或者application.yaml，在这里不做说明，后续的文章会进行详细介绍。

@Configuration
    @EnableAutoConfiguration(exclude={DataSourceAutoConfiguration.class})
    public class Application { 
    
        public static void main(String[] args) {
                SpringApplication.run(Application.class, args);
        }
    
    }

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

上一篇：[SpringBoot 入门篇（一） Hello World][SpringBoot _ Hello World]

下一篇：[SpringBoot 入门篇（三） SpringApplication][SpringBoot _ SpringApplication]

[https_docs.spring.io_spring-boot_docs_1.5.13.RELEASE_reference_htmlsingle]: https://docs.spring.io/spring-boot/docs/1.5.13.RELEASE/reference/htmlsingle/
[SpringBoot _ Hello World]: https://blog.csdn.net/zhichao_qzc/article/details/80642111
[1240]: /images/20220522/33163352dd144ea98f8a63921c04b39d.png
[1240 1]: /images/20220522/23da95dbcec44d87b247b1fee8a9a26f.png
[1240 2]: /images/20220522/5adc357f455b43658967f25bee45db7e.png
[1240 3]: /images/20220522/e655a47185b24f558d755c82ce134bef.png
[SpringBoot _ SpringApplication]: https://blog.csdn.net/zhichao_qzc/article/details/80673026