Java之SpringBoot-Thymeleaf详情

2025-03-30 23:54:56

war包代表JavaWeb应用程序，jar包是类的归档文件。war包不仅仅可以包含类的归档文件，它还可以包含 Servlet、HTML页面、Java类、图像文件，以及组成Web应用程序的其他资源。

JAR（Java Archive，Java 归档文件）是与平台无关的文件格式，它允许将许多文件组合成一个压缩文件。JAR 文件格式以流行的 ZIP 文件格式为基础,所以可以直接将jar包后缀改成zip再进行解压即可得到压缩前的文件。与 ZIP 文件不同的是，JAR 文件不仅用于压缩和发布，而且还用于部署和封装库、组件和插件程序，并可被像编译器和 JVM 这样的工具直接使用。包括我们常用的工具以及SpringBoot项目都是jar包。

war是一个可以直接运行的web模块，通常用于网站，打成包部署到容器中。比如我们之前SSM写的web程序可以直接将war包部署到tomcat的webapps目录下，启动tomcat后会自动解压war包，就相当于发布了这个web应用程序。

1、About Thymeleaf

Thymeleaf是SpringBoot中的一个模版引擎，个人认为有点类似于Python中的Jinja2，负责渲染前端页面。

之前写JavaWeb和SSM的时候，前端页面可能会用JSP写，但是因为之前项目都是war包部署，而SpringBoot都是jar包且内嵌tomcat，所以是不支持解析jsp文件的。但是如果是编写纯静态的html就很不方便，那么这时候就需要一个模版引擎类似于Jinja2可以通过表达式帮我们把动态的变量渲染到前端页面，我们只需要写一个template即可。这也就是到了SpringBoot为什么官方推荐要使用Thymeleaf处理前端页面了。

2、Hello Thymeleaf

简单来个demo看一下Thymeleaf效果

Pom.xml中引入依赖

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

Resources/templates/index.html

<!doctype html>

<!--注意：引入thymeleaf的名称空间-->
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <meta name="viewport"
          content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>Document</title>
</head>
<body>
    <div th:text="${msg}"></div>
</body>
</html>

Controller

这里return "index";Thymeleaf会在templats目录下寻找index.html

@Controller
public class IndexController {

    @RequestMapping("/index")
  public String test1(Model model){
      //存入数据
      model.addAttribute("msg","Hello,Thymeleaf");
       //classpath:/templates/index.html
      return "index";
 }
}

也可以参考Thymeleaf的自动配置类。

这里的注解需要使用@Controller，不能使用@RestController注解

如果只是使用@RestController注解Controller，则Controller中的方法无法返回jsp页面，或者html，配置的视图解析器 InternalResourceViewResolver不起作用，返回的内容就是Return 里的内容

如果需要返回到指定页面，则需要用 @Controller配合视图解析器InternalResourceViewResolver才行。如果需要返回JSON，XML或自定义mediaType内容到页面，则需要在对应的方法上加上@ResponseBody注解。

关于@Controller和@RestController

@RestController注解是@Controller和@ResponseBody的合集,表示这是个控制器 bean,并且是将函数的返回值直接填入 HTTP 响应体中,是 REST 风格的控制器。

单独使用 @Controller 不加 @ResponseBody的话一般使用在要返回一个视图的情况，这种情况属于比较传统的 Spring MVC 的应用，对应于前后端不分离的情况。@Controller +@ResponseBody 返回 JSON 或 XML 形式数据

3、Thymeleaf 表达式

3.1配置文件声明

spring:
  thymeleaf:
    cache: false # 缓存关闭，不然我们改变页面之后可能不能及时看到更改的内容，默认是true。
    prefix: classpath:/templates/ #默认扫描的目录去寻找我们return时写的文件名，即模版文件所在位置
    encoding: UTF-8 #编码
    suffix: .html #后缀
    mode: HTML

3.2 常用表达式

3.2.1 0x01 ${} 变量表达式

从web作用域里面取到对应的值，作用域包括 request、session、application。

主要需要注意在template中利用获取 request、session、application 的代码是不一样的

requset: ${ago.id}
Session: ${session.agiao.id}
ServletContext: ${application.abc.id}

也可以通过如下形式获取

<span th:text="${#request.getRequestURL()}"></span><br/>
<span th:text="${#session.getMaxInactiveInterval()}"></span><br/>
<span th:text="${#servletContext.getServerInfo()}"></span>

示例代码：

Controller

@GetMapping("/varExpression")
public String varExpression(HttpServletRequest request, HttpSession session) {

    User ago = new User(1, "Ago", "123");
    request.setAttribute("ago", ago);
    User agiao = new User(2, "Agiao", "123");
    session.setAttribute("agiao", agiao);
    User abc = new User(3, "Abc", "123");
    ServletContext servletContext = request.getServletContext();
    servletContext.setAttribute("abc", abc);

    return "varExpression";
}

