Spring Boot与Thymeleaf模板引擎整合-SpringBoot零基础到实战

当前位置:　首页>> 技术小册>> SpringBoot零基础到实战

在本文中，我们将学习如何在 Spring Boot 中与 Thymeleaf 模板引擎整合，并提供一些示例代码。

**Thymeleaf 简介**

Thymeleaf 是一个现代化的服务器端 Java 模板引擎，它允许我们将静态 HTML 页面转换为动态内容。Thymeleaf 模板引擎的主要优点是可以处理 HTML、XML、JavaScript、CSS 甚至纯文本。Thymeleaf 可以轻松地与 Spring Boot 集成，它的语法简单明了，容易学习和使用。

在 Spring Boot 中使用 Thymeleaf

要在 Spring Boot 中使用 Thymeleaf 模板引擎，我们需要完成以下几个步骤：

在 Maven 或 Gradle 依赖中添加 Thymeleaf 的依赖项。

在 application.properties 或 application.yml 文件中配置 Thymeleaf 模板引擎。

创建 Thymeleaf 模板，并将其保存到 src/main/resources/templates 目录下。

在控制器中使用 Thymeleaf 模板。

现在，让我们按照上述步骤来实现 Spring Boot 与 Thymeleaf 的整合。

**添加 Thymeleaf 的依赖项**

在 Maven 项目中，我们可以在 pom.xml 文件中添加以下依赖项：
```asp
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

```
在 Gradle 项目中，我们可以在 build.gradle 文件中添加以下依赖项：
```asp
implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'

```
**配置 Thymeleaf 模板引擎**

在 Spring Boot 中，我们可以在 application.properties 或 application.yml 文件中配置 Thymeleaf 模板引擎。以下是一个 application.properties 文件的示例：
```asp
# Configure Thymeleaf
spring.thymeleaf.cache=false
spring.thymeleaf.prefix=classpath:/templates/
spring.thymeleaf.suffix=.html
spring.thymeleaf.mode=HTML5

```
在上面的示例中，我们将 Thymeleaf 模板引擎的前缀设置为 classpath:/templates/，后缀设置为 .html。这意味着我们需要将 Thymeleaf 模板保存到 src/main/resources/templates 目录下，并使用 .html 扩展名。

**创建 Thymeleaf 模板**

现在，我们可以在 src/main/resources/templates 目录下创建 Thymeleaf 模板。以下是一个简单的 Thymeleaf 模板的示例：
```asp
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>Thymeleaf Example</title>
</head>
<body>
    <h1>Welcome to Thymeleaf!</h1>
    <p th:text="${message}"></p>
</body>
</html>

```
在上面的示例中，我们使用了 Thymeleaf 模板引擎的语法来定义一个变量 message，然后将其插入到 HTML 页面中。这个变量的值将在控制器中设置。

**使用 Thymeleaf 模板**

最后，在控制器中使用 Thymeleaf 模板。以下是一个简单的 Spring Boot 控制器的示例：
```asp
@Controller
public class HomeController {
    
    @GetMapping("/")
    public String home(Model model) {
        model.addAttribute("message", "Hello Thymeleaf!");
        return "home";
    }
    
}

```
在上面的示例中，我们使用 @GetMapping 注释将 / 路径映射到 home() 方法。这个方法返回一个名为 home 的字符串，这是我们在 Thymeleaf 模板引擎中定义的文件名。此外，我们还使用 Model 对象将变量 message 添加到 Thymeleaf 模板中。

现在，我们可以启动我们的 Spring Boot 应用程序，并访问 http://localhost:8080/， 将会看到一个包含消息 Hello Thymeleaf! 的页面。

**小结**

在本文中，我们学习了如何在 Spring Boot 中使用 Thymeleaf 模板引擎。我们使用 Maven 或 Gradle 添加了 Thymeleaf 依赖项，配置了 Thymeleaf 模板引擎，并创建了一个简单的 Thymeleaf 模板。最后，我们在控制器中使用 Thymeleaf 模板，并将一个变量插入到模板中。

Thymeleaf 是一个功能强大的模板引擎，它为 Java 开发人员提供了一个简单而灵活的工具来生成动态内容。与 Spring Boot 的整合可以让我们更容易地构建美观的 Web 应用程序。我希望这篇文章能够帮助您开始使用 Thymeleaf 和 Spring Boot 来构建出色的 Web 应用程序。

该分类下的相关小册推荐：

Java语言基础13-类的加载和反射

经典设计模式Java版

深入拆解 Java 虚拟机

Mybatis合辑1-Mybatis基础入门

SpringBoot合辑-初级篇

Java语言基础3-流程控制

Java必知必会-JDBC

Mybatis合辑5-注解、扩展、SQL构建

Java语言基础5-面向对象初级

Java语言基础6-面向对象高级

Java语言基础4-数组详解

Java语言基础15-单元测试和日志技术