当前位置：首页 > news >正文

Springboot怎么集成Thymeleaf模板引擎？

news 2025/12/31 16:24:32

Thymeleaf介绍

Thymeleaf，是一个XML/XHTML/HTML模板引擎，开源的java库，可以用于SpingMVC项目中，用于代替JSP、FreeMarker或者其他的模板引擎；页面与数据分离，提高了开发效率，让代码重用更容易。

Springboot集成Thymeleaf

文章示例环境配置信息

jdk版本:1.8
开发工具：Intellij iDEA 2020.1
springboot:2.3.9.RELEASE

依赖引入

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
<dependency><groupId>ognl</groupId><artifactId>ognl</artifactId><version>3.1.26</version>
</dependency>

配置文件

spring.thymeleaf.cache=false
spring.thymeleaf.suffix=.html
spring.thymeleaf.prefix=classpath:/templates/
spring.thymeleaf.servlet.content-type=text/html
spring.thymeleaf.encoding=utf-8
spring.messages.basename=i18n/messages

集成示例

thymeleaf的用法，其实和jsp、freemarker差不多，下面用一个示例实际看一下thymeleaf是怎么使用的；

1、定义一个ExampleController类，注意，这里使用@Controller注解标记ExampleController，不要使用@RestController；

2、controller层具体处理请求的方法内，增加一个形参org.springframework.ui.Model，用于携带后台的处理数据；

3、返回值的“index”，表示classpath下templates中，模板名称是index，后缀是.html的模板；

4、contoller层处理完后，携带后台处理数据，到达视图层进行数据的渲染。

@Controller
@RequestMapping("/example")
public class ExampleController {@GetMapping("/index")public String index(Model model) {model.addAttribute("userName", "fanfu");model.addAttribute("msg", "thymeleaf模板内容");return "index";}
}

这里注意一下，通过xmlns:th="http://www.thymeleaf.org"引入了thymeleaf命名空间，th:text用于处理html标签体的文本内容，但是html5不允许使用th:*这些非标准属性的，因此可以切换到thymeleaf的data-th-*方法，来替换th:*方法；因此可以这么理解th:*和data-th-*的用法是等效的，为了遵循标准的用法，这篇文章的所有示例都采用data-th-*的写法。

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head><meta charset="UTF-8"><title>测试</title>
</head>
<body><div>你好！<span data-th-text="${userName}"></span>！</div><div>这是一个<span data-th-text="${msg}"></span> 。</div>
</body>
</html>

Thymeleaf语法

表达式

thymeleaf内置了5种标准表达式，如下：

1、${...}：变量表达式，取出上下文环境中变量的值；

<p data-th-text="${username}"></p>

2、*{...}：选择变量表达式，取选择的对象的属性值；

<div data-th-object="${formObj}"><p data-th-text="*{title}"></p><p data-th-text="*{creator}"></p>
</div>

3、#{...}：消息表达式，使用文字消息的国际化；

<p data-th-text="#{welcome.message}"></p>
<p data-th-text="#{welcome.user.message(${formObj.creator})}"></p>

4、@{...}：链接表达式，用于表示各种超链接地址；

 <p data-th-text="@{http://localhost:8080/example/index(creator=${formObj.creator},status='1')}"></p>
<a data-th-href="@{url}" target="_blank">超链接</a>

5、~{...}：片段表达式，引用一段公共的代码片段；如下：“example”表示另外一个模板名字，里面是一些通用代码片段，可以使用这种方式引入到当前模板中；

<p data-th-text="~{example}"></p>

遍历

<p data-th-each="student:${students}" data-th-text="${student.name}"></p>

条件判断

条件判断语句有三种，分别是：th:if、th:unless、th:switch

th:if，如果表达式内容为真，则显示内容；

<p data-th-if="${userName!=null}">如果username不是null,我就会显示</p>

th:unless，如果表达式内容为假，则显示内容；

<p data-th-unless="${userName==null}">如果username不是null,我就会显示</p>

th:switch，为多路选择语句，需要搭配th:case来使用;

<div data-th-switch="${userName}"><p data-th-case="fanfu">凡夫贬夫，你好</p><p data-th-case="test">这是一个test</p>
</div>

Thymeleaf应用场景

Thymeleaf可以替代JSP来进行动态网页的开发，但是在前后端分离、前端组件更加丰富多元化的今天，依然采用JSP的模式，用Thymeleaf来替代JSP进行动态网页的开发，未免有些落后了，因此Thymeleaf就没有用武之地吗？当然不。Thymeleaf是模板引擎，不仅可以处理html模板，还可以处理xml、CSS等其他一些格式的模板文件。例如：输出一些有样式的制式文本，如通知公告、申请书、建议书等。

下面是一个具体的示例，student.html是一个学生成绩展示的模板，但是学生会有很多，成绩也不一样，但是如果需要用一个制式的格式来展示这些数据，可以这么做：

1、先拿到学生的成绩数据；

2、然后用编程式的方法，使用thymeleaf模板引擎，根据模板生成静态的带有样式且加载好数据的html网页代码；

3、通常成绩、通知这类信息，一旦形成，基本上是不会改了，因此拿到已经加载数据的html网页内容就可以直接渲染显示了；

@Test
public void test() throws IOException {//测试数据List<Student> students = this.students();String staticDir = ResourceUtils.getFile("classpath:static\\").getPath() + File.separator;String targetFilePath=staticDir+"/student-data.html";//thymeleaf引擎上下文环境Context context=new Context();//在thymeleaf引擎上下文环境中装载模板上要渲染的数据context.setVariable("students",students);File file = new File(targetFilePath);if (!file.exists()) {file.delete();}//定义thymeleaf模板打印输出流PrintWriter printWriter=new PrintWriter(file);//定义thymeleaf模板解析器FileTemplateResolver fileTemplateResolver = new FileTemplateResolver();//thymeleaf模板解析器解析内容的后缀fileTemplateResolver.setSuffix(".html");//thymeleaf模板解析器解析内容的前缀String tempDir = ResourceUtils.getFile("classpath:templates\\").getPath()+File.separator;fileTemplateResolver.setPrefix(tempDir);//定义//thymeleaf模板引擎TemplateEngine templateEngine = new TemplateEngine();//装载thymeleaf模板解析器templateEngine.setTemplateResolver(fileTemplateResolver);//执行thymeleaf模板引擎的模板解析能力，有三个参数，分别是模板名字（不包括后缀和前缀）、上下文环境、打印输出流templateEngine.process("student",context,printWriter);
}
public List<Student> students() {List<Student> students = new ArrayList<>();for (int i = 0; i < 10; i++) {Student student = new Student();student.setName("张三" + i);student.setScore(98);students.add(student);}return students;
}

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head><meta charset="UTF-8"/><title>学生信息</title>
</head>
<body>
<div><p><span data-th-text="姓名"></span>-----<span data-th-text="成绩"></span></p><p data-th-each="student:${students}"><span data-th-text="${student.name}"></span>-----<span data-th-text="${student.score}"></span></p>
</div>
</body>
</html>