点击上方 好好学java ，选择 星标 公众号
重磅资讯，干货，第一时间送达

今日推荐：分享一套基于SpringBoot和Vue的企业级中后台开源项目，这个项目有点哇塞！
个人原创100W +访问量博客：点击前往，查看更多

本文是 Spring Boot 基础知识复习手册，总共 2w 字，可以先收藏、转发。有需要的时候查阅，本文设计的知识包括：配置常用注解、Spring Boot 自动配置、配置原理、如何修改默认配置、静态资源处理、Rest映射、Spring Boot 常用注解、文件上传、拦截器、错误处理、数据层整合：MyBatis、JDBC、Druid、Redis等等。

配置注解

@Configuration & @Bean

Spring Boot不同于传统的Spring，它不提倡使用配置文件，而是使用配置类来代替配置文件，所以该注解就是用于将一个类指定为配置类：

@Configuration
public class MyConfig {

    @Bean("user")
    public User getUser(){
        return new User("张三",20);
    }
}

在配置类中使用方法对组件进行注册，它的效果等价于：

"user" class="com.wwj.springboot.bean.User">
  <property name="name" value="张三"/>
  <property name="age" value="20"/>
bean>

需要注意的是 Spring Boot 默认会以方法名作为组件的id，也可以在 @Bean() 中指定value值作为组件的id。

@Import

在Spring中，我们可以使用@Component、@Controller、@Service、@Repository注解进行组件的注册，而对于一些第三方的类，我们无法在类上添加这些注解，为此，我们可以使用@Import注解将其注册到容器中。

@Configuration(proxyBeanMethods = true)
@Import(User.class)
public class MyConfig {
}

通过@Import注解注册的组件，其id为全类名。

@Conditional

该注解为条件装配注解，大量运用于SpringBoot底层，由该注解衍生出来的注解非常多：

这里以@ConditionalOnBean和@ConditionalOnMissingBean举例。其中@ConditionalOnBean注解的作用是判断当前容器中是否拥有指定的Bean，若有才生效，比如：

@Configuration
public class MyConfig {

    @Bean("dog")
    public Dog getDog(){
        return new Dog();
    }

    @Bean("user")
    @ConditionalOnBean(name = "dog")
    public User getUser(){
        return new User("张三",20);
    }
}

若如此，则SpringBoot在注册User对象之前，会先判断容器中是否已经有id为 dog 的对象，若有才创建，否则不创建。@ConditionalOnBean注解共有三种方式判断容器中是否已经存在指定的对象，除了可以判断组件的id外，也能够通过判断组件的全类名：

@Bean("user")
@ConditionalOnBean(type = "com.wwj.springboot.bean.Dog")
public User getUser(){
    return new User("张三",20);
}

还可以通过判断组件的类型：

@Bean("user")
@ConditionalOnBean(value = Dog.class)
public User getUser(){
    return new User("张三",20);
}

尤其需要注意的是，因为代码是从上至下依次执行的，所以在注册组件时的顺序要特别注意，比如：

@Configuration
public class MyConfig {

    @Bean("user")
    @ConditionalOnBean(value = Dog.class)
    public User getUser(){
        return new User("张三",20);
    }

    @Bean("dog")
    public Dog getDog(){
        return new Dog();
    }
}

在这段程序中，SpringBoot会先注册User对象，而此时Dog对象还没有被注册，所以会导致User对象无法注册。

而@ConditionalOnMissingBean注解的作用与@ConditionalOnBean注解正好相反，它会判断当前容器中是否不存在指定的Bean，若不存在则生效，否则不生效。

这些注解除了能够标注在方法上，还能作用于类上，当被标注在类上时，若条件成立，则配置类的所有注册方法生效；若条件不成立，则配置类的所有注册方法均不成立。

@Configuration
@ConditionalOnBean(value = Dog.class)
public class MyConfig {

    @Bean("user")
    public User getUser(){
        return new User("张三",20);
    }

    @Bean("dog")
    public Dog getDog(){
        return new Dog();
    }
}

@ImportResource

该注解用于导入资源，比如现在有一个Spring的配置文件：

xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">

    <bean id="ls" class="com.wwj.springboot.bean.User">
        <property name="name" value="李四"/>
        <property name="age" value="25"/>
    bean>
    
    <bean id="tom" class="com.wwj.springboot.bean.Dog">
        <property name="name" value="tom"/>
        <property name="age" value="3"/>
    bean>
