SpringBoot Web 应用源码解析：综合实战和整体总结

综合实战

关于 Web 方面的配置比较多，值得庆幸的是，Spring Boot 已经帮我们预置初始化了很多基础组件。但在实践的过程中，某些基础的组件并不能满足我们的实际需求,这时就需要我们重新初始化相应组件，甚至在某些极端的情况下需要完全接管 Spring Boot 的默认配置。

本文将基于对前端模板框架 Thymeleaf 的集成，逐步向大家演示如何自定义 ViewResolver以及如何进一步 扩展 Spring MVC 配置。本实例涉及集成 Thymeleaf、自定义初始化ThymeleafViewResolver 以及扩展 Spring MVC。

Thymeleaf 是一个 Java 类库，能够处理 HTML/HTML5、XML、JavaScript、CSS， 甚至纯文本类型的文件。通常可以用作MVC中的View层，它可以完全替代 JSP。该框架是SpringBoot 首推的前端展示框架。

首先我们创建一个集成 Thymeleaf 的 SpringBootWeb 项目。集成 Thymeleaf 的核心操作就是引入对应的 starter，对应项目中 pom.xml 的依赖如下。

<dependency> 
<groupId>org. springframework. boot</groupId> 
<artifactId>spring- boot- starter-thymeleaf</ artifactId> 
< /dependency> 
<groupId>org. springframework . boot</groupId> 
<artifactId>spring- boot - starter - web</artifactId> 
</ dependency> 

通过前面的学习我们已经得知引入该 starter 之后，Spring Boot 便会进行一个初始化的基本配置，因此针对 Thymeleaf 的最简单集成便完成了，关于页面展示和基础配置我们暂时先不考虑。当集成 Thymeleaf 之后，Thymeleaf 对应的自动配置类 ThymeleafAutoConfiguration 中会初始化一个 ThymeleafViewResolver, 用来对 Thymeleaf 的页面进行解析和渲染。这一操作本质上同默认的 BeanNameViewResolver 作用-样，都实现了 ViewResolver 接口。

此时，如果官方提供的 ThymeleafViewResolver 的默认设 置无法满足我们的需求，可以通过 两 种 途 径 进 行 自 定 义 设 置 : 通 过 application 配 置 文 件 配 置 和 自 行 创 建ThymeleafViewResolver 对象。

通过 application 配置对应的属性定义位于 ThymeleafProperties 类中，我们已经做过多次类似的配置，不再赘述。

我们可以通过以下方式自行创建 ThymeleafViewResolver 对象。先定义一个配置类ViewResolverConfig，并在类内部通过@Bean 注解对实例化的 ThymeleafViewResolver对象进行注入容器的操作。

@Configuration 

public class ViewResolverConfig { 

@Bean 

public ThymeleafViewResolver thymeleafViewResolver() { 
Thyme leafViewResolver resolver = new ThymeleafViewResolver(); 

//设置 ViewResolver 对应的属性 值 
resolver. setCharacterEncoding("UTF-8"); 
resolver. setCache(false); 

return resolver; 
} 
} 

@Bean 默 认 会 将 方 法 thymeleafViewResolver 作 为 Bean 的 key, 将 返 回 的Thymeleaf-ViewResolver 对 象 作 为 Value 存 入 容 器 当 中 。 在 方 法 内 部 ， 可 通 过ThymeleafViewResolver 对应的方法进行属性的初始化设置。通过以上代码我们便完成了自定义 Thymeleaf-ViewResolver 的注入。

那么，原来默认的 ThymeleafViewResolver 会怎么处理呢? 我们知道几乎所有的自动配置类都是通过注解设置初始化条件的，比如 ThymeleafViewResolver 默认实例化的条件是当容器中不存在名称为 thymeleafViewResolver 时才会使用默认的初始化。当自定义的ThymeleafViewResolver 类完成初始化之后，默认配置的初始化条件便不再满足了。

上面针对 SpringMVC 中 Thymeleaf 的 ViewResolver 的自定义进行了讲解。

其实在 Spring Boot 中，大多数组件都可以采用同样的方式对默认配置进行覆盖。除了上述方法，在 Spring Boot 项目中还可以通过实现 WebMvcConfigurer 接口来进行更灵活地自定义配置。

通过 WebMvcConfigurer 接口实现自定义配置是 Spring 内部的一-种配置方式，它替代了传统的 XML 形式的配置。通过对该接口具体方法的实现，可以自定义一些 Handler、Interceptor 、ViewResolver 、MessageConverter 等参 数 。 以 上 面 配 置ThymeleafViewResolver 为例，我们也可以通过实现该接口的 configureViewResolvers 方法来进行配置,达到同样的效果，具体示例代码如下：

@Configuration 

public class MyMvcConfig implements WebMvcConfigurer { 

@Override 

public void configureViewResolvers (ViewResolverRegistry registry) { 
Thyme leafViewResolver resolver = new ThymeleafViewResolver(); 

//设置 ViewResolver 对应的属 性值 
resolver. setCharacterEncoding("UTF-8"); 
resolver . setCache(false); 
registry . viewResolver(resolver); 
} 
} 

使用 WebMvcConfigurer 接口时需注意 Spring Boot 版本，以上代码是基于 Spring Boot 2.0以后的版本。WebMvcConfigurer 接口还提供 了其他关于扩展 SpringMVC 配置的接口，使用方法与上述示例基本一样，大家可以查阅对应的代码进一步了解， 这里就不再逐一举例了。

最后，关于 SpringMVC 自定义配置的最彻底操作就是完全接管 SpringBoot 关于 SpringMVC的默认配置，具体操作就是在 WebMvcConfigurer 的实现类上使用@EnableWebMvc 注解，示例如下。

@EnableWebMvc

@Configuration

public class MyMvcConfig implements WebMvcConfigurer {

使用该注解等于扩展了 WebMvcConfigurationSupport,但是没有重写任何方法，因此所需的功能都需要开发人员自行实现。-般情况下不推荐使用这种方式，该方式更适合基于 SpringBoot 提供的默认配置，针对特别需求进行有针对性拓展的场景。

其实，本节内容的重点并不只是让大家学会简单的 Web 自定义配置，更深的用意是希望大家了解在 Spring Boot 默认自动配置的基础上，我们可以通过什么方式以及如何进行自定义的拓展。本节中提到但未列出实例的内容，大家可以根据已经学习到的思路相应练习。

小结