Thymeleaf模版引擎

🕗 发布于 2024-09-20 23:55 spring boot Thymeleaf

Thymeleaf是面向Web和独立环境的现代服务器端Java模版引擎，能够处理HTML、XML、JavaScript、CSS甚至纯文本。Thymeleaf旨在提供一个优雅的、高度可维护的创建模版的方式。为了实现这一目标，Thymeleaf建立在自然模版的概念上，将其逻辑注入到模版文件中，不会影响模版设计原型，从而改善了设计的沟通，弥合了设计和开发团队之间的差距。

Thymeleaf特点

Thymeleaf在有网络和无网络的环境下均可运行，即它可以让美工在浏览器查看页面的静态效果，也可以让程序员在服务器查看带数据的动态页面效果。这是由于它支持HTML原型，然后再HTML标签里增加额外的属性来达到模版+数据的展示方式。浏览器解释HTML是会忽略未定义的标签属性，所以Thymeleaf的模版可以静态地运行；当有数据返回到页面是，Thymeleaf会动态地替换掉静态内容，使页面动态显示
Thymeleaf开箱即用的特性。它支持标准方言和Spring方言，可以直接套用模版实现JSTL、OGNL表达式效果，避免每天套模板、改JSTL、改标签的困扰。同时开发人员也可以扩展和创建自定义的方言
Thymeleaf提供Spring标准方言和一个与SpringMVC完美集成的可选模块，可以快速地实现表单绑定、属性编辑器、国际化等功能

添加依赖（启动器）

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

application.properties添加配置

springthymeleaf.cache=false

spring.thymeleaf.cache=false 是关闭Thymeleaf的缓存，不然在开发环境中修改页面不会立刻生效需要重启，生产可配置为true

Model准备（参考SpringBoot:Web开发(基于SpringBoot使用MyBatis-Plus+JSP开发)中使用MyBatisX快捷生成）

实体类

package com.ktjiaoyu.thymeleaf.entity;

import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import java.io.Serializable;
import lombok.Data;

/**
 * 
 * @TableName sys_user
 */
@TableName(value ="sys_user")
@Data
public class User implements Serializable {
    /**
     * 编号
     */
    @TableId(type = IdType.AUTO)
    private Long usrId;

    /**
     * 姓名
     */
    private String usrName;

    /**
     * 密码
     */
    private String usrPassword;

    /**
     * 角色编号
     */
    private Long usrRoleId;
//    private String roleName;

    /**
     * 状态
     */
    private Integer usrFlag;

    @TableField(exist = false)
    private static final long serialVersionUID = 1L;

    @Override
    public boolean equals(Object that) {
        if (this == that) {
            return true;
        }
        if (that == null) {
            return false;
        }
        if (getClass() != that.getClass()) {
            return false;
        }
        User other = (User) that;
        return (this.getUsrId() == null ? other.getUsrId() == null : this.getUsrId().equals(other.getUsrId()))
            && (this.getUsrName() == null ? other.getUsrName() == null : this.getUsrName().equals(other.getUsrName()))
            && (this.getUsrPassword() == null ? other.getUsrPassword() == null : this.getUsrPassword().equals(other.getUsrPassword()))
            && (this.getUsrRoleId() == null ? other.getUsrRoleId() == null : this.getUsrRoleId().equals(other.getUsrRoleId()))
            && (this.getUsrFlag() == null ? other.getUsrFlag() == null : this.getUsrFlag().equals(other.getUsrFlag()));
    }

    @Override
    public int hashCode() {
        final int prime = 31;
        int result = 1;
        result = prime * result + ((getUsrId() == null) ? 0 : getUsrId().hashCode());
        result = prime * result + ((getUsrName() == null) ? 0 : getUsrName().hashCode());
        result = prime * result + ((getUsrPassword() == null) ? 0 : getUsrPassword().hashCode());
        result = prime * result + ((getUsrRoleId() == null) ? 0 : getUsrRoleId().hashCode());
        result = prime * result + ((getUsrFlag() == null) ? 0 : getUsrFlag().hashCode());
        return result;
    }

    @Override
    public String toString() {
        StringBuilder sb = new StringBuilder();
        sb.append(getClass().getSimpleName());
        sb.append(" [");
        sb.append("Hash = ").append(hashCode());
        sb.append(", usrId=").append(usrId);
        sb.append(", usrName=").append(usrName);
        sb.append(", usrPassword=").append(usrPassword);
        sb.append(", usrRoleId=").append(usrRoleId);
        sb.append(", usrFlag=").append(usrFlag);
        sb.append(", serialVersionUID=").append(serialVersionUID);
        sb.append("]");
        return sb.toString();
    }
}

