Spring Boot3 整合 Thymeleaf 模板引擎全攻略

大家好，欢迎来到IT知识分享网。

在当今的 Web 应用开发领域，Spring Boot 已然成为众多开发者的首选框架，它以其强大的功能和便捷的开发体验，极大地提升了开发效率。而 Thymeleaf 作为一款优秀的模板引擎，能够帮助我们轻松构建动态网页。那么，在 Spring Boot3 项目中如何高效地整合 Thymeleaf 模板引擎呢？今天，就让我们一同深入探究。

背景介绍

随着互联网应用的日益复杂，前后端分离的开发模式逐渐盛行。然而，在某些场景下，前后端紧密协作的传统模式依然有着不可替代的优势。Thymeleaf 模板引擎正是在这样的背景下，为我们提供了一种将后端数据与前端页面完美结合的解决方案。它不仅能够在服务器端生成动态内容，还能在浏览器端进行部分交互处理，提升用户体验。在 Spring Boot3 项目中，整合 Thymeleaf 可以让我们充分利用 Spring 框架的生态优势，同时发挥 Thymeleaf 的模板渲染能力，快速搭建出功能强大且界面友好的 Web 应用。

解决方案

添加依赖

在 Spring Boot 项目中，添加依赖是整合 Thymeleaf 的第一步。我们需要在项目的 pom.xml 文件中加入 Thymeleaf 相关的依赖。具体代码如下：

 
   
   
     org.springframework.boot 
    
   
     spring - boot - starter - thymeleaf 
    
  

这个依赖引入了 Thymeleaf 的核心库以及 Spring Boot 对 Thymeleaf 的自动配置支持，让我们能够在 Spring Boot 项目中方便地使用 Thymeleaf。

配置模板路径和文件后缀

默认情况下，Spring Boot 会将
src/main/resources/templates/目录作为 Thymeleaf 模板的存放路径，并且默认的模板文件后缀为.html。当然，如果有特殊需求，我们也可以对这些配置进行修改。例如，在application.properties文件中，可以通过以下配置修改模板路径：

spring.thymeleaf.prefix=classpath:/templates/custom/

这样，模板文件就需要存放在
src/main/resources/templates/custom/目录下了。如果想要修改模板文件的后缀，比如改为.thtml，可以进行如下配置：

spring.thymeleaf.suffix=.thtml

通过合理配置模板路径和文件后缀，我们可以更好地组织项目结构，方便管理模板文件。

创建 Controller

Controller 在 Spring Boot 项目中起着关键作用，它负责处理客户端请求，并将数据传递给模板进行渲染。接下来，我们创建一个简单的 Controller 来展示如何向 Thymeleaf 模板传递数据。代码如下：

@Controller public class UserController { @GetMapping("/users") public String listUsers(Model model) { List 
  
    users = Arrays.asList("Alice", "Bob", "Charlie"); model.addAttribute("users", users); return "user/list"; } } 
  

在这段代码中，@GetMapping(“/users”)注解表示当客户端访问/users路径时，会调用listUsers方法。在方法内部，我们创建了一个包含用户名字的列表，并通过model.addAttribute(“users”, users)将这个列表传递给模板，最后返回user/list，表示要渲染
src/main/resources/templates/user/list.html这个模板文件。

创建 HTML 模板

在
src/main/resources/templates/user/目录下创建list.html文件，这就是我们要使用 Thymeleaf 语法进行渲染的模板。代码如下：

  
用户列表
 
  
 
   
 
  
 

在这个模板中，xmlns:th=”http://www.thymeleaf.org”声明了 Thymeleaf 的命名空间，使得我们可以在 HTML 文件中使用 Thymeleaf 的语法。th:each属性用于循环遍历${users}这个变量，th:text属性则用于将每个用户的名字显示在页面上。

进阶应用：使用 Thymeleaf 表达式

Thymeleaf 提供了丰富的表达式，让我们能够更灵活地处理数据和逻辑。例如，我们可以在模板中使用条件判断表达式。假设我们有一个需求，当用户列表为空时，显示 “暂无用户” 的提示信息。修改list.html文件如下：

  
用户列表
 
  
 
   
 
   
暂无用户
 
  
 

这里的th:if=”${#lists.isEmpty(users)}”就是一个条件判断表达式，#lists.isEmpty(users)用于判断users列表是否为空，如果为空，则显示 “暂无用户” 这个

  
    
用户列表
 
   
 
    
 
    
暂无用户