springboot干货系列（四）:集成thymeleaf

落日映苍穹つ 2022-05-14 13:35 318阅读 0赞

# 正文 #

Spring Boot提供了spring-boot-starter-web为Web开发予以支持，spring-boot-starter-web为我们提供了嵌入的Tomcat以及Spring MVC的依赖。

# 项目结构推荐 #

一个好的项目结构会让你开发少一些问题，特别是Spring Boot中启动类要放在root package下面，我的web工程项目结构如下：

![0_wx_fmt_jpeg][]

*  root package结构：com.dudu
 *  应用启动类Application.java置于root package下，这样使用@ComponentScan注解的时候默认就扫描当前所在类的package
 *  实体（Entity）置于com.dudu.domain包下
 *  逻辑层（Service）置于com.dudu.service包下
 *  controller层（web）置于com.dudu.controller层包下
 *  static可以用来存放静态资源
 *  templates用来存放默认的模板配置路径

# Spring Web MVC框架介绍 #

Spring Web MVC框架（通常简称为”Spring MVC”）是一个富”模型，视图，控制器”的web框架。

Spring MVC允许你创建特定的@Controller或@RestController beans来处理传入的HTTP请求。

示例：

![0_wx_fmt_jpeg 1][]

Spring Boot为Spring MVC提供适用于多数应用的自动配置功能。在Spring默认基础上，自动配置添加了以下特性：Spring MVC自动配置

1.  引入ContentNegotiatingViewResolver和BeanNameViewResolver beans。
2.  对静态资源的支持，包括对WebJars的支持。
3.  自动注册Converter，GenericConverter，Formatter beans。
4.  对HttpMessageConverters的支持。
5.  自动注册MessageCodeResolver。
6.  对静态index.html的支持。
7.  对自定义Favicon的支持。

如果想全面控制Spring MVC，你可以添加自己的@Configuration，并使用@EnableWebMvc对其注解。如果想保留Spring Boot MVC的特性，并只是添加其他的MVC配置(拦截器，formatters，视图控制器等)，你可以添加自己的WebMvcConfigurerAdapter类型的@Bean（不使用@EnableWebMvc注解）,具体拦截器等配置后续文章会解析。

# 静态文件 #

默认情况下，Spring Boot从classpath下一个叫/static（/public，/resources或/META-INF/resources）的文件夹或从ServletContext根目录提供静态内容。这使用了Spring MVC的ResourceHttpRequestHandler，所以你可以通过添加自己的WebMvcConfigurerAdapter并覆写addResourceHandlers方法来改变这个行为（加载静态文件）。

在一个单独的web应用中，容器默认的servlet是开启的，如果Spring决定不处理某些请求，默认的servlet作为一个回退（降级）将从ServletContext根目录加载内容。大多数时候，这不会发生（除非你修改默认的MVC配置），因为Spring总能够通过DispatcherServlet处理请求。

此外，上述标准的静态资源位置有个例外情况是Webjars内容。任何在/webjars/\*\*路径下的资源都将从jar文件中提供，只要它们以Webjars的格式打包。

注：如果你的应用将被打包成jar，那就不要使用src/main/webapp文件夹。尽管该文件夹是一个共同的标准，但它仅在打包成war的情况下起作用，并且如果产生一个jar，多数构建工具都会静悄悄的忽略它

# 模板引擎 #

Spring Boot支持多种模版引擎包括：

*  FreeMarker
 *  Groovy
 *  Thymeleaf(官方推荐)
 *  Mustache

JSP技术Spring Boot官方是不推荐的，原因有三：

1.  tomcat只支持war的打包方式，不支持可执行的jar。
2.  Jetty 嵌套的容器不支持jsp
3.  Undertow
4.  创建自定义error.jsp页面不会覆盖错误处理的默认视图，而应该使用自定义错误页面

当你使用上述模板引擎中的任何一个，它们默认的模板配置路径为：

src/main/resources/templates

。当然也可以修改这个路径，具体如何修改，可在后续各模板引擎的配置属性中查询并修改。

