Thymeleaf表达式语言（Expression Language）详解

# 1. 介绍

## 1.1 Thymeleaf简介

Thymeleaf是一种流行的服务器端Java模板引擎，用于构建基于Web的应用程序。它允许开发人员以自然的方式创建动态网页，并将动态内容呈现给用户。Thymeleaf提供了丰富的标记和表达式语言来操作和显示数据。

## 1.2 表达式语言的作用

表达式语言（EL）是一种用于在模板中插入动态值的语言。它允许开发人员使用变量、运算符、函数和对象引用来操作数据。表达式语言的主要作用是将模板和业务逻辑解耦，使页面设计和数据显示分离。

## 1.3 Thymeleaf和表达式语言的关系

Thymeleaf使用表达式语言来读取和处理模板中的数据。它支持多种表达式语言，包括SpEL（Spring Expression Language）和Ognl（Object-Graph Navigation Language）。开发人员可以根据项目的需要选择合适的表达式语言来使用Thymeleaf。

Thymeleaf也支持自定义表达式，开发人员可以根据自己的需求扩展和定制表达式功能。另外，Thymeleaf还提供了一套标准的表达式语法，用于处理常见的数据操作和逻辑判断。

下面将详细介绍Thymeleaf表达式语言的基本语法和用法。

# 2. 基本语法

Thymeleaf表达式语言（Expression Language，简称EL）是一种用于动态在模板中展示数据的语言。它是Thymeleaf框架的核心组成部分，通过提供一套特定的语法和规则，使得我们可以在模板中使用变量、运算符、条件语句和循环控制等功能。

在Thymeleaf中，有以下几种基本的表达式语法：

### 2.1 变量表达式

变量表达式是用来表示模板中的变量的。我们可以通过`${}`来引用变量，并在其中进行相应的操作。以下是一个简单示例：

<p>欢迎您，${username}！</p>

在上述示例中，`${username}`代表一个变量，它的值将从后台传递到模板中进行展示。

### 2.2 字面量表达式

字面量表达式是指直接在模板中使用字面量来展示内容的表达式。字面量可以是字符串、整数、浮点数等。

<p>我的年龄是：${30}</p>

在上述示例中，`${30}`代表一个整型字面量，它的值将直接显示在模板中。

### 2.3 运算表达式

运算表达式用于进行数学运算或字符串拼接等操作。Thymeleaf支持一系列的运算符，包括算术运算符、逻辑运算符和关系运算符等。

<p>5 + 3 = ${5 + 3}</p>
<p>${"Thymeleaf" + " is powerful"}</p>

在上述示例中，`${5 + 3}`代表了一个算术运算表达式，它的值将计算出并显示在模板中。

### 2.4 比较和逻辑表达式

比较和逻辑表达式用于判断两个或多个值之间的关系，并返回一个布尔值。

<p>${age > 18}</p>
<p>${score1 >= 90 && score2 >= 90}</p>

在上述示例中，`${age > 18}`代表了一个比较表达式，它的值将根据age的大小进行判断，并返回true或false。

### 2.5 条件表达式

条件表达式用于根据条件来动态地展示不同的内容。Thymeleaf提供了类似于if-else的条件语句。

<p th:if="${gender == 'male'}">欢迎先生！</p>
<p th:unless="${gender == 'female'}">欢迎来到我们的网站！</p>

在上述示例中，`th:if`和`th:unless`是Thymeleaf提供的条件语句，根据条件的成立与否来决定是否展示相应的内容。

### 2.6 集合表达式

集合表达式用于对集合类型的数据进行操作和展示。我们可以使用循环语句来遍历集合并展示每个元素。

<ul>
  <li th:each="fruit : ${fruits}" th:text="${fruit}"></li>
</ul>

在上述示例中，`th:each`是Thymeleaf提供的循环语句，它将遍历名为fruits的集合，并将每个元素赋值给变量fruit，最后将其展示在模板中。

以上是Thymeleaf表达式语言的基本语法和用法。通过灵活运用这些表达式，我们可以轻松地在模板中展示动态的数据和逻辑。下面我们将通过实例来更深入地了解如何使用Thymeleaf表达式语言。

# 3. 对象引用

Thymeleaf 表达式语言不仅可以用于访问变量，还可以用于访问对象的属性和调用对象的方法。在这一节中，我们将介绍如何在 Thymeleaf 模板中使用对象引用。

#### 3.1 访问对象属性

在 Thymeleaf 中，我们可以通过`.`操作符来访问对象的属性。例如，如果我们有一个名为 `user` 的对象，并且该对象有一个属性名为 `name`，我们可以这样在模板中进行访问：

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

上面的代码中，`${user.name}` 表达式将会获取 `user` 对象的 `name` 属性，并将其显示在 `<p>` 标签中。

#### 3.2 调用对象方法

除了访问对象的属性，我们还可以在 Thymeleaf 模板中调用对象的方法。假设 `user` 对象有一个名为 `getFullName()` 的方法，我们可以这样使用它：

<p th:text="${user.getFullName()}"></p>

上面的代码中，`${user.getFullName()}` 表达式将会调用 `user` 对象的 `getFullName()` 方法，并将返回的结果显示在 `<p>` 标签中。

#### 3.3 使用特殊变量

