Java开发工程师详解Thymeleaf - 编程导航 | 一线开发者编程经验和技术实战分享

Thymeleaf 是一个用于 Web 和独立环境的现代服务器端 Java 模板引擎。它能够处理 HTML、XML、JavaScript、CSS 甚至纯文本。Thymeleaf 的主要目标是提供一种优雅且高度可维护的模板创建方式。为了实现这一点，它以自然模板的概念为基础，将模板文件作为原型注入到设计过程中，从而提高了设计的沟通能力，并缩小了开发团队和设计团队之间的差距。

1. Thymeleaf 的特点

自然模板：Thymeleaf 允许你在 HTML 模板中直接使用静态原型，这些原型可以在浏览器中直接打开和显示，而不需要启动服务器。这使得设计师和开发人员可以更容易地协作。
强大的表达式语言：Thymeleaf 使用 Spring EL（表达式语言）来访问和操作数据模型中的对象。这使得在模板中处理数据变得非常灵活和强大。
与 Spring 框架的深度集成：Thymeleaf 与 Spring 框架（特别是 Spring MVC）集成得非常好，可以无缝地与 Spring 的各种功能（如国际化、表单处理等）结合使用。
模块化：Thymeleaf 是模块化的，允许你根据需要选择使用哪些功能。例如，你可以选择只使用 Thymeleaf 的 HTML 模块，或者同时使用 XML、JavaScript 等模块。
可扩展性：Thymeleaf 提供了丰富的扩展点，允许你自定义模板引擎的行为，例如自定义方言、处理器等。

2. Thymeleaf 的基本用法

2.1 引入 Thymeleaf

如果你使用的是 Maven 项目，可以在 pom.xml 中添加以下依赖：

▼
xml
复制代码
<dependency>
    <groupId>org.thymeleaf</groupId>
    <artifactId>thymeleaf</artifactId>
    <version>3.0.12.RELEASE</version>
</dependency>

如果你使用的是 Spring Boot，可以直接引入 spring-boot-starter-thymeleaf：

▼
xml
复制代码
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

2.2 创建一个简单的 Thymeleaf 模板

假设你有一个简单的 Spring MVC 控制器：

▼
java
复制代码
@Controller
public class HelloController {

    @GetMapping("/hello")
    public String hello(Model model) {
        model.addAttribute("message", "Hello, Thymeleaf!");
        return "hello";
    }
}

在 src/main/resources/templates 目录下创建一个 hello.html 文件：

▼
html
复制代码
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>Hello Thymeleaf</title>
</head>
<body>
    <h1 th:text="${message}">Default Message</h1>
</body>
</html>

在这个模板中，th:text 是 Thymeleaf 的一个属性，用于替换标签的内容。${message} 是一个表达式，用于从模型中获取 message 属性的值。

2.3 运行项目

当你访问 /hello 路径时，Spring MVC 会调用 HelloController 的 hello 方法，并将 message 属性添加到模型中。Thymeleaf 会处理 hello.html 模板，并将 message 的值替换到 <h1> 标签中。

3. Thymeleaf 的常用功能

3.1 表达式

Thymeleaf 支持多种表达式：

变量表达式：${...} 用于访问模型中的变量。
选择表达式：*{...} 用于选择当前对象中的属性。
消息表达式：#{...} 用于国际化消息。
链接表达式：@{...} 用于生成 URL。
片段表达式：~{...} 用于引用模板片段。

3.2 条件判断

Thymeleaf 支持 th:if 和 th:unless 来进行条件判断：

▼
html
复制代码
<div th:if="${user.isAdmin}">
    <p>Welcome, Admin!</p>
</div>
<div th:unless="${user.isAdmin}">
    <p>Welcome, User!</p>
</div>

3.3 循环

Thymeleaf 支持 th:each 来进行循环：

▼
html
复制代码
<ul>
    <li th:each="user : ${users}" th:text="${user.name}">User Name</li>
</ul>

3.4 表单处理

Thymeleaf 提供了强大的表单处理功能，可以与 Spring MVC 的表单标签库无缝集成：

▼
html
复制代码
<form th:action="@{/save}" th:object="${user}" method="post">
    <input type="text" th:field="*{name}" />
    <input type="text" th:field="*{email}" />
    <button type="submit">Save</button>
</form>

3.5 片段和布局

Thymeleaf 支持模板片段和布局，可以通过 th:fragment 和 th:replace 来实现模板的复用：

▼
html
复制代码
<!-- fragments/header.html -->
<header th:fragment="header">
    <h1>My Website</h1>
</header>

<!-- main.html -->
<html>
<head>
    <title>Main Page</title>
</head>
<body>
    <div th:replace="~{fragments/header :: header}"></div>
    <p>Welcome to the main page!</p>
</body>
</html>

4. Thymeleaf 与 Spring Boot 的集成

Spring Boot 对 Thymeleaf 提供了自动配置支持。你只需要在 application.properties 或 application.yml 中进行一些简单的配置即可：

▼
properties
复制代码
spring.thymeleaf.prefix=classpath:/templates/
spring.thymeleaf.suffix=.html
spring.thymeleaf.cache=false  # 开发时建议关闭缓存

5. 总结

Thymeleaf 是一个功能强大且灵活的 Java 模板引擎，特别适合与 Spring 框架一起使用。它的自然模板特性使得前端设计和后端开发可以更好地协作，同时它的表达式语言和丰富的功能使得模板处理变得非常方便。如果你正在开发一个基于 Spring 的 Web 应用，Thymeleaf 是一个非常值得考虑的模板引擎选择。