beans>

若是想将其转化为配置类，代码少一点倒还好说，当配置文件中注册的Bean非常多时，采用人工的方式显然不是一个好的办法，为此，SpringBoot提供了@ImportResource注解，该注解可以将Spring的配置文件直接导入到容器中，自动完成组件注册。

@Configuration
@ImportResource("classpath:bean.xml")
public class MyConfig {

    @Bean("user")
    public User getUser(){
        return new User("张三",20);
    }

    @Bean("dog")
    public Dog getDog(){
        return new Dog();
    }
}

@ConfigurationProperties

该注解用于配置绑定，也大量运用于SpringBoot底层。首先在配置文件中编写两个键值：

user.name=zhangsan
user.age=30

然后使用该注解将其绑定到User类上：

@Component
@ConfigurationProperties(prefix = "user")
public class User {

    private String name;
    private int age;

    public User() {
    }

    @Override
    public String toString() {
        return "User{" +
                "name='" + name + '\'' +
                ", age=" + age +
                '}';
    }
}

但结果却有些出乎意料：

User{name='Administrator', age=30}

这是因为我们将前缀 prefix 指定为了user，而user可能和我们的系统配置产生了重复，所以导致了这个问题，此时我们只需将前缀修改一下即可：

@Component
@ConfigurationProperties(prefix = "users")
public class User {

    private String name;
    private int age;

    public User() {
    }

    @Override
    public String toString() {
        return "User{" +
                "name='" + name + '\'' +
                ", age=" + age +
                '}';
    }
}

前缀修改了，配置文件的内容也需要做相应的修改：

users.name=zhangsan
users.age=30

需要注意的是，若是想实现配置绑定，就必须要将这个待绑定的类注册到容器中，比如使用@Component注解，当然，SpringBoot也提供了一个注解与其配套使用，它就是：@EnableConfigurationProperties 。

该注解必须标注在配置类上：

@Configuration
@EnableConfigurationProperties(User.class)
public class MyConfig {
}

作用是开启指定类的配置绑定功能，它的底层其实也是通过@Import注解实现的，此时User类就无需将其注册到容器中：

@ConfigurationProperties(prefix = "users")
public class User {

    private String name;
    private int age;

    public User() {
    }

    @Override
    public String toString() {
        return "User{" +
                "name='" + name + '\'' +
                ", age=" + age +
                '}';
    }
}

Spring Boot 会自动将属性值绑定到 User 类，并将其注册到容器中。Spring Boot 相关的技术文章我整理成了 PDF，关注微信公众号「Java后端」回复「666」下载这一本技术栈手册。

自动配置原理

有了前面的注解基础之后，我们就能够更深入地了解Spring Boot的自动配置原理，自动配置正是建立在这些强大的注解之上的。

我们首先观察一下主启动类上的注解：

@SpringBootApplication
public class SpringbootApplication {

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

翻阅源码可以得知，@SpringBootApplication注解其实是由三个注解组成的：

@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan(
    excludeFilters = {@Filter(
    type = FilterType.CUSTOM,
    classes = {TypeExcludeFilter.class}
), @Filter(
    type = FilterType.CUSTOM,
    classes = {AutoConfigurationExcludeFilter.class}
)}
)
public @interface SpringBootApplication {
}

其中@SpringBootConfiguration底层是@Configuration注解，它表示主启动类是一个配置类；而@ComponentScan是扫描注解，它默认扫描的是主启动类当前包及其子包下的组件；最关键的就是@EnableAutoConfiguration注解了，该注解便实现了自动配置。

查看@EnableAutoConfiguration注解的源码，又会发现它是由两个注解组合而成的：

@AutoConfigurationPackage
@Import({AutoConfigurationImportSelector.class})
public @interface EnableAutoConfiguration {
}

我们继续查看@AutoConfigurationPackage注解的源码：

@Import({Registrar.class})
public @interface AutoConfigurationPackage {
}

@Import注解我们非常熟悉，它是用来导入一个组件的，然而它比较特殊：

static class Registrar implements ImportBeanDefinitionRegistrar, DeterminableImports {
    Registrar() {
    }

    public void registerBeanDefinitions(AnnotationMetadata metadata, BeanDefinitionRegistry registry) {
        AutoConfigurationPackages.register(registry, (String[])(new AutoConfigurationPackages.PackageImports(metadata)).getPackageNames().toArray(new String[0]));
    }

    public Set