数据访问层

package com.ktjiaoyu.thymeleaf.mapper;

import com.ktjiaoyu.thymeleaf.entity.User;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import org.apache.ibatis.annotations.Param;
import org.springframework.web.bind.annotation.PathVariable;


import java.util.List;

/**
* @author Administrator
* @description 针对表【sys_user】的数据库操作Mapper
* @createDate 2024-09-09 09:10:40
* @Entity com.ktjiaoyu.thymeleaf.entity.User
*/
public interface UserMapper extends BaseMapper<User> {


}

业务逻辑层

接口

package com.ktjiaoyu.thymeleaf.service;

import com.ktjiaoyu.thymeleaf.entity.User;
import com.baomidou.mybatisplus.extension.service.IService;


import java.util.List;

/**
* @author Administrator
* @description 针对表【sys_user】的数据库操作Service
* @createDate 2024-09-09 09:10:40
*/
public interface UserService extends IService<User> {


}

实现类

package com.ktjiaoyu.thymeleaf.service.impl;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.ktjiaoyu.thymeleaf.entity.User;

import com.ktjiaoyu.thymeleaf.service.UserService;
import com.ktjiaoyu.thymeleaf.mapper.UserMapper;
import jakarta.annotation.Resource;
import org.apache.ibatis.annotations.Param;
import org.springframework.stereotype.Service;

import java.util.List;

/**
* @author Administrator
* @description 针对表【sys_user】的数据库操作Service实现
* @createDate 2024-09-09 09:10:40
*/
@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User>
    implements UserService{

    
}

控制器开发

package com.ktjiaoyu.thymeleaf.controller;

import com.ktjiaoyu.thymeleaf.entity.User;
import com.ktjiaoyu.thymeleaf.service.UserService;
import jakarta.annotation.Resource;
import jakarta.servlet.http.HttpServletRequest;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;

import java.util.Date;
import java.util.List;

/**
 * @author cuishujian
 * @date 2024/9/13
 */
//@Controller
public class ExampleController {

    @Resource
    private UserService userService;



    @GetMapping("/hello/{id}")
    public String getUser(@PathVariable("id") Long usrId, Model model){
        User user = userService.getUser(usrId);
        model.addAttribute("user",user);
        return "demo/hello";
    }

    
}

页面开发

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>Hello</title>
</head>
<body>
  欢迎您，<span th:text="${user.usrName}">usrName</span>!
</body>
</html>

效果图

Thymeleaf的常用标签及其用法：

1. 数据绑定与文本替换

th:text：用于替换标签体内的文本内容。
```
<span th:text="${user.name}">用户名</span>
```

th:utext：与th:text类似，但会处理HTML标签。

<p th:utext="${htmlContent}">这里会展示HTML内容</p>

2. 条件判断

th:if：用于条件判断，如果条件为真，则显示标签体内容。
```
<span th:if="${user.admin}">管理员</span>
```

th:unless：与th:if相反，条件为假时显示标签体内容。

<a th:href="@{/login}" th:unless="${session.user != null}">Login</a>

3. 循环遍历

th:each：用于遍历集合、数组或Map等。

<ul> 
<li th:each="user : ${userList}" th:text="${user.name}"></li> 
</ul>

4. URL与链接

th:href：用于构建URL。

<a th:href="@{/user/{id}(id=${user.id})}">查看用户</a>

th:action：用于表单的提交地址。

<form th:action="@{/submit}"> 
... 
</form>

5. 样式与属性

th:style：用于设置标签的style属性。

<div th:style="'background-color: ' + ${bgColor} + ';'">...</div>

th:attr：用于设置标签的任意属性。

<img th:attr="src=@{/images/logo.png},alt=${altText}" />

6. 布局与片段

th:fragment：定义一个可以复用的片段（Fragment）。
```
<div th:fragment="header">页眉内容</div>
```

th:include 和 th:replace：用于引入其他模板文件中的片段。

<!-- 引入片段，但保留自己的标签 --> 
<div th:include="header :: header"></div> 


<!-- 替换整个标签为引入的片段 --> 
<div th:replace="footer :: footer"></div>

7. 表达式与内置对象

Thymeleaf支持多种表达式，包括选择变量表达式${...}、选择表达式*{...}、消息表达式#{...}等。此外，它还提供了许多内置对象，如#strings、#numbers、#dates等，用于执行字符串、数字、日期等的操作。

8. 其他常用标签

th:id：用于替换HTML元素的id属性。
th:value：用于设置表单元素的value属性。
th:selected：用于设置下拉框（<select>）中选中的项。
th:checked：用于设置复选框（<input type="checkbox">）或单选按钮（<input type="radio">）的选中状态。
th:switch 和 th:case：用于多路选择，类似于Java中的switch语句。