在 Thymeleaf 中，还有一些特殊的对象可以被直接访问。例如，`${#dates}` 可以直接访问日期和时间相关的方法，`${#httpServletRequest.getParameter('param')}` 可以直接访问 HttpServletRequest 对象的参数。这些特殊变量提供了方便快捷的方式来获取常用的对象和方法。

通过以上内容，我们可以看到在 Thymeleaf 模板中如何使用对象引用，包括访问对象属性、调用对象方法以及使用特殊变量。这些功能大大提升了模板的灵活性和可复用性。

# 4. 条件判断

条件判断是程序中常用的一种控制结构，通过判断条件的真假来决定程序的执行流程。在Thymeleaf表达式语言中，我们也可以使用条件判断语句来实现类似的功能。

#### 4.1 if条件语句

if条件语句用于判断一个条件是否满足，如果满足，则执行相应的逻辑代码块。在Thymeleaf中，可以使用`th:if`属性来实现if条件判断。

<p th:if="${user.age >= 18}">成年人</p>
<p th:if="${user.age < 18}">未成年人</p>

在上面的例子中，我们通过`${user.age >= 18}`判断用户的年龄是否大于等于18岁，如果满足，则显示"成年人"；否则，显示"未成年人"。

#### 4.2 switch条件语句

switch条件语句用于多个条件的判断，根据不同的情况执行相应的逻辑代码块。在Thymeleaf中，可以使用`th:switch`和`th:case`属性来实现switch条件判断。

<div th:switch="${user.gender}">
  <p th:case="'男'">男性</p>
  <p th:case="'女'">女性</p>
  <p th:case="*">未知性别</p>
</div>

在上面的例子中，我们通过`${user.gender}`判断用户的性别，根据不同的性别执行相应的逻辑代码块。如果用户的性别为"男"，则显示"男性"；如果用户的性别为"女"，则显示"女性"；如果用户的性别不是"男"也不是"女"，则显示"未知性别"。

通过if条件语句和switch条件语句，我们可以实现在Thymeleaf模板中进行条件判断的功能，根据不同的条件来显示不同的内容，从而实现动态的页面展示效果。

# 5. 循环控制

循环控制是编程中常用的一种结构，用于重复执行一段代码。在Thymeleaf中，我们可以使用循环语句来处理集合数据的遍历和输出。Thymeleaf提供了两种循环语句：foreach循环和while循环。

#### 5.1 foreach循环语句

foreach循环语句可以用于遍历集合数据，并对每个元素执行相应的操作。在Thymeleaf中，通过th:each属性可以实现foreach循环。

下面是一个示例，演示如何使用foreach循环语句在HTML页面中遍历一个字符串列表，并输出每个字符串：

<ul>
  <li th:each="str : ${strList}" th:text="${str}"></li>
</ul>

在上面的代码中，`strList` 是一个字符串列表的属性值。通过`th:each="str : ${strList}"` 部分即可遍历`strList`中的每个字符串元素，并将其赋值给`str`变量。然后，通过`th:text="${str}"` 部分将每个字符串输出为`li`元素的文本。

#### 5.2 while循环语句

while循环语句可以用于在满足条件的情况下重复执行一段代码。在Thymeleaf中，通过`th:while` 属性可以实现while循环。

下面是一个示例，演示如何使用while循环语句在HTML页面中递减一个数字，并输出每个数字：

<div th:variable="num">10</div>
<div th:while="${num > 0}">
  <p th:text="${num}"></p>
  <div th:remove="tag"></div>
  <div th:eval="${num = num - 1}"></div>
</div>

在上面的代码中，我们首先通过`th:variable="num"` 将初始值设置为10，并将其赋值给`num`变量。然后在`div`元素内部使用`th:while="${num > 0}"` 条件判断，如果条件满足，则输出数字，并将`num`递减1。通过使用`th:remove`属性将`div`标签从最终HTML输出中移除，实现了循环效果。

通过上述示例，我们可以了解Thymeleaf中循环控制的基本语法和用法。根据实际需求，我们可以在循环中进行更复杂的逻辑操作，实现丰富的页面展示效果。

# 6. 扩展功能

在Thymeleaf中，除了基本的表达式语言之外，还支持自定义表达式和Thymeleaf标准表达式来扩展功能。

#### 6.1 自定义表达式

通过自定义表达式，我们可以根据业务需求定义自己的表达式语法，使得模板引擎能够更好地适应特定的业务场景。在Thymeleaf中，可以通过实现自定义的表达式解析器来实现自定义表达式的功能。具体步骤包括：

// 自定义表达式解析器示例
public class CustomExpressionParser implements IExpressionParser {
    // 实现自定义表达式解析逻辑
}

#### 6.2 使用Thymeleaf标准表达式

Thymeleaf标准表达式是Thymeleaf提供的一组预定义的标准表达式，包括操作符、函数等，能够帮助开发者更方便地处理模板中的数据和逻辑。例如，Thymeleaf标准表达式中包括了字符串拼接、数学运算、日期格式化等常用功能。开发者可以直接在模板中使用这些标准表达式，而无需额外编写代码。具体可以参考Thymeleaf官方文档中关于标准表达式的说明。

通过自定义表达式和使用Thymeleaf标准表达式，我们可以在Thymeleaf中实现更多复杂的功能，更好地满足不同场景下的需求。

以上就是关于Thymeleaf表达式语言的基本语法和用法的介绍，希望能帮助到您更好地使用Thymeleaf模板引擎来开发Web应用。