🌟 Thymeleaf 的背景与发展
Thymeleaf 是一种现代的服务器端模板引擎，由 Daniel Fernández 和 David Hernández 于 2010 年创建。它最初是为了弥补传统 JSP 技术的不足而设计的。随着 Java Web 开发的不断发展，Thymeleaf 凭借其静态原型化、HTML5 兼容性和强大的表达式语言，逐渐成为许多开发者首选的模板引擎。
为什么选择 Thymeleaf？
静态预览：Thymeleaf 模板可以直接在浏览器中打开并预览，无需启动服务器。
HTML5 标准兼容：生成的内容符合 W3C 规范，便于前端开发人员直接操作。
灵活的表达式语言：支持变量、条件、循环、集合操作等复杂逻辑。
多场景支持：除了 HTML，还支持 XML、JavaScript、CSS 等多种文本内容。
良好的社区支持：Thymeleaf 拥有活跃的开源社区，提供了丰富的插件和扩展功能。
🌟 Thymeleaf 的核心机制
Thymeleaf 的工作原理可以分为以下几个步骤：
解析模板：读取 HTML 文件并识别 th: 属性。
执行表达式：根据模板中的表达式（如 ${...}）从模型中获取数据。
生成动态内容：将表达式结果插入到模板中，生成最终的 HTML 页面。
输出结果：将动态页面返回给客户端。
🌟 Thymeleaf 的核心概念详解
1. 模板属性
Thymeleaf 使用 th: 前缀定义模板属性，常见的属性包括：
th:text：设置元素的文本内容。
th:if 和 th:unless：用于条件判断。
th:each：用于循环遍历列表或集合。
th:href 和 th:src：用于动态生成链接或资源路径。
th:fragment：定义可复用的模板片段。
2. 表达式语言
Thymeleaf 提供了多种表达式类型，用于动态生成内容：
变量表达式：${...}，访问模型中的变量。
选择表达式：*{...}，访问对象的属性。
消息表达式：#{...}，用于国际化支持。
链接表达式：@{...}，生成动态 URL。
文字替换表达式：|...|，用于拼接字符串。
3. 模板片段
模板片段是 Thymeleaf 的一大亮点，允许开发者将常用的部分提取出来复用，避免重复代码。
🌟 从零开始：快速上手 Thymeleaf
1. 环境搭建
确保你的项目是一个基于 Spring Boot 的 Java Web 项目。如果尚未创建，请参考以下步骤：
创建一个 Maven 或 Gradle 项目。
添加 Thymeleaf 和 Spring Boot Web 依赖。
Maven 配置示例：
Gradle 配置示例：
dependencies {
implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
implementation 'org.springframework.boot:spring-boot-starter-web'
}
2. 创建控制器
创建一个简单的 Spring MVC 控制器，返回 Thymeleaf 模板：
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
@Controller
public class HelloController {
@GetMapping("/hello")
public String hello(Model model) {
// 向模型中添加数据
model.addAttribute("name", "Alice");
model.addAttribute("greeting", "Welcome to Thymeleaf!");
return "index"; // 返回模板名称
}
}
3. 创建模板文件
在 src/main/resources/templates/ 目录下创建 index.html 文件：
Hello, !
启动应用后，访问 /hello 路径，你将看到动态生成的页面。
🌟 进阶功能详解
1. 条件判断
Thymeleaf 提供了多种条件判断方式，适用于不同的场景：
使用 th:if 判断是否显示某个元素：
Admin Panel
使用 th:unless 判断是否隐藏某个元素：
Welcome, registered user!
结合布尔运算符：
Access Granted
2. 循环遍历
通过 th:each 遍历列表或集合，支持索引变量和状态信息：
还可以结合索引变量：
-
th:text="'Item #' + ${iterStat.index} + ': ' + ${item.name}">
3. 国际化支持
Thymeleaf 支持多语言切换，通过 #messages 表达式实现：
创建 messages.properties 文件：
welcome.message=Hello, {0}!
创建多语言版本文件（如 messages_fr.properties）：
welcome.message=Bonjour, {0}!
在模板中使用：
4. 模板片段
模板片段是 Thymeleaf 的一大亮点，用于复用代码块：
定义片段：
Website Header
引入片段：
或者内联引入：
5. 动态 URL
使用 @{...} 表达式生成动态 URL：
🌟 高级功能：数据绑定与表单处理
1. 数据绑定
Thymeleaf 支持双向数据绑定，适用于表单提交场景：
2. 错误提示
结合 Spring Validation 实现表单验证和错误提示：
🌟 性能优化与最佳实践
1. 缓存机制
Thymeleaf 默认会对模板进行缓存，以提高渲染性能。在开发阶段可以通过配置禁用缓存：
spring.thymeleaf.cache=false
2. 分离逻辑与视图
将业务逻辑放在后端，仅在模板中处理展示逻辑。避免在模板中编写复杂的计算或逻辑。
3. 保持模板简洁
不要在模板中嵌套过多层级或复杂逻辑。如果模板变得复杂，考虑将其拆分为多个片段。
4. 充分利用工具
使用 IDE 插件（如 IntelliJ IDEA 的 Thymeleaf 插件）可以提供语法高亮、自动补全等功能，提升开发效率。
🌟 实际应用场景
1. 邮件模板
Thymeleaf 可用于生成动态邮件内容，支持 HTML 和纯文本格式：
Context context = new Context();
context.setVariable("username", "Alice");
String emailContent = templateEngine.process("email-template", context);
2. PDF 生成
结合 Thymeleaf 和 iText 或 Flying Saucer 库，可以生成动态 PDF 文档：
ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
ITextRenderer renderer = new ITextRenderer();
renderer.setDocumentFromString(thymeleafTemplateProcessor.process("pdf-template", context));
renderer.layout();
renderer.createPDF(outputStream);
3. 报表系统
Thymeleaf 可用于生成动态报表，支持表格、图表等内容的渲染。
🌟 常见问题与解决方案
1. 模板无法加载
原因：可能是模板文件未放置在正确目录下。
解决方法：确保模板文件位于 src/main/resources/templates/ 目录中。
2. 表达式无效
原因：可能是模型中缺少对应变量。
解决方法：检查控制器中是否正确添加了模型属性。
3. 国际化不生效
原因：可能是未正确配置 LocaleResolver。
解决方法：确保在 Spring 配置中添加了 LocaleChangeInterceptor 和 CookieLocaleResolver。