Thymeleaf的标签库非常丰富，上述只是其中的一部分常用标签。在实际开发中，可以根据项目需求选择合适的标签来简化页面开发。

表达式

1. 变量表达式

语法：${...}
用途：用于在模板中输出变量的值。
示例：<h1 th:text="${pageTitle}">Page Title</h1>

2. 选择变量表达式

语法：*{...}
用途：用于从选定对象中选择属性或调用方法，类似于JSP中的EL表达式。
示例：<p th:text="*{user.name}">Default Name</p>

3. 消息表达式

语法：#{...}
用途：用于获取国际化内容，根据当前环境选择合适的文本。
示例：<span th:text="#{welcome.message}">Welcome!</span>

4. 链接URL表达式

语法：@{...}
用途：用于生成链接或动态URL，支持相对路径和绝对路径。
示例：
- 绝对URL：<a th:href="@{http://www.thymeleaf.org}">Thymeleaf</a>
- 相对URL：<a th:href="@{/product/{id}(id=1)}">Product Details</a>

5. 字面量

文本：'one text', 'another one!'
数值：0, 34, 3.0, 12.3
布尔类型：true, false
空值：null

6. 文本操作

字符串连接：使用+操作符。
示例：<span th:text="'Welcome to our application, ' + ${user.name} + '!'">

7. 算术运算

支持的运算符：+, -, *, /, %
示例：<p th:text="${number1} + ${number2}"></p>

8. 布尔操作

支持的运算符：and, or
非操作符：!, not

9. 关系操作符

比较运算符：>, <, >=, <=（HTML中转义为gt, lt, ge, le）
相等运算符：==, !=（或eq, ne）

10. 条件表达式

If-then：(if) ?(then)
If-then-else：(if) ?(then) : (else)
示例：<tr th:class="${row.even}?'even':'odd'"></tr>

原文地址：https://blog.csdn.net/cuishujian_2003/article/details/142396816

免责声明：本站文章内容转载自网络资源，如本站内容侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！

上一篇：arm和riscv系统调用对比(笔记)
下一篇：数据结构—(java)反射，枚举，lambda表达式

[产品管理-85]：《产品经理从入门到精通》- 创业公司的产品经理
目录一、概述1、创业公司产品经理的角色与定位2、创业公司产品经理的核心能力3、创业公司产品经理的实战技巧4、创业公司产品经理的挑战与应对策略二、创业公司的产品经理与大公司产品经理的比较1、工作环境与资
阅读更多2024-11-18
《TCP/IP网络编程》学习笔记 | Chapter 13：多种 I/O 函数
《TCP/IP网络编程》学习笔记 | Chapter 13：多种 I/O 函数
阅读更多2024-11-18
解决IntelliJ IDEA的Plugins无法访问Marketplace去下载插件
勾选并填入代理URL，可以先做检查连接：
阅读更多2024-11-18
STM32读写内部FLASH
本文是学习野火的指南针开发板过程的学习笔记，可能有误，详细请看B站野火官方配套视频教程（这个教程真的讲的很详细，请给官方三连吧）在STM32芯片内部有一个FLASH存储器，它主要用于存储代码，我们在电
阅读更多2024-11-18
【STM32】基于SPI协议读写SD，详解！
因为项目需要，使用stm32读写sd卡，这一块网上的资料很多，但是比较杂乱。有些是不能跑，有些是代码可以跑，但是相关的注释或者配置方法、流程不够清晰明确，于是花了几天时间，研究了几个成功案例之后，总结
阅读更多2024-11-18
Java基础（9）本地API
哈喽大家好啊，Java基础的学习马上就要告一段落了，今儿分享的是一些Java常用的本地API，让我们开始吧。
阅读更多2024-11-18
Spring gateway 路由配置在数据库
#spring gateway ServerRoute实体类。##spring gateway 查询动态路由mapper。##Spring gateway 动态路由Service。##spring g
阅读更多2024-11-18
i春秋-FUZZ（python模板注入、base64编码命令执行）
i春秋-FUZZ（python模板注入、base64编码命令执行）
阅读更多2024-11-18
Spring 4.3 源码导读
Spring 4 是一个功能强大的 Java 应用程序框架，广泛用于企业级应用开发。理解其核心代码有助于开发者更好地使用和优化 Spring 框架。
阅读更多2024-11-18
【Rabbitmq篇】RabbitMQ⾼级特性----消息确认
介绍RabbitMQ⾼级特性----消息确认
阅读更多2024-11-18