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 变量表达式变量表达式是用来表示模板中的变量的。我们可以通过`${}`来引用变量，并在其中进行相应的操作。以下是一个简单示例： ```html <p>欢迎您，${username}！</p> ``` 在上述示例中，`${username}`代表一个变量，它的值将从后台传递到模板中进行展示。 ### 2.2 字面量表达式字面量表达式是指直接在模板中使用字面量来展示内容的表达式。字面量可以是字符串、整数、浮点数等。 ```html <p>我的年龄是：${30}</p> ``` 在上述示例中，`${30}`代表一个整型字面量，它的值将直接显示在模板中。 ### 2.3 运算表达式运算表达式用于进行数学运算或字符串拼接等操作。Thymeleaf支持一系列的运算符，包括算术运算符、逻辑运算符和关系运算符等。 ```html <p>5 + 3 = ${5 + 3}</p> <p>${"Thymeleaf" + " is powerful"}</p> ``` 在上述示例中，`${5 + 3}`代表了一个算术运算表达式，它的值将计算出并显示在模板中。 ### 2.4 比较和逻辑表达式比较和逻辑表达式用于判断两个或多个值之间的关系，并返回一个布尔值。 ```html <p>${age > 18}</p> <p>${score1 >= 90 && score2 >= 90}</p> ``` 在上述示例中，`${age > 18}`代表了一个比较表达式，它的值将根据age的大小进行判断，并返回true或false。 ### 2.5 条件表达式条件表达式用于根据条件来动态地展示不同的内容。Thymeleaf提供了类似于if-else的条件语句。 ```html <p th:if="${gender == 'male'}">欢迎先生！</p> <p th:unless="${gender == 'female'}">欢迎来到我们的网站！</p> ``` 在上述示例中，`th:if`和`th:unless`是Thymeleaf提供的条件语句，根据条件的成立与否来决定是否展示相应的内容。 ### 2.6 集合表达式集合表达式用于对集合类型的数据进行操作和展示。我们可以使用循环语句来遍历集合并展示每个元素。 ```html <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`，我们可以这样在模板中进行访问： ```html <p th:text="${user.name}"></p> ``` 上面的代码中，`${user.name}` 表达式将会获取 `user` 对象的 `name` 属性，并将其显示在 `<p>` 标签中。 #### 3.2 调用对象方法除了访问对象的属性，我们还可以在 Thymeleaf 模板中调用对象的方法。假设 `user` 对象有一个名为 `getFullName()` 的方法，我们可以这样使用它： ```html <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条件判断。 ```html <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条件判断。 ```html <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页面中遍历一个字符串列表，并输出每个字符串： ```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页面中递减一个数字，并输出每个数字： ```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中，可以通过实现自定义的表达式解析器来实现自定义表达式的功能。具体步骤包括： ```java // 自定义表达式解析器示例 public class CustomExpressionParser implements IExpressionParser { // 实现自定义表达式解析逻辑 } ``` #### 6.2 使用Thymeleaf标准表达式 Thymeleaf标准表达式是Thymeleaf提供的一组预定义的标准表达式，包括操作符、函数等，能够帮助开发者更方便地处理模板中的数据和逻辑。例如，Thymeleaf标准表达式中包括了字符串拼接、数学运算、日期格式化等常用功能。开发者可以直接在模板中使用这些标准表达式，而无需额外编写代码。具体可以参考Thymeleaf官方文档中关于标准表达式的说明。通过自定义表达式和使用Thymeleaf标准表达式，我们可以在Thymeleaf中实现更多复杂的功能，更好地满足不同场景下的需求。以上就是关于Thymeleaf表达式语言的基本语法和用法的介绍，希望能帮助到您更好地使用Thymeleaf模板引擎来开发Web应用。