Springboot集成Thymeleaf：实战教程与配置详解

本文主要介绍了如何在Spring Boot项目中集成Thymeleaf模板引擎，Thymeleaf是一款强大的XML/XHTML/HTML模板引擎，专为Java应用设计，常用于替代Spring MVC中的JSP、FreeMarker等模板技术，它通过将页面逻辑与数据分离，提高了开发效率和代码复用性。 首先，确保项目的环境配置如下： - 使用JDK版本1.8 - 开发工具为IntelliJ IDEA 2020.1 - Spring Boot版本为2.3.9.RELEASE 在集成步骤中，关键依赖项包括： 1. 引入`spring-boot-starter-thymeleaf`依赖，这是Spring Boot官方提供的Thymeleaf启动器，包含了Thymeleaf核心功能和基本配置： ```xml <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-thymeleaf</artifactId> </dependency> ``` 2. 另外，Thymeleaf有时可能需要OGNL（Object-Graph Navigation Language）解析器，如果项目中未包含，还需要添加`ognl`库的版本3.1.26： ```xml <dependency> <groupId>ognl</groupId> <artifactId>ognl</artifactId> <version>3.1.26</version> </dependency> ``` 在Spring Boot配置方面，推荐禁用缓存以实时反映模板变化： ```properties spring.thymeleaf.cache=false ``` 设置模板文件的后缀名和前缀路径： ```properties spring.thymeleaf.suffix=.html spring.thymeleaf.prefix=classpath:/" ``` 接下来是实现集成的具体步骤： 1. 创建一个名为`ExampleController`的控制器类，并使用`@Controller`注解而不是`@RestController`，因为`Thymeleaf`需要访问视图层来渲染模板： ```java import org.springframework.stereotype.Controller; import org.springframework.ui.Model; import org.springframework.web.bind.annotation.GetMapping; @Controller public class ExampleController { @GetMapping("/index") public String index(Model model) { // 这里处理数据并将结果放入model对象 model.addAttribute("exampleData", "Hello, Thymeleaf!"); return "index"; // 返回模板名称 } } ``` 2. 在`index`方法中，`Model`参数用于传递数据到视图层。这里的`"index"`字符串表示模板文件名为`index.html`，位于`classpath:/templates`目录下。 当你访问`http://localhost:8080/index`这样的URL时，Spring Boot会调用`ExampleController`的`index`方法，处理完数据后，Thymeleaf将负责解析`index.html`模板并填充数据。这就是Spring Boot集成Thymeleaf的基本流程，它提供了一种更加灵活且易于维护的方式来分离前端展示和后端业务逻辑。