依赖导入

在 Spring Boot 中使用 thymeleaf 模板需要引入依赖,可以在创建项目工程时勾选 Thymeleaf,也可以
创建之后再手动导入,如下:

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

另外,在 html 页面上如果要使用 thymeleaf 模板,需要在页面标签中引入:

  1. <html xmlns:th="http://www.thymeleaf.org">

Thymeleaf相关配置

因为 Thymeleaf 中已经有默认的配置了,我们不需要再对其做过多的配置,有一个需要注意一下,
Thymeleaf 默认是开启页面缓存的,所以在开发的时候,需要关闭这个页面缓存,配置如下。

  1. spring:
  2. thymeleaf:
  3. cache: false #关闭缓存

否则会有缓存,导致页面没法及时看到更新后的效果。 比如你修改了一个文件,已经 update 到
tomcat 了,但刷新页面还是之前的页面,就是因为缓存引起的。

Thymeleaf 的使用

这个和 Thymeleaf 没啥关系,应该说是通用的,我把它一并写到这里的原因是一般我们做网站的时
候,都会做一个 404 页面和 500 页面,为了出错时给用户一个友好的展示,而不至于一堆异常信息抛
出来。Spring Boot 中会自动识别模板目录(templates/)下的 404.html 和 500.html 文件。我们在
templates/ 目录下新建一个 error 文件夹,专门放置错误的 html 页面,然后分别打印些信息。以
404.html 为例:

  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head><meta charset="UTF-8">
  4. <title>Title</title>
  5. </head>
  6. <body>这是404页面 </body>
  7. </html>

我们再写一个 controller 来测试一下 404 和 500 页面:

  1. @Controller
  2. @RequestMapping("/thymeleaf")
  3. public class ThymeleafController {
  4. @RequestMapping("/test404")
  5. public String test404() {
  6. return "index";
  7. }
  8. @RequestMapping("/test500")
  9. public String test500() {
  10. int i = 1 / 0; return "index";
  11. }
  12. }

当我们在浏览器中输入 localhost:8080/thymeleaf/test400 时,故意输入错误,找不到对应 的方法,就会跳转到 404.html 显示。 当我们在浏览器中输入 localhost:8088/thymeleaf/test505 时,会抛出异常,然后会自动跳 转到 500.html 显示。

【注】这里有个问题需要注意一下,前面的课程中我们说了微服务中会走向前后端分离,我们在
Controller 层上都是使用的 @RestController 注解,自动会把返回的数据转成 json 格式。但是在使
用模板引擎时,Controller 层就不能用 @RestController 注解了,因为在使用 thymeleaf 模板时,返
回的是视图文件名,比如上面的 Controller 中是返回到 index.html 页面,如果使用
@RestController 的话,会把 index 当作 String 解析了,直接返回到页面了,而不是去找
index.html 页面,大家可以试一下。所以在使用模板时要用 @Controller 注解。

Thymeleaf 中处理对象

在 thymeleaf 模板中,使用 th:object=”${}” 来获取对象信息,然后在表单里面可以有三
种方式来获取对象属性。如下:

使用 th:value=”*{属性名}” 使用 th:value=”${对象.属性名}” ,对象指的是上面使用 th:object 获取的对象使用 th:value=”${对象.get方法}” ,对象指的是上面使用 th:object 获取的对象

Thymeleaf 中处理 List

  1. <form action="" th:each="blogger : ${list}" >
  2. 用户编号:<input name="id" th:value="${blogger.id}"/><br>
  3. 用户姓名:<input type="text" name="password" th:value="${blogger.name}"/><br>
  4. 登录密码:<input type="text" name="username" th:value="${blogger.getPass()}"/>
  5. </form>

可以看出,其实和处理单个对象信息差不多,Thymeleaf 使用 th:each 进行遍历,${} 取 model 中
传过来的参数,然后自定义 list 中取出来的每个对象,这里定义为 blogger。表单里面可以直接使用
${对象.属性名}``来获取 list 中对象的属性值,也可以使用 ${对象.get方法} 来获取,这点和上面处理<br />对象信息是一样的,但是不能使用*{属性名} 来获取对象中的属性,thymeleaf `模板获取不到。

其他常用 thymeleaf 操作

标签 功能 例子
th:value 给属性赋
th:style 设置样式 th:style=”‘display:’+@{(${sitrue}?’none’:’inline-block’)} +’’”
th:onclick 点击事件 th:onclick=”‘getInfo()’”
th:if 条件判断
th:href 超链接 Login />
th:unless 条件判断和th:if 相反 null}>Login
th:switch 配合th:case
th:case 配合th:switch

administator

th:src 地址引入 csdn logo
th:action 表单提交的地址

Thymeleaf 还有很多其他用法,这里就不总结了,具体的可以参考Thymeleaf的官方文档(v3.0)。主
要要学会如何在 Spring Boot 中去使用 thymeleaf,遇到对应的标签或者方法,查阅官方文档即可