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

丽丽 2020-10-30

综合实战

关于 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 默认自动配置的基础上,我们可以通过什么方式以及如何进行自定义的拓展。本节中提到但未列出实例的内容,大家可以根据已经学习到的思路相应练习。

小结

相关推荐