Java模板引擎Thymeleaf-猿码集

Thymeleaf是一种Java模板引擎，能够处理HTML、XML、JavaScript等任意类型的文本。它与Spring框架紧密集成，可以方便地与Spring MVC配合使用，为web应用程序开发提供了便捷的模板渲染解决方案。

1. Thymeleaf概述

Thymeleaf是一个开源的模板引擎，它有以下特点：

1.1 简化语法

Thymeleaf的语法比较简单易懂，与HTML语法基本相同。它通过标签属性来控制渲染的行为，并且可以通过简单的表达式语法来动态地生成内容。

1.2 高度可定制

Thymeleaf提供了丰富的扩展点，可以根据需要定制自己的模板标签、表达式和渲染器。同时它还支持标签处理器的继承和组合，可以快速构建出复杂的渲染逻辑。

1.3 跨平台支持

Thymeleaf可以在任意Java环境中运行，支持与任何Java Web框架的集成。并且它还提供了Spring Security等常用扩展的集成支持。

2. Thymeleaf入门

2.1 添加依赖

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

org.springframework.boot spring-boot-starter-thymeleaf

2.2 配置视图解析器

在Spring Boot中，可以使用Thymeleaf的自动配置功能来配置视图解析器。在application.properties文件中添加如下配置即可：

spring.thymeleaf.prefix=classpath:/templates/ spring.thymeleaf.suffix=.html

其中prefix属性指定模板文件路径的前缀，suffix属性指定模板文件的后缀。

2.3 编写模板

编写Thymeleaf模板与编写普通的HTML页面几乎一样，只是需要在标签属性中使用Thymeleaf提供的表达式语法。

下面是一个简单的示例代码，其中通过变量替换的方式动态生成了页面内容：


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

上述代码中，通过th:text属性来指定文本节点的值。其中${name}表示通过数据模型中名称为name的变量来替换值。

2.4 渲染模板

在Spring MVC中，可以通过返回值类型为String类型的控制器方法来实现模板渲染。具体实现方式如下：


    @Controller
    public class HelloController {
        @GetMapping("/hello")
        public String hello(Model model) {
            model.addAttribute("name", "Thymeleaf");
            return "hello";
        }
    }

上述代码中，使用Model对象将name变量传递给了模板hello.html，并且通过返回值的方式实现了模板渲染。

3. Thymeleaf进阶

3.1 条件判断

Thymeleaf提供了三种不同的条件判断语法，分别是：

（1）th:if：指定条件为true时渲染此节点。

（2）th:unless：指定条件为false时渲染此节点。

（3）th:switch：类似Java中的switch语句，指定匹配的条件进行渲染。

下面是一个条件判断的示例代码：


    <!DOCTYPE html>
    <html xmlns:th="http://www.thymeleaf.org">
    <head>
        <title>Hello Thymeleaf</title>
    </head>
    <body>
        <div th:if="${flag}">
            This is true.
        </div>
        <div th:unless="${flag}">
            This is false.
        </div>
        <div th:switch="${value}">
            <div th:case="'A'">The value is A.</div>
            <div th:case="'B'">The value is B.</div>
            <div th:case="*">The value is other.</div>
        </div>
    </body>
    </html>

上述代码中，通过if语句来判断flag是否为true，通过unless语句来判断flag是否为false，通过switch语句来判断value的取值并进行处理。

3.2 迭代器

Thymeleaf支持使用th:each指定迭代器并进行遍历。具体语法如下：


    <div th:each="item : ${items}">
        <span th:text="${item}"></span>
    </div>

上述代码中，通过each指令遍历了名为items的列表，并将每个元素存入变量item中进行处理。

3.3 模板布局

Thymeleaf提供了布局机制，可以将模板的不同部分抽象成公共的模板片段（fragment），并在需要的地方重复使用。具体的实现方式如下：

（1）创建模板片段


    <!DOCTYPE html>
    <html xmlns:th="http://www.thymeleaf.org">
    <head>
        <title>Hello Thymeleaf</title>
    </head>
    <body>
        <div th:fragment="header">
            <h1>This is header.</h1>
        </div>
        <div th:fragment="content">
            <p>This is content.</p>
        </div>
        <div th:fragment="footer">
            <p>This is footer.</p>
        </div>
    </body>
    </html>

上述代码中，定义了三个模板片段：header、content和footer。

（2）引用模板片段


    <!DOCTYPE html>
    <html xmlns:th="http://www.thymeleaf.org">
    <head>
        <title>Hello Thymeleaf</title>
    </head>
    <body>
        <div th:insert="fragments/header"></div>
        <div th:replace="fragments/content"></div>
        <div th:replace="fragments/footer"></div>
    </body>
    </html>

上述代码中，通过insert指令将header模板片段插入到当前位置，通过replace指令将content和footer模板片段替换当前位置的节点。

4. 结束语

Thymeleaf是一款优秀的Java模板引擎，它具有简单易懂的语法、高度可定制的扩展机制以及跨平台支持等优点。通过熟练掌握Thymeleaf的使用，可以大大提升Java Web应用程序的开发效率和稳定性。

Java模板引擎Thymeleaf