templates/varExpression.html

这里及时html中获取request部分有报错也无所谓，不影响正常前端页面显示

<!doctype html>

<!--注意：引入thymeleaf的名称空间-->
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <meta name="viewport"
          content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>Document</title>
</head>
<body>
request： <br/>
<div>
    编号： <label th:text="${ago.id}"></label><br/>
    用户名：<label th:text="${ago.name}"></label> <br/>
    密码：<label th:text="${ago.pwd}"></label><br/>
</div>

session：<br/>
<div>
    编号： <label th:text="${session.agiao.id}"></label><br/>
    用户名：<label th:text="${session.agiao.name}"></label> <br/>
    密码：<label th:text="${session.agiao.pwd}"></label><br/>
</div>

application：<br/>
<div>
    编号：<label th:text="${application.abc.id}"></label><br/>
    用户名：<label th:text="${application.abc.name}"></label><br/>
    密码：<label th:text="${application.abc.pwd}"></label><br/>
</div>

</body>
</html>

3.2.2 0x02 *{} 选择变量表达式#

比较适合偷懒，直接在获取属性值之前先把存储于scope中的整个对象提出来，通过*{}获取该对象的属性值

request： <br/>
<div>
    编号： <label th:text="${ago.id}"></label><br/>
    用户名：<label th:text="${ago.name}"></label> <br/>
    密码：<label th:text="${ago.pwd}"></label><br/>
</div>

session：<br/>
<div>
    编号： <label th:text="${session.agiao.id}"></label><br/>
    用户名：<label th:text="${session.agiao.name}"></label> <br/>
    密码：<label th:text="${session.agiao.pwd}"></label><br/>
</div>

等价于

 request： <br/>
<div th:object="${ago}">
    编号： <label th:text="*{id}"></label><br/>
    用户名：<label th:text="*{name}"></label> <br/>
    密码：<label th:text="*{pwd}"></label><br/>
</div>

session：<br/>
<div th:object="${session.agiao}">
    编号： <label th:text="*{id}"></label><br/>
    用户名：<label th:text="*{name}"></label> <br/>
    密码：<label th:text="*{pwd}"></label><br/>
</div>

3.2.3 0x03 #{} 消息表达式

对于国际化的支持说明

配置文件声明

## 配置国际化支持
spring.messages.basename=message

消息表达式

<span th:text="#{home.welcome}"></span><br />

3.2.4 0x04 @{} 链接表达式

指定跳转的链接

<a th:href="@{/home}" rel="external nofollow" >url</a>

3.2.5 0x05 空值处理

如果为空则输出null，有id值就输出id值

可以在调用对象或者方法的点（.）前面，使用问号（?）来判断是否为null

<span th:text="${session?.user?.id}"></span>

4、标签与属性

常用的属性大致有

th:text 文本显示
th:object 一般和*{}一起用
th:if / th:unless 相当于if/else
th:each 遍历循环元素
th:value 属性赋值

所有的HTML5标签的所有属性都有一个自定义的Thymeleaf属性对应。

Thymeleaf属性只有当Thymeleaf模板引擎启动的情况下，才会生效，即取代对应的HTML5属性，相反，Thymeleaf属性仅仅只是一个无用的自定义属性，因为浏览器内核不认识，因此使用Thymeleaf模板引擎可以使得前端代码和后端代码分离，当出现显示问题时，可以立即定位问题所在（是前端页面还是后台返回数据有错），这也是Thymeleaf相对于JSP的一个优势。

结尾：

简单过了一下Thymeleaf，简单留个印象，相较于JSP个人感觉Thymeleaf这种模版引擎才更像是前后端分离，也更方便了。但是在安全里，往往方便的地方就最容易存在漏洞，后续分析Thymeleaf时再深入研究下。

到此这篇关于Java之SpringBoot-Thymeleaf详情的文章就介绍到这了,更多相关Java之SpringBoot-Thymeleaf内容请搜索我们以前的文章或继续浏览下面的相关文章希望大家以后多多支持我们！

Java SpringBoot高级用法详解

目录 1,IDEA中Lombok作用创建项目 2.pom.xml说明 2.1 pom.xml标签说明 2.2 依赖的相关说明 2.3 SHA1介绍 SpringBoot高级用法 YML文件说明 3.需求说明 3.2利用properties文件为属性赋值总结 1,IDEA中Lombok作用数据库: 库表字段对应的值 user表(id,name,age) 实体对象pojo: 用来封装数据库中的数据 User类(id,name,age) 实体对象方法: Get/Set/toString/无
Java SpringBoot快速集成SpringBootAdmin管控台监控服务详解

