Thymeleaf th:object核心用法精解

一、核心功能

<div th:object="${user}">  <!-- 区域内使用 *{属性} 访问对象 --><span th:text="*{name}"></span> 
</div>

1. ​​作用机制​​

   • 创建局部上下文：th:object="${user}" 绑定对象到当前元素及其子元素
   • 替代重复写法：*{field} ≡ ${user.field}

2. ​​语法对比​​

   场景	传统写法	th:object 写法
   显示属性	${user.name}	*{name}
   表单绑定	th:field="${user.email}"	th:field="*{email}"
   嵌套对象	${user.address.city}	*{address.city}
   方法调用	${user.getAge()}	*{getAge()}

二、最佳应用场景

1. 表单数据绑定（最常用）

<form th:object="${user}"><input th:field="*{name}">       <!-- 自动生成name="name" --><input th:field="*{email}">      <!-- 自动生成name="email" -->
</form>

✅ ​​优势​​：自动生成name、id、value属性，减少70%冗余代码

2. 复杂对象展示

<div th:object="${product}"><h2 th:text="*{name}"></h2><p>价格: <span th:text="*{#numbers.formatDecimal(price, 0, 2)}"></span></p><div th:if="*{stock > 0}" class="in-stock">有货</div>
</div>

3. 嵌套对象处理

<div th:object="${order}"><div th:object="*{customer}">联系人: <span th:text="*{name}"></span></div>
</div>

三、关键注意事项

1. ​​作用域限制​​

   • *{} ​​仅生效于​​ th:object 所在元素及其子元素
   • 区域外需切回 ${} 语法

2. ​​空值防护​​

   <!-- 错误：直接使用可能抛异常 -->
   <div th:object="${potentiallyNull}">...</div><!-- 正确：先判空 -->
   <div th:if="${potentiallyNull != null}" th:object="${potentiallyNull}">...
   </div>

3. ​​混合使用技巧​​

   <div th:object="${user}">用户名: <span th:text="*{name}"></span> 当前时间: <span th:text="${currentDate}"></span> <!-- 区域内外变量混用 -->
   </div>

4. ​​命名冲突解决​​

   <!-- 当URL参数与对象属性同名时 -->
   <div th:object="${user}">页面ID: <span th:text="${param.page}"></span>  <!-- URL参数page -->用户页: <span th:text="*{page}"></span>       <!-- user对象的page属性 -->
   </div>

四、进阶用法

1. 条件表达式

<div th:object="${account}"><p th:class="*{balance < 0} ? 'text-danger' : 'text-success'">余额: <span th:text="*{balance}"></span></p>
</div>

2. 日期格式化

<span th:text="${#dates.format(*{birthDate}, 'yyyy-MM-dd')}"></span>

3. 集合遍历

<div th:each="item : *{items}"><span th:text="${item.name}"></span>
</div>

五、调试技巧

1. ​​检查上下文对象​​

   <!-- 输出整个对象JSON -->
   <script th:inline="javascript">console.log([[${user}]]);
   </script>

2. ​​错误排查步骤​​：

   • 检查th:object是否成功绑定对象
   • 确认作用域范围
   • 验证对象属性名拼写一致性

总结：使用场景决策表

📌 ​​黄金法则​​：当处理对象≥3个属性时，使用th:object可显著提升可维护性