前面章节我们介绍了SpringBoot集成jsp和Freemarker以及它们的具体应用。而在这些前端模板引擎中,SpringBoot首推使用Thymeleaf。这是因为Thymeleaf对SpringMVC提供了完美的支持。

Thymeleaf同样是一个Java类库,能够处理HTML/HTML5、XML、JavaScript、CSS,甚⾄纯⽂本。通常可以用作MVC中的View层,它可以完全替代JSP。

  • Thymeleaf不仅可以作为模板存在,同时也支持HTML原型。通过在HTML标签里增加额外的属性来达到模板+数据的展示方式。浏览器解释HTML时会忽略未定义的标签属性,所以可直接通过浏览器打开;当有数据返回到页面时,Thymeleaf标签会动态地替换掉静态内容,使页面动态显示。
  • Thymeleaf开箱即用的特性。它支持标准方言和Spring方言,可以直接套用模板实现JSTL、OGNL表达式效果,避免重复套模板、改JSTL、改标签的困扰。同时开发人员也可以扩展和创建自定义的方言。
  • Thymeleaf提供Spring标准方言和一个与SpringMVC完美集成的可选模块,可以快速地实现表单绑定、属性编辑器、国际化等功能。

与其他模板引擎相比,Thymeleaf不会破坏文档结构。对比Freemarker可以看出效果:

  1. FreeMarker: <p>${message}</p>
  2. Thymeleaf: <p th:text="${message}">Hello World!</p>

注意,由于Thymeleaf使用了XML DOM解析器,因此它并不适合于处理大规模的XML文件。

SpringBoot中创建项目并集成Thymeleaf。创建过程中勾选对应集成框架。

Thymeleaf

项目创建之后,pom中对应的核心依赖如下:

  1. <dependency>
  2. <groupId>org.springframework.boot</groupId>
  3. <artifactId>spring-boot-starter-thymeleaf</artifactId>
  4. </dependency>
  5. <dependency>
  6. <groupId>org.springframework.boot</groupId>
  7. <artifactId>spring-boot-starter-web</artifactId>
  8. </dependency>
  9. <dependency>
  10. <groupId>org.projectlombok</groupId>
  11. <artifactId>lombok</artifactId>
  12. <optional>true</optional>
  13. </dependency>
  14. </dependency>

实体类Student:

  1. @Data
  2. public class Student {
  3. private String idNo;
  4. private String name;
  5. }

Controller对应实现:

  1. @Controller
  2. public class StudentController {
  3. @GetMapping("/")
  4. public String getStudents(Model model){
  5. List<Student> list = new ArrayList<>();
  6. Student s1 = new Student();
  7. s1.setIdNo("N01");
  8. s1.setName("Tom");
  9. list.add(s1);
  10. Student s2 = new Student();
  11. s2.setIdNo("N02");
  12. s2.setName("David");
  13. list.add(s2);
  14. model.addAttribute("students",list);
  15. model.addAttribute("hello","Hello Thymeleaf!");
  16. return "student";
  17. }
  18. }

在Controller中实现了两个参数的返回一个为字符串,一个为Student的列表。

对应templates下的页面为student.html。Thymeleaf默认使用html作为后缀。

student.html页面展示信息如下:

  1. <!DOCTYPE html>
  2. <html lang="en" xmlns:th="http://www.thymeleaf.org">
  3. <head>
  4. <meta charset="UTF-8"/>
  5. <title>Hello Thymeleaf</title>
  6. </head>
  7. <body>
  8. <h1 th:text="${hello}">Hello World</h1>
  9. <div th:each="student : ${students}">
  10. <p th:text="${student.name} + ':' + ${student.idNo}"></p>
  11. </div>
  12. </body>
  13. </html>

其中第一个为直接展示字符串,第二个为遍历列表并展示其中的属性值。

访问对应请求http://localhost:8080/,即可返内容展示。

Thymeleaf

如果是在开发环境中,最好在application.properties中添加配置:

  1. spring.thymeleaf.cache=false

关闭Thymeleaf的缓存(默认为true),避免因缓存导致修改需重启才能生效,生产环境可采用默认值。

使用Thymeleaf的页面必须在HTML标签中作如下声明,表示使用Thymeleaf语法:

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

SpringBoot中提供了大量关于Thymeleaf的配置项目:

  1. # 开启模板缓存(默认值:true)
  2. spring.thymeleaf.cache=true
  3. # 检查模板是否存在
  4. spring.thymeleaf.check-template=true
  5. # 检查模板位置是否正确(默认值:true)
  6. spring.thymeleaf.check-template-location=true
  7. # Content-Type的值(默认值:text/html)
  8. spring.thymeleaf.content-type=text/html
  9. # 开启MVC Thymeleaf视图解析(默认值:true)
  10. spring.thymeleaf.enabled=true
  11. # 模板编码
  12. spring.thymeleaf.encoding=UTF-8
  13. # 排除视图名称列表,用逗号分隔
  14. spring.thymeleaf.excluded-view-names=
  15. # 模板模式,设置为HTML5会严格校验,不符合规则将报错
  16. spring.thymeleaf.mode=HTML5
  17. # 视图名称前缀(默认值:classpath:/templates/)
  18. spring.thymeleaf.prefix=classpath:/templates/
  19. # 视图名称后缀(默认值:.html)
  20. spring.thymeleaf.suffix=.html
  21. # 可解析的视图名称列表,用逗号分隔
  22. spring.thymeleaf.view-names=

关于SpringBoot集成Thymeleaf的操作已经完成,非常简单。

程序新视界:精彩和成长都不容错过

程序新视界-微信公众号

版权声明:本文为secbro原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://www.cnblogs.com/secbro/p/12194210.html