Thymeleaf教程：深入解析标准表达式语法

引言

Thymeleaf作为一款现代化的Java模板引擎，其标准表达式语法是开发者必须掌握的核心内容。本文将全面剖析Thymeleaf的标准表达式体系，帮助开发者高效构建动态Web页面。

表达式概览

Thymeleaf标准表达式主要分为以下几类：

1. 基础表达式类型：

   • 变量表达式：${...}
   • 选择表达式：*{...}
   • 消息表达式：#{...}
   • 链接表达式：@{...}
   • 分段表达式：~{...}

2. 操作符支持：

   • 文本操作
   • 算术运算
   • 布尔逻辑
   • 比较运算
   • 条件判断

变量表达式详解

变量表达式是Thymeleaf中最常用的表达式类型，用于访问模板上下文中的变量：

<p th:text="${user.name}">用户名</p>

表达式解析机制

Thymeleaf支持两种表达式解析引擎：

• OGNL（默认）
• SpringEL（集成Spring时）

表达式解析示例：

${book.author.name} 
<!-- 等价于 -->
((Book)context.getVariable("book")).getAuthor().getName()

特殊表达式对象

Thymeleaf提供了一系列内置对象：

对象	说明
#ctx	上下文对象
#vars	上下文变量
#locale	区域设置
#request	HttpServletRequest
#response	HttpServletResponse

使用示例：

<span th:text="${#locale.country}">国家</span>

消息表达式（国际化）

消息表达式用于实现国际化文本输出：

# messages.properties
welcome.message=欢迎您，{0}！

模板中使用：

<p th:text="#{welcome.message(${user.name})}">欢迎文本</p>

选择表达式

选择表达式与变量表达式类似，但作用于特定对象：

<div th:object="${user}">
  <p th:text="*{name}">姓名</p>
  <p th:text="*{age}">年龄</p>
</div>

链接表达式

链接表达式用于构建URL，支持多种形式：

1. 相对路径：

<a th:href="@{/order/list}">订单列表</a>

2. 带参数：

<a th:href="@{/order/details(id=${orderId})}">订单详情</a>

3. 绝对路径：

<a th:href="@{http://example.com}">外部链接</a>

分段表达式

分段表达式用于模板片段的复用：

<div th:insert="~{common :: header}"></div>

字面量与操作符

基本字面量

1. 文本字面量：

<span th:text="'Hello World'">默认文本</span>

2. 数字字面量：

<span th:text="2023">年份</span>

3. 布尔字面量：

<div th:if="${user.active} == false">非活跃用户</div>

文本操作

1. 字符串拼接：

<span th:text="'用户：' + ${user.name}"></span>

2. 字面量替换：

<span th:text="|欢迎，${user.name}|"></span>

运算符

算术运算

<p th:text="${count} + 1">计数</p>

比较运算

<div th:if="${age} gt 18">成年人</div>

条件运算

1. 三元运算：

<span th:text="${user.vip} ? 'VIP用户' : '普通用户'"></span>

2. Elvis运算符：

<span th:text="${user.name} ?: '匿名用户'"></span>

数据转换

Thymeleaf支持数据格式化：

<td th:text="${{user.birthDate}}">生日</td>

双大括号语法会调用注册的转换服务进行格式化输出。

表达式预处理

预处理允许动态确定表达式：

<p th:text="#{msg.__${lang}__}">国际化消息</p>

最佳实践

1. 保持表达式简洁：避免在模板中编写复杂逻辑
2. 合理使用工具对象：如#dates、#strings等
3. 注意HTML转义：确保动态内容的安全性
4. 优先使用字面量替换：提高模板可读性

总结

Thymeleaf的标准表达式语法提供了强大的模板处理能力，从简单的变量输出到复杂的条件逻辑都能优雅处理。掌握这些表达式类型及其组合使用方式，是开发高效、可维护Thymeleaf模板的关键。通过本文的系统讲解，开发者应能全面理解并灵活运用Thymeleaf的各种表达式语法。