Spring Boot2 系列教程(十八)Spring Boot 中自定义 SpringMVC 配置

用过 Spring Boot 的小伙伴都知道，咱们只须要在项目中引入 spring-boot-starter-web 依赖，SpringMVC 的一整套东西就会自动给咱们配置好，可是，真实的项目环境比较复杂，系统自带的配置不必定知足咱们的需求，每每咱们还须要结合实际状况自定义配置。

自定义配置就有讲究了，因为 Spring Boot 的版本变迁，加上这一块自己就有几个不一样写法，不少小伙伴在这里容易搞混，今天松哥就来和你们说一说这个问题。

概览

首先咱们须要明确，跟自定义 SpringMVC 相关的类和注解主要有以下四个：

• WebMvcConfigurerAdapter
• WebMvcConfigurer
• WebMvcConfigurationSupport
• @EnableWebMvc

这四个中，除了第四个是注解，另外三个两个类一个接口，里边的方法看起来好像都相似，可是实际使用效果却大不相同，所以不少小伙伴容易搞混，今天松哥就来和你们聊一聊这个问题。

WebMvcConfigurerAdapter

咱们先来看 WebMvcConfigurerAdapter，这个是在 Spring Boot 1.x 中咱们自定义 SpringMVC 时继承的一个抽象类，这个抽象类自己是实现了 WebMvcConfigurer 接口，而后抽象类里边都是空方法，咱们来看一下这个类的声明：

public abstract class WebMvcConfigurerAdapter implements WebMvcConfigurer {
    //各类 SpringMVC 配置的方法
}

再来看看这个类的注释：

/**
 * An implementation of {@link WebMvcConfigurer} with empty methods allowing
 * subclasses to override only the methods they're interested in.
 * @deprecated as of 5.0 {@link WebMvcConfigurer} has default methods (made
 * possible by a Java 8 baseline) and can be implemented directly without the
 * need for this adapter
 */

这段注释关于这个类说的很明白了。同时咱们也看到，从 Spring5 开始，因为咱们要使用 Java8，而 Java8 中的接口容许存在 default 方法，所以官方建议咱们直接实现 WebMvcConfigurer 接口，而不是继承 WebMvcConfigurerAdapter 。

也就是说，在 Spring Boot 1.x 的时代，若是咱们须要自定义 SpringMVC 配置，直接继承 WebMvcConfigurerAdapter 类便可。

WebMvcConfigurer

根据上一小节的解释，小伙伴们已经明白了，WebMvcConfigurer 是咱们在 Spring Boot 2.x 中实现自定义配置的方案。

WebMvcConfigurer 是一个接口，接口中的方法和 WebMvcConfigurerAdapter 中定义的空方法其实同样，因此用法上来讲，基本上没有差异，从 Spring Boot 1.x 切换到 Spring Boot 2.x ，只须要把继承类改为实现接口便可。

松哥在以前的案例中(40 篇原创干货，带你进入 Spring Boot 殿堂！)，凡是涉及到自定义 SpringMVC 配置的地方，也都是经过实现 WebMvcConfigurer 接口来完成的。

WebMvcConfigurationSupport

前面两个都好理解，还有一个 WebMvcConfigurationSupport ，这个又是干什么用的呢？

松哥以前有一篇文章中用过这个类，不知道小伙伴们有没有留意，就是下面这篇：

• 纯 Java 代码搭建 SSM 环境

这篇文章我放弃了 Spring 和 SpringMVC 的 xml 配置文件，转而用 Java 代替这两个 xml 配置。那么在这里我自定义 SpringMVC 配置的时候，就是经过继承 WebMvcConfigurationSupport 类来实现的。在 WebMvcConfigurationSupport 类中，提供了用 Java 配置 SpringMVC 所须要的全部方法。咱们来看一下这个方法的摘要：

有一点眼熟，可能有小伙伴发现了，这里的方法其实和前面两个类中的方法基本是同样的。

