依赖导入
在 Spring Boot 中使用 thymeleaf 模板需要引入依赖,可以在创建项目工程时勾选 Thymeleaf,也可以
创建之后再手动导入,如下:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
另外,在 html 页面上如果要使用 thymeleaf 模板,需要在页面标签中引入:
<html xmlns:th="http://www.thymeleaf.org">
Thymeleaf相关配置
因为 Thymeleaf 中已经有默认的配置了,我们不需要再对其做过多的配置,有一个需要注意一下,
Thymeleaf 默认是开启页面缓存的,所以在开发的时候,需要关闭这个页面缓存,配置如下。
spring:
thymeleaf:
cache: false #关闭缓存
否则会有缓存,导致页面没法及时看到更新后的效果。 比如你修改了一个文件,已经 update 到
tomcat 了,但刷新页面还是之前的页面,就是因为缓存引起的。
Thymeleaf 的使用
这个和 Thymeleaf 没啥关系,应该说是通用的,我把它一并写到这里的原因是一般我们做网站的时
候,都会做一个 404 页面和 500 页面,为了出错时给用户一个友好的展示,而不至于一堆异常信息抛
出来。Spring Boot 中会自动识别模板目录(templates/)下的 404.html 和 500.html 文件。我们在
templates/ 目录下新建一个 error 文件夹,专门放置错误的 html 页面,然后分别打印些信息。以
404.html 为例:
<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8">
<title>Title</title>
</head>
<body>这是404页面 </body>
</html>
我们再写一个 controller 来测试一下 404 和 500 页面:
@Controller
@RequestMapping("/thymeleaf")
public class ThymeleafController {
@RequestMapping("/test404")
public String test404() {
return "index";
}
@RequestMapping("/test500")
public String test500() {
int i = 1 / 0; return "index";
}
}
当我们在浏览器中输入 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
<form action="" th:each="blogger : ${list}" >
用户编号:<input name="id" th:value="${blogger.id}"/><br>
用户姓名:<input type="text" name="password" th:value="${blogger.name}"/><br>
登录密码:<input type="text" name="username" th:value="${blogger.getPass()}"/>
</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 | 地址引入 | |
th:action | 表单提交的地址 |
Thymeleaf 还有很多其他用法,这里就不总结了,具体的可以参考Thymeleaf的官方文档(v3.0)。主
要要学会如何在 Spring Boot 中去使用 thymeleaf,遇到对应的标签或者方法,查阅官方文档即可