Spring Boot集成Thymeleaf教程

简介

在这篇文章中，我们将学习如何在Spring Boot项目中集成Thymeleaf模板引擎。Thymeleaf是一种服务器端Java模板引擎，用于在Web应用程序中渲染HTML页面。它与Spring Boot框架的集成非常简单，只需几个简单的步骤即可实现。

整体流程

我们首先来看一下整体的流程，如下表所示：

步骤 描述
1 创建一个新的Spring Boot项目
2 添加Thymeleaf依赖
3 配置Thymeleaf
4 创建一个Controller类
5 创建一个Thymeleaf模板文件
6 运行应用程序并访问页面

接下来，我们将逐步解释每个步骤应该做什么以及需要使用的代码。

1. 创建一个新的Spring Boot项目

首先，我们需要创建一个新的Spring Boot项目。你可以使用你喜欢的集成开发环境（IDE）或者使用Maven命令行创建项目。在这里，我们使用Spring Initializr来创建项目。

2. 添加Thymeleaf依赖

在pom.xml文件中，添加以下Thymeleaf依赖：

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

这将引入Thymeleaf和与Spring Boot集成所需的其他依赖。

3. 配置Thymeleaf

在application.properties文件中，添加以下配置：

spring.thymeleaf.cache=false
spring.thymeleaf.enabled=true

这将禁用Thymeleaf的缓存，以便在开发期间可以及时看到更改。

4. 创建一个Controller类

创建一个新的Java类，命名为HelloController。在该类中，添加一个方法来处理/hello请求，并返回一个模板名称。

@Controller
public class HelloController {

    @GetMapping("/hello")
    public String hello(Model model) {
        model.addAttribute("message", "Hello, Thymeleaf!");
        return "hello";
    }
}

5. 创建一个Thymeleaf模板文件

在src/main/resources/templates目录下创建一个名为hello.html的文件，并添加以下内容：

<!DOCTYPE html>
<html xmlns:th="
<head>
    <meta charset="UTF-8">
    <title>Hello Thymeleaf</title>
</head>
<body>
    
</body>
</html>

这个模板文件使用Thymeleaf的语法，在``标签中使用${message}表达式显示消息。

6. 运行应用程序并访问页面

现在，你可以通过运行应用程序，并访问http://localhost:8080/hello来查看你的Thymeleaf模板渲染的结果。

代码注释

下面是上述步骤中使用的代码，并对其进行了注释：

@Controller
public class HelloController {

    @GetMapping("/hello")
    public String hello(Model model) {
        model.addAttribute("message", "Hello, Thymeleaf!"); // 在模型中添加一个名为"message"的属性，值为"Hello, Thymeleaf!"
        return "hello"; // 返回模板名称
    }
}

<!DOCTYPE html>
<html xmlns:th="
<head>
    <meta charset="UTF-8">
    <title>Hello Thymeleaf</title>
</head>
<body>
    <h1 th:text="${message}"> <!-- 在<h1>标签中使用Thymeleaf的表达式，显示模型中的"message"属性的值 -->
</body>
</html>

状态图

下面是一个状态图，展示了整个流程的状态转换：

stateDiagram
    [*] --> 创建新的Spring Boot项目
    创建新的Spring Boot项目 --> 添加Thymeleaf依赖
    添加Thymeleaf依赖 --> 配置Thymeleaf
    配置Thymeleaf --> 创建Controller类
    创建Controller类 -->