在这里首先你们须要明确的是，WebMvcConfigurationSupport 类自己是没有问题的，咱们自定义 SpringMVC 的配置是能够经过继承 WebMvcConfigurationSupport 来实现的。可是继承 WebMvcConfigurationSupport 这种操做咱们通常只在 Java 配置的 SSM 项目中使用，Spring Boot 中基本上不会这么写，为何呢？

小伙伴们知道，Spring Boot 中，SpringMVC 相关的自动化配置是在 WebMvcAutoConfiguration 配置类中实现的，那么咱们来看看这个配置类的生效条件：

@Configuration
@ConditionalOnWebApplication(type = Type.SERVLET)
@ConditionalOnClass({ Servlet.class, DispatcherServlet.class, WebMvcConfigurer.class })
@ConditionalOnMissingBean(WebMvcConfigurationSupport.class)
@AutoConfigureOrder(Ordered.HIGHEST_PRECEDENCE + 10)
@AutoConfigureAfter({ DispatcherServletAutoConfiguration.class, TaskExecutionAutoConfiguration.class,
		ValidationAutoConfiguration.class })
public class WebMvcAutoConfiguration {
}

咱们从这个类的注解中能够看到，它的生效条件有一条，就是当不存在 WebMvcConfigurationSupport 的实例时，这个自动化配置才会生生效。所以，若是咱们在 Spring Boot 中自定义 SpringMVC 配置时选择了继承 WebMvcConfigurationSupport，就会致使 Spring Boot 中 SpringMVC 的自动化配置失效。

Spring Boot 给咱们提供了不少自动化配置，不少时候当咱们修改这些配置的时候，并非要全盘否认 Spring Boot 提供的自动化配置，咱们可能只是针对某一个配置作出修改，其余的配置仍是按照 Spring Boot 默认的自动化配置来，而继承 WebMvcConfigurationSupport 来实现对 SpringMVC 的配置会致使全部的 SpringMVC 自动化配置失效，所以，通常状况下咱们不选择这种方案。

在 Java 搭建的 SSM 项目中(纯 Java 代码搭建 SSM 环境)，由于自己就没什么自动化配置，因此咱们使用了继承 WebMvcConfigurationSupport。

@EnableWebMvc

最后还有一个 @EnableWebMvc 注解，这个注解很好理解，它的做用就是启用 WebMvcConfigurationSupport。咱们来看看这个注解的定义：

/**
 * Adding this annotation to an {@code @Configuration} class imports the Spring MVC
 * configuration from {@link WebMvcConfigurationSupport}, e.g.:

能够看到，加了这个注解，就会自动导入 WebMvcConfigurationSupport，因此在 Spring Boot 中，咱们也不建议使用 @EnableWebMvc 注解，由于它同样会致使 Spring Boot 中的 SpringMVC 自动化配置失效。

总结

不知道上面的解释小伙伴有没有看懂？我再简单总结一下：

1. Spring Boot 1.x 中，自定义 SpringMVC 配置能够经过继承 WebMvcConfigurerAdapter 来实现。
2. Spring Boot 2.x 中，自定义 SpringMVC 配置能够经过实现 WebMvcConfigurer 接口来完成。
3. 若是在 Spring Boot 中使用继承 WebMvcConfigurationSupport 来实现自定义 SpringMVC 配置，或者在 Spring Boot 中使用了 @EnableWebMvc 注解，都会致使 Spring Boot 中默认的 SpringMVC 自动化配置失效。
4. 在纯 Java 配置的 SSM 环境中，若是咱们要自定义 SpringMVC 配置，有两种办法，第一种就是直接继承自 WebMvcConfigurationSupport 来完成 SpringMVC 配置，还有一种方案就是实现 WebMvcConfigurer 接口来完成自定义 SpringMVC 配置，若是使用第二种方式，则须要给 SpringMVC 的配置类上额外添加 @EnableWebMvc 注解，表示启用 WebMvcConfigurationSupport，这样配置才会生效。换句话说，在纯 Java 配置的 SSM 中，若是你须要自定义 SpringMVC 配置，你离不开 WebMvcConfigurationSupport ，因此在这种状况下建议经过继承 WebMvcConfigurationSupport 来实现自动化配置。

不知道小伙伴们有没有看懂呢？有问题欢迎留言讨论。