你还在用 JSP 吗？快来试试 thymeleaf 吧！

最新推荐文章于 2025-11-18 06:00:00 发布

原创最新推荐文章于 2025-11-18 06:00:00 发布 · 583 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#java #开发语言 #thymeleaf #模板技术

Java 专栏收录该内容

47 篇文章

订阅专栏

本文详细介绍了thymeleaf在SpringBoot中的应用，包括其基本语法、在项目中的集成步骤，以及其优势（如标准、自然和集成性强）和局限性（如基于XML和服务器端操作）。

一、什么是thymeleaf？

二、如何在Spring Boot中使用thymeleaf？

三、thymeleaf的优势和局限性

四、总结

一、什么是thymeleaf？

thymeleaf是一个基于Java的模板引擎，它可以用来处理XML/XHTML/HTML5等格式的文件，将数据和文本渲染到模板中，生成动态的页面。它与JSP，Velocity，FreeMarker等模板引擎类似，也可以轻易地与Spring Boot等Web框架集成。SpringBoot官方并不推荐使用JSP，而是使用thymeleaf。

thymeleaf的主要目标是提供一种优雅和自然的模板语法，让模板文件既可以在浏览器中正确显示，也可以作为静态原型，方便开发团队之间的协作1。它还支持多种模式，如XML，XHTML，HTML5，Legacy HTML5等，可以处理任何XML文件或非XML文件。

thymeleaf的基本语法如下：

使用th:前缀来标识thymeleaf的属性或标签，如<div th:text="${name}"></div>表示将name变量的值渲染到div标签中。
使用${}来表示变量表达式，如${name}表示name变量的值。
使用#来表示工具对象表达式，如${#numbers.formatDecimal(price, 1, 2)}表示使用numbers工具对象来格式化price变量的值为两位小数。
使用@来表示链接表达式，如<a th:href="@{/product/{id}(id=${prod.id})}">View</a>表示使用prod.id变量的值来构造一个相对于当前上下文路径的链接。
使用*来表示选择表达式，如<input type="text" th:field="*{name}"/>表示将name属性绑定到input标签中。
使用_来表示文字替换表达式，如<p th:text="_(${session.user.name} + ' is ' + ${session.user.age} + ' years old')"></p>表示将括号内的字符串替换为变量值后渲染到p标签中。

例如：

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>Thymeleaf Demo</title>
</head>
<body>
    <h1 th:text="${title}">Thymeleaf Demo</h1>
    <p th:if="${message}" th:text="${message}">Welcome!</p>
    <ul>
        <li th:each="item : ${items}" th:text="${item.name}">Item</li>
    </ul>
    <form th:action="@{/submit}" th:object="${form}" method="post">
        <input type="text" th:field="*{name}" placeholder="Name"/>
        <input type="email" th:field="*{email}" placeholder="Email"/>
        <button type="submit">Submit</button>
    </form>
</body>
</html>

二、如何在Spring Boot中使用thymeleaf？

在Spring Boot中使用thymeleaf非常简单，只需要以下几个步骤：

1、在Maven或Gradle项目中添加thymeleaf相关的依赖包。

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

<!-- Gradle -->
implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'

2、在resources目录下创建一个名为templates的子目录，并在其中放置thymeleaf模板文件。

<!-- templates/index.html -->
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>Thymeleaf Demo</title>
</head>
<body>
    <h1 th:text="${title}">Thymeleaf Demo</h1>
    <p th:if="${message}" th:text="${message}">Welcome!</p>
    <ul>
        <li th:each="item : ${items}" th:text="${item.name}">Item</li>
    </ul>
    <form th:action="@{/submit}" th:object="${form}" method="post">
        <input type="text" th:field="*{name}" placeholder="Name"/>
        <input type="email" th:field="*{email}" placeholder="Email"/>
        <button type="submit">Submit</button>
    </form>
</body>
</html>

3、在Java代码中创建一个控制器类，并使用@Controller注解来标识，并使用@RequestMapping或@GetMapping等注解来映射请求路径和方法，并使用Model或ModelAndView等对象来传递数据到模板中。

// DemoController.java 控制器类
@Controller
public class DemoController {

    // 处理根路径的GET请求，返回index模板
    @GetMapping("/")
    public String index(Model model) {
        // 设置模型属性
        model.addAttribute("title", "Thymeleaf Demo");
        model.addAttribute("message", "Welcome!");
        model.addAttribute("items", Arrays.asList(
                new Item("Apple", 1.99),
                new Item("Banana", 0.99),
                new Item("Orange", 1.49)
        ));
        model.addAttribute("form", new Form());
        // 返回模板名称，不需要后缀
        return "index";
    }

    // 处理/submit路径的POST请求，接收表单数据并重定向到/result模板
    @PostMapping("/submit")
    public ModelAndView submit(@ModelAttribute Form form) {
        // 创建ModelAndView对象，设置视图名称和模型属性
        ModelAndView mav = new ModelAndView();
        mav.setViewName("result");
        mav.addObject("title", "Thymeleaf Demo");
        mav.addObject("message", "You have submitted the form successfully!");
        mav.addObject("form", form);
        // 返回ModelAndView对象
        return mav;
    }
}

4、启动Spring Boot应用程序，并在浏览器中访问http://localhost:8080/，查看渲染后的页面。