【开发技巧】thymeleaf，一个现代服务器端 Java 模板引擎

博主： Fivk
发布时间：2023 年 03 月 06 日
1044 次浏览
2130字数
分类：项目实战开发技巧

## 一、thymeleaf简介

Thymeleaf是一种Java模板引擎，它可以将HTML、XML、JavaScript或文本模板转换为可以在Web浏览器中渲染的模板。Thymeleaf可以用于创建静态页面，也可以与Spring框架集成来创建动态Web应用程序。

使用Thymeleaf，您可以将动态数据绑定到HTML模板中的任何元素上，例如表单字段、文本、图片、链接等。它支持标准HTML标签和属性，同时提供了额外的属性和标签，以支持Thymeleaf的特定功能。

Thymeleaf的优点包括：

1. 易于学习和使用：Thymeleaf的语法与标准的HTML相似，使得学习和使用它变得非常容易。
2. 可以与Spring框架无缝集成：Thymeleaf是Spring框架的推荐模板引擎，它可以与Spring的各种组件无缝集成，例如Spring MVC、Spring Boot等。
3. 支持多种模板模式：Thymeleaf支持HTML、XML、JavaScript和纯文本模板，使得它可以适用于各种Web应用程序场景。
4. 支持国际化：Thymeleaf提供了良好的国际化支持，使得您可以轻松地创建多语言Web应用程序。
5. 可以在浏览器端预览：由于Thymeleaf使用标准的HTML语法，因此您可以在浏览器中预览和调试模板。

## 二、使用案例

假设有一个Web应用程序需要显示所有用户的姓名和年龄信息。使用Thymeleaf可以创建一个HTML模板，并将动态数据绑定到模板上。

HTML模板代码如下：

```html
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>User List</title>
</head>
<body>
    <h1>User List</h1>
    <table>
        <tr>
            <th>Name</th>
            <th>Age</th>
        </tr>
        <tr th:each="user : ${users}">
            <td th:text="${user.name}"></td>
            <td th:text="${user.age}"></td>
        </tr>
    </table>
</body>
</html>
```

在此模板中，使用Thymeleaf的特定属性（例如“th:each”和“th:text”）来绑定动态数据。在表格中，使用“th:each”属性遍历所有用户，并使用“th:text”属性将用户的姓名和年龄绑定到表格单元格中。

接下来，在Java代码中创建用户对象列表，并将其绑定到HTML模板中：

```xml
<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
```

```java
@Controller
public class UserController {

@GetMapping("/users")
    public String getUserList(Model model) {
        List<User> users = userService.getUserList();
        model.addAttribute("users", users);
        return "userList";
    }
}
```

在此代码中，使用`Spring MVC`的`@Controller`注解来创建一个控制器，并使用`@GetMapping`注解来定义请求路径。在`getUserList`方法中，调用`userService.getUserList()`方法获取所有用户对象，并将它们添加到模型中。最后，返回模板名称`userList`。

通过上述代码，`Thymeleaf`会将模板与动态数据合并并生成最终的`HTML`输出，该输出将在浏览器中呈现所有用户的姓名和年龄信息的表格。

`Thymeleaf`的模板文件放置在`src/main/resources/templates`目录下，然后在控制器中指定要使用的模板文件名称，`Spring Boot`框架会自动将该模板文件渲染成`HTML`页面并返回给客户端浏览器。

## 三、评价

`Thymeleaf`是一个功能强大且易于学习和使用的`Java`模板引擎，它提供了丰富的标签和属性来绑定动态数据和控制模板生成。它的语法类似于标准的`HTML`，使得开发人员可以很容易地将其集成到`Web`应用程序中。另外，`Thymeleaf`提供了良好的国际化支持，使得开发多语言`Web`应用程序变得非常简单。

与其他模板引擎相比，`Thymeleaf`的一个优点是可以在浏览器端预览模板，从而方便开发人员调试模板。此外，`Thymeleaf`也可以与`Spring`框架无缝集成，因此在使用`Spring`框架的`Java Web`应用程序中使用`Thymeleaf`会更加方便。

总的来说，`Thymeleaf`是一种非常实用和强大的`Java`模板引擎，它可以提高开发人员的工作效率，同时提供了良好的灵活性和扩展性，因此在`Java Web`应用程序开发中广泛应用。

最后修改：2023 年 03 月 13 日