1.Thymeleaf概述
SpringBoot并不推荐使用jsp,但是支持一些模板引擎技术:Freemarker、Thymeleaf、Mustache。
简单说, Thymeleaf 是一个跟 Velocity、FreeMarker 类似的模板引擎,它可以完全替代 JSP 。相较于其他的模板引擎,它有如下四个极吸引人的特点:
- 动静结合:Thymeleaf 在有网络和无网络的环境下皆可运行,即它可以让美工在浏览器查看页面的静态效果,也可以让程序员在服务器查看带数据的动态页面效果。这是由于它支持 html 原型,然后在 html 标签里增加额外的属性来达到模板+数据的展示方式。浏览器解释 html 时会忽略未定义的标签属性,所以 thymeleaf 的模板可以静态地运行;当有数据返回到页面时,Thymeleaf 标签会动态地替换掉静态内容,使页面动态显示。
- 开箱即用:它提供标准和spring标准两种方言,可以直接套用模板实现JSTL、 OGNL表达式效果,避免每天套模板、改jstl、改标签的困扰。同时开发人员也可以扩展和创建自定义的方言。
- 多方言支持:Thymeleaf 提供spring标准方言和一个与 SpringMVC 完美集成的可选模块,可以快速的实现表单绑定、属性编辑器、国际化等功能。
- 与SpringBoot完美整合,SpringBoot提供了Thymeleaf的默认配置,并且为Thymeleaf设置了视图解析器,我们可以像以前操作jsp一样来操作Thymeleaf。代码几乎没有任何区别,就是在模板语法上有区别。
2.Thymeleaf快速入门
(1)引入Thymeleaf的依赖
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-thymeleaf</artifactId> </dependency>
(2)编写一个controller方法,返回一些用户数据,放入模型中,将来在页面渲染
package lucky.controller; import lucky.domain.Users; import lucky.service.UsersService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Controller; import org.springframework.ui.Model; import org.springframework.web.bind.annotation.PathVariable; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestParam; import org.springframework.web.bind.annotation.ResponseBody; import java.util.List; @Controller @RequestMapping(path = "/users") public class UsersController { @Autowired private UsersService usersService; @RequestMapping(path = "/query") @ResponseBody public String queryUsers(){ return "hello users"; } @RequestMapping(path = "/queryUsersById") @ResponseBody public Users queryUsersById(@RequestParam("id") Integer id){ return this.usersService.queryUsersById(id); } /** * 查询所有用户,并在前端显示 * @param model model对象用来向前端传递数据 * @return 返回视图名称 */ @RequestMapping(path = "/queryAllUsers") public String queryAllUsers(Model model){ //1.查询所有用户 List<Users> users = this.usersService.queryAllUsers(); //2.放入模型 model.addAttribute("users",users); //3.返回模板名称(就是classpath:/templates/目录下的html文件名) return "users"; } }
(3)静态页面
Thymeleaf会根据前缀和后缀来确定模板文件的位置。分析源码可得:
- 默认前缀:classpath:/templates/
- 默认后缀:.html
根据上面的源码分析,模板默认放在classpath下的templates文件夹,我们新建一个html文件放入其中:
编写html模板,渲染模型中的数据:
注意,把html 的名称空间,改成:xmlns:th="http://www.thymeleaf.org"会有语法提示
我们看到这里使用了以下语法:
<!DOCTYPE html> <html xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>首页</title> <style type="text/css"> table {border-collapse: collapse; font-size: 14px; width: 80%; margin: auto} table, th, td {border: 1px solid darkslategray;padding: 10px} </style> </head> <body> <div style="text-align: center"> <span style="color: darkslategray; font-size: 30px">欢迎光临!</span> <hr/> <table class="list"> <tr> <th>id</th> <th>姓名</th> <th>密码</th> <th>中文名</th> </tr> <tr th:each="user : ${users}"> <td th:text="${user.id}">1</td> <td th:text="${user.name}">张三</td> <td th:text="${user.password}">lucky</td> <td th:text="${user.name}">zhangsan</td> </tr> </table> </div> </body> </html>
我们看到这里使用了以下语法:
- ${}:这个类似与el表达式,但其实是ognl的语法,比el表达式更加强大
- th-指令:th-是利用了Html5中的自定义属性来实现的。如果不支持H5,可以用`data-th-`来代替
- th:each:类似于c:foreach遍历集合,但是语法更加简洁
- th:text:声明标签中的文本
- 例如<td th-text='${user.id}'>1</td>,如果user.id有值,会覆盖默认的1
- 如果没有值,则会显示td中默认的1。这正是thymeleaf能够动静结合的原因,模板解析失败不影响页面的显示效果,因为会显示默认值!
3.效果图