1. Thymeleaf内置对象深度解析
作为Java生态中最流行的模板引擎之一，Thymeleaf提供了丰富的内置对象来简化模板开发。这些内置对象就像是模板中的"瑞士军刀"，能帮我们快速处理各种常见场景。今天我就结合自己五年的Thymeleaf使用经验，带大家系统梳理这些实用工具。
2. 核心内置对象详解
2.1 基础工具对象
#ctx是上下文对象的快捷访问方式，它包含了模板处理的所有上下文信息。实际开发中我常用它来获取模板模式：
html复制<div th:if="${#ctx.getTemplateMode() == 'HTML5'}">
当前是HTML5模式
</div>
#vars特别适合调试场景，可以快速查看所有可用变量：
html复制<pre th:text="${#vars}"></pre>
2.2 日期时间处理
#dates是我使用频率最高的工具之一。项目中最常见的日期格式化操作：
html复制<span th:text="${#dates.format(article.createTime, 'yyyy-MM-dd HH:mm')}"></span>
时区转换的实用技巧：
html复制<!-- 将UTC时间转换为上海时区 -->
<span th:text="${#dates.createNow().setTimeZone('Asia/Shanghai')}"></span>
2.3 字符串处理
#strings在表单验证时特别有用：
html复制<input th:class="${#strings.isEmpty(user.name)} ? 'error' : ''" />
字符串连接的高效写法：
html复制<span th:text="${#strings.concat('Hello ', user.name)}"></span>
3. 集合与数组工具
3.1 集合操作
#lists在处理分页数据时不可或缺：
html复制<div th:each="item : ${#lists.subList(dataList, 0, 10)}">
<!-- 只显示前10条 -->
</div>
集合判空的安全写法：
html复制<div th:if="${not #lists.isEmpty(comments)}">
共有<span th:text="${#lists.size(comments)}"></span>条评论
</div>
3.2 数组与集合转换
#arrays与集合的配合使用：
html复制<th:block th:with="idsArray=${#arrays.toArray(selectedIds)}">
<!-- 将List转为数组 -->
</th:block>
4. 对象与表达式工具
4.1 对象工具
#objects在避免NPE时特别有用：
html复制<span th:text="${#objects.nullSafe(user.address.city, '未知')}"></span>
4.2 表达式工具
#execInfo在调试模板时很有帮助：
html复制<div th:if="${#execInfo.getTemplateName() == 'index'}">
当前是首页模板
</div>
5. 实战技巧与避坑指南
5.1 性能优化建议
- 避免在循环中频繁调用
#dates.format，建议预处理日期格式 - 集合操作优先使用
#lists而非直接调用集合方法，更安全 - 复杂表达式建议使用
th:with预先计算
5.2 常见问题排查
问题1：日期格式化不生效
- 检查时区设置
- 确认日期对象非null
- 格式字符串需用单引号包裹
问题2：集合操作报空指针
- 使用
#objects.nullSafe包装 - 优先使用
#lists.isEmpty判空 - 考虑启用Thymeleaf的null检查模式
6. 高级用法扩展
6.1 自定义工具对象
在Spring Boot中扩展工具对象：
java复制@Configuration
public class ThymeleafConfig {
@Bean
public SomeDialect someDialect() {
return new SomeDialect();
}
}
6.2 与Spring Security集成
结合security方言使用：
html复制<div sec:authorize="hasRole('ADMIN')">
管理员可见内容
</div>
在实际项目中，我发现合理使用这些内置对象能使模板代码更简洁、更安全。特别是在处理国际化和日期格式时，内置工具能节省大量开发时间。建议新手开发者先掌握#dates、#strings和#lists这三个最常用的工具对象，再逐步学习其他功能。