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

新闻 前端
本文将基于对前端模板框架 Thymeleaf 的集成,逐步向大家演示如何自定义 ViewResolver以及如何进一步 扩展 Spring MVC 配置。

综合实战

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

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

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

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

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

  1. <dependency> 
  2. <groupId>org. springframework. boot</groupId> 
  3. <artifactId>spring- boot- starter-thymeleaf</ artifactId> 
  4. < /dependency> 
  5. <groupId>org. springframework . boot</groupId> 
  6. <artifactId>spring- boot - starter - web</artifactId> 
  7. </ dependency> 

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

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

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

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

  1. @Configuration 
  2. public class ViewResolverConfig { 
  3. @Bean 
  4. public ThymeleafViewResolver thymeleafViewResolver() { 
  5. Thyme leafViewResolver resolver = new ThymeleafViewResolver(); 
  6. //设置 ViewResolver 对应的属性 值 
  7. resolver. setCharacterEncoding("UTF-8"); 
  8. resolver. setCache(false); 
  9. 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 方法来进行配置,达到同样的效果,具体示例代码如下:

  1. @Configuration 
  2. public class MyMvcConfig implements WebMvcConfigurer { 
  3. @Override 
  4. public void configureViewResolvers (ViewResolverRegistry registry) { 
  5. Thyme leafViewResolver resolver = new ThymeleafViewResolver(); 
  6. //设置 ViewResolver 对应的属 性值 
  7. resolver. setCharacterEncoding("UTF-8"); 
  8. resolver . setCache(false); 
  9. registry . viewResolver(resolver); 

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

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

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

@EnableWebMvc

@Configuration

public class MyMvcConfig implements WebMvcConfigurer {

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

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

小结

本文重点针对 Spring Boot 中 Web 应用的自动配置和 Spring MVC 的自动配置展开,并以Spring MVC 中的一些典型配置为例进行了源码讲解。

其 实 围 绕 Web 应 用 还 有 一 系 列 的 自 动 配 置 比 如HttpEncodingAutoConfigurationMultipartAutoConfiguration和HttpMessageConvertersAutoConfiguration 等。我们只需领悟自动配置的精髓:这些相关配置只不过是将之前通过 xml 来配置 Bean,转换成了基于类的形式来配置而已。读者可按照以上方法对其他 Web 相关的配置项进行相应的阅读和分析。

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

 

 

责任编辑:张燕妮 来源: 今日头条
相关推荐

2020-10-26 15:01:02

Spring Boot源码参数

2009-06-01 11:09:16

OSGI实战进阶

2024-08-26 10:31:23

2020-11-20 07:51:02

JavaSPI机制

2010-05-20 09:48:36

2011-02-15 11:46:41

2010-09-16 15:42:56

2013-05-27 14:03:10

综合布线布线经验

2010-07-07 20:06:53

2010-06-13 13:13:12

UML建模

2011-05-16 13:07:30

2010-09-17 09:13:10

2021-09-27 08:56:44

NettyChannelHand架构

2011-08-02 15:19:28

2015-03-30 17:04:54

智慧商业综合体整体方案华为

2010-06-17 16:14:33

UML总结

2012-12-18 17:11:58

2009-12-31 09:47:07

WEB开发

2019-10-17 10:10:23

优化Web前端

2024-04-12 12:22:39

前端开发网络请求
点赞
收藏

51CTO技术栈公众号