# Thymeleaf模板引擎 #

Thymeleaf是一款用于渲染XML/XHTML/HTML5内容的模板引擎。类似JSP，Velocity，FreeMaker等，它也可以轻易的与Spring MVC等Web框架进行集成作为Web应用的模板引擎。与其它模板引擎相比，Thymeleaf最大的特点是能够直接在浏览器中打开并正确显示模板页面，而不需要启动整个Web应用。它的功能特性如下：

*  Spring MVC中@Controller中的方法可以直接返回模板名称，接下来Thymeleaf模板引擎会自动进行渲染
 *  模板中的表达式支持Spring表达式语言（Spring EL)
 *  表单支持，并兼容Spring MVC的数据绑定与验证机制
 *  国际化支持

Spring官方也推荐使用Thymeleaf,所以本篇代码整合就使用Thymeleaf来整合。

# 引入依赖 #

![0_wx_fmt_jpeg 2][]请点击此处输入图片描述  
![0_wx_fmt_jpeg 3][]

如图所示，spring-boot-starter-thymeleaf会自动包含spring-boot-starter-web，所以我们就不需要单独引入web依赖了。

# 编写controller #

![0_wx_fmt_jpeg 4][]

# 编写html #

引入依赖后就在默认的模板路径

src/main/resources/templates

下编写模板文件即可完成。这里我们新建一个index.html:

![0_wx_fmt_jpeg 5][]

注：通过xmlns:th=”http://www.thymeleaf.org“ 命令空间，将静态页面转换为动态的视图，需要进行动态处理的元素将使用“th:”前缀。

ok,代码都写好了，让我们看对比下直接打开index.html和启动工程后访问http://localhost:8080/learn 看到的效果，Thymeleaf做到了不破坏HTML自身内容的数据逻辑分离。

![0_wx_fmt_jpeg 6][]

# Thymeleaf的默认参数配置 #

在application.properties中可以配置thymeleaf模板解析器属性

![0_wx_fmt_jpeg 7][]

# 整合一个bootstrap框架给大家 #

![0_wx_fmt_jpeg 8][]

大家可以直接打开vanilla-cream-css下面的index.html来查看静态效果，如下：

![0_wx_fmt_jpeg 9][]

动态效果的话可以查看template.html

这里把上面的资源例子重新用bootstrap写了下，效果不错哦，如下：

![0_wx_fmt_jpeg 10][]

原博地址:[https://www.cnblogs.com/zheting/p/6707037.html][https_www.cnblogs.com_zheting_p_6707037.html]

[0_wx_fmt_jpeg]: /images/20220514/52254e534a9d4f7ab6166d58e476846f.png
[0_wx_fmt_jpeg 1]: /images/20220514/fa9a7407d1574455ae900037ff60ff80.png
[0_wx_fmt_jpeg 2]: /images/20220514/5260150cdb54490899025235c90d25b2.png
[0_wx_fmt_jpeg 3]: /images/20220514/e52ef1fba76147bb86cee91f6f8cb1da.png
[0_wx_fmt_jpeg 4]: /images/20220514/f227dd9d0a32427ab75ce9d84b9b1a6e.png
[0_wx_fmt_jpeg 5]: /images/20220514/2ebe3ee344b3496f854d9b439c6f77e5.png
[0_wx_fmt_jpeg 6]: /images/20220514/dbf30bd3377b4865a74c9267858c43c6.png
[0_wx_fmt_jpeg 7]: /images/20220514/161d43299ec340cbbea3f486788990e8.png
[0_wx_fmt_jpeg 8]: /images/20220514/72ceba0c637747d0bd9d9d8f9eb70c93.png
[0_wx_fmt_jpeg 9]: /images/20220514/ad75606d350646e78dbb62d30dc90f89.png
[0_wx_fmt_jpeg 10]: /images/20220514/f147401cb5ab4e2191f547b43189a280.png
[https_www.cnblogs.com_zheting_p_6707037.html]: https://www.cnblogs.com/zheting/p/6707037.html