Spring Boot开发（七）Thymeleaf模板引擎

最新推荐文章于 2024-07-22 08:30:00 发布

JD强子

最新推荐文章于 2024-07-22 08:30:00 发布

阅读量880

点赞数

本文链接：https://blog.csdn.net/m0_53698336/article/details/121327290

版权

本文介绍了Spring Boot中Thymeleaf模板引擎的使用，包括模板引擎的原理、Thymeleaf的特点、语法规则以及如何在Spring Boot项目中整合Thymeleaf，展示了变量输出、条件判断、迭代遍历等基本操作。

摘要由CSDN通过智能技术生成

模板引擎

我们知道，在web开发时，一般都会涉及到很多的静态资源，如js、image、css文件等。

正如REST web服务，你也可以使用Spring MVC提供动态HTML内容。Spring MVC支持各种各样的模板技术，包括Velocity, FreeMarker和JSPs，很多其他的模板引擎也提供它们自己的Spring MVC集成。

模板引擎的原理

模板引擎的作用都是将模板(页面)和数据进行整合然后输出显示

在这里插入图片描述
模板引擎的作用就是我们来写一个页面模板，比如有些值呢，是动态的，我们写一些表达式。而这些值，从哪来呢，就是我们在后台封装一些数据。然后把这个模板和这个数据交给我们模板引擎，模板引擎按照我们这个数据帮你把这表达式解析、填充到我们指定的位置，然后把这个数据最终生成一个我们想要的内容给我们写出去，这就是我们这个模板引擎，不管是jsp还是其他模板引擎，都是这个思想。只不过呢，就是说不同模板引擎之间，他们可能这个语法有点不一样。

使用嵌入式Servlet容器时，请避免使用JSP，因为使用JSP打包后会存在一些限制。

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

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

Spring Boot为以下的模板引擎提供自动配置支持：

FreeMarker
Groovy
Thymeleaf（官方推荐）
Velocity（1.4已不再支持）
Mustache

使用以上引擎中的任何一种，并采用默认配置，则模块会从src/main/resources/templates自动加载。当然也可以修改这个路径，具体如何修改，可在后续各模板引擎的配置属性中查询并修改。

Thymeleaf

Thymeleaf 是一款用于渲染 XML/XHTML/HTML5 内容的模板引擎。它与 JSP，Velocity，FreeMaker 等模板引擎类似，也可以轻易地与 Spring MVC 等 Web 框架集成。与其它模板引擎相比，Thymeleaf 最大的特点是，即使不启动 Web 应用，也可以直接在浏览器中打开并正确显示模板页面。

简介

Thymeleaf 是新一代 Java 模板引擎，与 Velocity、FreeMarker 等传统 Java 模板引擎不同，Thymeleaf 支持 HTML 原型，其文件后缀为“.html”，因此它可以直接被浏览器打开，此时浏览器会忽略未定义的 Thymeleaf 标签属性，展示 thymeleaf 模板的静态页面效果；当通过 Web 应用程序访问时，Thymeleaf 会动态地替换掉静态内容，使页面动态显示。

Thymeleaf 通过在 html 标签中，增加额外属性来达到“模板+数据”的展示方式，示例代码如下。

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<!--th:text 为 Thymeleaf 属性，用于在展示文本-->
<h1 th:text="迎您来到Thymeleaf">欢迎您访问静态页面 HTML</h1>
</body>
</html>

注意以下几点：

模板文件必须放在/resources/templates目录下，否则无法渲染
Thymeleaf标签都是以th开头的
IntelliJ IDEA根据你运行应用的方式会对classpath进行不同的排序。在IDE里通过main方法运行应用，跟从Maven，或Gradle，或打包好的jar中运行相比会导致不同的顺序，这可能导致Spring Boot不能从classpath下成功地找到模板。如果遇到这个问题，你可以在IDE里重新对classpath进行排序，将模块的类和资源放到第一位。或者，你可以配置模块的前缀为classpath*:/templates/，这样会查找classpath下的所有模板目录。

在这里插入图片描述