SpringBoot 入门篇(二) SpringBoot常用注解以及自动配置

时间:2022-07-24 10:37:36

一、SpringBoot常用注解
二、SpringBoot自动配置机制
SpringBoot版本:1.5.13.RELEASE
对应官方文档链接:https://docs.spring.io/spring-boot/docs/1.5.13.RELEASE/reference/htmlsingle/

一、SpringBoot常用注解
  在上一篇文章中https://blog.csdn.net/zhichao_qzc/article/details/80642111引用了官方文档的入门例子,这个例子中只是告诉我们如何去快速上手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);
} }