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

一、SpringBoot常用注解

二、SpringBoot自动配置机制

SpringBoot版本：1.5.13.RELEASE
对应官方文档链接：https://docs.spring.io/spring-boot/docs/1.5.13.RELEASE/reference/htmlsingle/

上一篇：SpringBoot 入门篇（一） Hello World

---

一、SpringBoot常用注解

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

  官方文档推荐将包含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中查看，则首先进行如下配置

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

如果我们不需要某些自动配置，可以通过@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 入门篇（三） SpringApplication