📖 Thymeleaf简介

📚 Thymeleaf的定义

Thymeleaf 是一款现代化的服务器端 Java 模板引擎，适用于 Web 和独立应用场景。它具备处理 HTML、XML、JavaScript、CSS 以及纯文本的能力。Thymeleaf 的核心目标是为开发者提供一种优雅且自然的模板设计方式，从而使得开发者能够更加便捷地构建、创建和维护结构化且语义正确的 Web 页面。

🌟 Thymeleaf的特点

Thymeleaf具有可读性强、易于理解的语法。
Thymeleaf支持Spring MVC的所有特性，可以与Spring框架无缝集成。
Thymeleaf可以在没有Web服务器的情况下运行，便于开发和测试。
Thymeleaf支持多种模板解析器，可以根据需要选择合适的解析器。

🌐 Thymeleaf的应用场景

Thymeleaf 是一款适用于各种 Web 应用程序的强大模板引擎，无论是传统的服务器端 Web 应用程序、单页应用程序，还是移动 Web 应用程序，都能够轻松应对。此外，Thymeleaf 不仅局限于动态内容的生成，还可以用于生成静态内容，如电子邮件模板等，为开发者提供了极大的便利和灵活性。

🚀 在Spring Boot中使用Thymeleaf

📦 添加Thymeleaf依赖

在Spring Boot项目的pom.xml文件中，添加Thymeleaf的依赖：

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

⚙️ 配置Thymeleaf

在Spring Boot的application.properties或application.yml文件中，可以配置Thymeleaf的相关属性，例如模板文件的位置、缓存策略等。

spring:
  thymeleaf:
    prefix: classpath:/templates/
    suffix: .html
    cache: false

📝 编写Thymeleaf模板

在指定的模板文件夹（如上述配置中的classpath:/templates/）中，创建一个HTML文件，例如index.html。在HTML文件中，可以使用Thymeleaf的语法编写动态内容。

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>Thymeleaf示例</title>
</head>
<body>
    <h1 th:text="${message}">Hello, Thymeleaf!</h1>
</body>
</html>

🎮 编写Spring Boot控制器

在Spring Boot项目中，创建一个控制器类，使用@Controller注解。在控制器方法中，可以将数据添加到Model对象中，并返回Thymeleaf模板的名称。

@Controller
public class HomeController {

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

📚Thymeleaf的常用语法

📊 变量表达式

使用${...}语法，可以在Thymeleaf模板中访问变量的值。

<p th:text="${user.name}">用户名</p>

🎛️ 选择表达式

使用*{...}语法，可以在Thymeleaf模板中访问当前对象的属性。

<div th:object="${user}">
    <p th:text="*{name}">用户名</p>
</div>

🔄 迭代表达式

使用th:each属性，可以在Thymeleaf模板中遍历集合。

<ul>
    <li th:each="user : ${users}" th:text="${user.name}">用户名</li>
</ul>

🤝 Thymeleaf与Spring Boot的集成

🌱 使用Spring表达式语言

在Thymeleaf模板中，可以使用Spring表达式语言（SpEL）进行更复杂的表达式计算。

<p th:text="${@userService.findUserById(1).name}">用户名</p>

🔐 使用Spring Security集成

Thymeleaf可以与Spring Security集成，提供安全相关的标签和表达式。

<div th:if="${#authorization.expression('hasRole(''ROLE_ADMIN'')')}">
    管理员功能
</div>

🛠️ 使用Spring Boot的自动配置

Spring Boot提供了Thymeleaf的自动配置，可以根据项目的依赖和配置自动创建和配置Thymeleaf模板引擎、视图解析器等组件。

🔌 Thymeleaf的扩展和插件

🗣️ 使用额外的方言

接下来，我们将探讨Thymeleaf的一个重要特性，即支持使用额外的方言。这些方言包括Spring Security方言、布局方言等，它们可以为我们的Web应用带来更丰富的功能和更好的用户体验。接下来，我们将详细介绍如何通过添加依赖和配置方言来使用这些功能。

首先，我们需要了解什么是Thymeleaf方言。简单来说，方言是一组自定义的标签、属性和表达式，它们可以扩展Thymeleaf的功能，使其更加强大和灵活。例如，Spring Security方言可以帮助我们轻松地实现基于角色的页面内容显示，而布局方言则可以让我们更方便地管理页面布局和模板。

要使用这些方言，我们需要先在项目中添加相应的依赖。以Spring Security方言为例，我们可以在项目的pom.xml文件中添加以下依赖：

<dependency>
    <groupId>org.thymeleaf.extras</groupId>
    <artifactId>thymeleaf-extras-springsecurity5</artifactId>
    <version>3.0.4.RELEASE</version>
</dependency>

接下来，我们需要在Thymeleaf模板引擎中配置这些方言。这可以通过在Spring配置类中定义一个SpringTemplateEngine bean并添加相应的方言实现。以下是一个示例：

@Configuration
public class ThymeleafConfig {

    @Bean
    public SpringTemplateEngine templateEngine(ITemplateResolver templateResolver) {
        SpringTemplateEngine templateEngine = new SpringTemplateEngine();
        templateEngine.setTemplateResolver(templateResolver);
        templateEngine.addDialect(new SpringSecurityDialect());
        return templateEngine;
    }
}