目录 1.初识SpringBootAdmin 2.搭建服务端--POM文件中添加相关依赖 3.修改服务端application启动类 4.配置security安全信息 5.启动server服务端 6.搭建client客户端总结 SpringBootAdmin是一个针对 Spring Boot 的 Actuator 接口进行 UI 美化封装的监控工具,它可以在列表中浏览所有被监控 spring-boot 项目的基本信息.详细的 Health 信息.内存信息.JVM 信息.垃圾回收信息.各种配置信
Java基础总结之Thymeleaf详解

一.Thymeleaf语法标签在HTML页面上使用Thymeleaf标签,Thymeleaf 标签能够动态地替换掉静态内容,使页面动态展示.为了大家更直观的认识Thymeleaf,下面展示一个在HTML文件中嵌入了Thymeleaf的页面文件,示例代码如下: <!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta
java编程之基于SpringBoot框架实现扫码登录

目录项目简介实现思路二次认证的原因实现步骤用户访问网页端,选择扫码登录使用手机扫码,二维码状态改变手机确认登录效果演示完整代码已上传到GitHub. Web端体验地址:http://47.116.72.33/(只剩一个月有效期) apk下载地址:https://github.com/zhangjiwei1221/qrscan/releases/tag/0.0.1. 用户名:非空即可,密码:123456,效果见文末,整体实现如有不妥之处,欢迎交流讨论实现部分参考二维码扫码登录是
Java SpringBoot开发小技巧详解

目录一.SpringBoot开发小技巧 1.1 Lombok 1.2 dev-tools 1.3 Spring Initializr 总结一.SpringBoot开发小技巧 1.1 Lombok 作用:在程序编译的时候,自动帮我们生成setter和getter方法以及我们的toString方法和我们的全参和无参构造器等等. 那么,怎么用呢?很简单,用下边这四个注解就行了: 1.@Data:自动生成setter和getter方法. 2.@ToString:自动生成toString方法. 3.@
Java SpringBoot+vue+实战项目详解

目录 1.<锋迷商城>业务流程设计-接⼝规范 1.1 前后端分离与单体架构流程实现的区别 1.1.1单体架构 1.1.2 前后端分离架构 1.2 接口介绍 1.2.1接口概念 1.2.2接口规范 1.3 Swagger 1.3.1作用 1.3.2 Swagger整合 1.3.3 Swagger注解说明 1.3.4 Swagger-ui 插件 1.4 RESTful 总结 1.<锋迷商城>业务流程设计-接⼝规范在企业项⽬开发中,当完成项⽬的需求分析.功能分析.数据库分析与设计之后,
极为简易的Qno SmartLink IPSec VPN设定

VPN--Virtual Private Network,是针对在互联网技术及应用不断发展中,企业及特定用户对信息交流.传递.交换的安全性.可靠性及成本上的需求,在公共互联网的基础上,通过遂道和加密技术,构建虚拟专用网的解决方案. VPN构建中的一项重要的核心任务是遂道技术,而IPSec--因特网安全协议(即遂道协议)是VPN技术中较为成熟的遂道协议.相对于PPTP.SSL这两种协议来说, IPSec虽然公认是最值得信赖和安全的VPN协议,但同时也是出名的难以设置,安装配置和管理都比较复杂,尤其
Java基础之Thymeleaf的简单使用

Java代码 package com.zzx.controller; import com.zzx.model.User; import org.springframework.stereotype.Controller; import org.springframework.ui.Model; import org.springframework.web.bind.annotation.RequestMapping; import java.util.Arrays; /** * @date:
Java Springboot的目的你知道吗

目录 Spring-boot目的 Spring如何简化开发第一个spring-boot程序总结 Spring-boot目的 Spring是为了解决企业应用开发的复杂性而创建的,简化开发 Spring如何简化开发 1.基于POJO的轻量级和最小侵入性编程 2.通过IOC,依赖注入(DI)和面向接口实现松耦合 3.基于(AOP)和惯例进行声明式编程 4.基于切面和模板减少样式代码微服务第一个spring-boot程序官方提供了一个快速生成的网站!idea集成了这个网站 1可以在官网下载后,
Java之SpringBoot自定义配置与整合Druid

目录 1.SpringBoot配置文件 1.1 优先级 1.2 yaml的多文档配置 2.扩展SpringMVC 2.1 添加自定义视图解析器 3.自定义DruidDataSources 3.1 About Druid 3.2 添加依赖 3.3 配置数据源 3.4 其他配置 3.5 Druid配置类 3.6 数据源监控 3.7 监控过滤器filter配置 1.SpringBoot配置文件 1.1 优先级关于SpringBoot配置文件可以是properties或者是yaml格式的文件,但是在S