SpringBoot-08 Thymeleaf模板引擎

最新推荐文章于 2023-03-11 13:52:17 发布
最新推荐文章于 2023-03-11 13:52:17 发布
阅读量123 收藏
点赞数
分类专栏： 微服务 文章标签： spring boot java 后端
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_34172440/article/details/120876443
版权
本文介绍了Thymeleaf作为SpringBoot推荐的模板引擎，它的作用、引入方式以及基本使用。通过自动配置，Thymeleaf可以处理类路径下templates目录中的HTML文件。文章还涵盖了Thymeleaf的测试、语法学习和实际操作，强调了官方文档在学习过程中的重要性。
摘要由CSDN通过智能技术生成

参考地址：https://mp.weixin.qq.com/s?__biz=Mzg2NTAzMTExNg==&mid=2247483807&idx=1&sn=7e1d5df51cdeb046eb37dec7701af47b&scene=19#wechat_redirect

Thymeleaf 模板引擎

1、Thymeleaf

1.1 模板引擎

前端交给我们的页面，是 html 页面。如果是我们以前开发，我们需要把他们转成 jsp 页面，jsp 好处就是当我们查出一些数据转发到 JSP 页面以后，我们可以用 jsp 轻松实现数据的显示，及交互等。

jsp 支持非常强大的功能，包括能写 Java 代码，但是呢，我们现在的这种情况，SpringBoot 这个项目首先是以 jar 的方式，不是 war，像第二，我们用的还是嵌入式的 Tomcat，所以呢，他现在默认是不支持 jsp 的。

那不支持 jsp，如果我们直接用纯静态页面的方式，那给我们开发会带来非常大的麻烦，那怎么办呢？

SpringBoot 推荐你可以来使用模板引擎：

模板引擎，我们其实大家听到很多，其实jsp就是一个模板引擎，还有用的比较多的 freemarker，包括 SpringBoot 给我们推荐的 Thymeleaf，模板引擎有非常多，但再多的模板引擎，他们的思想都是一样的，什么样一个思想呢我们来看一下这张图：

在这里插入图片描述

模板引擎的作用就是我们来写一个页面模板，比如有些值呢，是动态的，我们写一些表达式。而这些值，从哪来呢，就是我们在后台封装一些数据。然后把这个模板和这个数据交给我们模板引擎，模板引擎按照我们这个数据帮你把这表达式解析、填充到我们指定的位置，然后把这个数据最终生成一个我们想要的内容给我们写出去，这就是我们这个模板引擎，不管是 jsp 还是其他模板引擎，都是这个思想。只不过呢，就是说不同模板引擎之间，他们可能这个语法有点不一样。其他的我就不介绍了，我主要来介绍一下S pringBoot 给我们推荐的 Thymeleaf 模板引擎，这模板引擎呢，是一个高级语言的模板引擎，他的这个语法更简单。而且呢，功能更强大。

我们呢，就来看一下这个模板引擎，那既然要看这个模板引擎。首先，我们来看 SpringBoot 里边怎么用。

1.2 引入 Thymeleaf

怎么引入呢，对于 springboot 来说，什么事情不都是一个 start 的事情嘛，我们去在项目中引入一下。给大家三个网址：

Thymeleaf 官网：https://www.thymeleaf.org/

Thymeleaf 在 Github 的主页：https://github.com/thymeleaf/thymeleaf

Spring 官方文档：找到我们对应的版本

https://docs.spring.io/spring-boot/docs/2.2.5.RELEASE/reference/htmlsingle/#using-boot-starter

找到对应的 pom 依赖：可以适当点进源码看下本来的包！

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

Maven 会自动下载 jar 包

在这里插入图片描述

1.3 Thymeleaf 分析

前面呢，我们已经引入了 Thymeleaf，那这个要怎么使用呢？

我们首先得按照 SpringBoot 的自动配置原理看一下我们这个 Thymeleaf 的自动配置规则，在按照那个规则，我们进行使用。

我们去找一下 Thymeleaf 的自动配置类：ThymeleafProperties

@ConfigurationProperties(
    prefix = "spring.thymeleaf"
)
public class ThymeleafProperties {
    private static final Charset DEFAULT_ENCODING;
    public static final String DEFAULT_PREFIX = "classpath:/templates/";
    public static final String DEFAULT_SUFFIX = ".html";
    private boolean checkTemplate = true;
    private boolean checkTemplateLocation = true;
    private String prefix = "classpath:/templates/";
    private String suffix = ".html";
    private String mode = "HTML";
    private Charset encoding;
    private boolean cache;
    private Integer templateResolverOrder;
    private String[] viewNames;
    private String[] excludedViewNames;
    private boolean enableSpringElCompiler;
    private boolean renderHiddenMarkersBeforeCheckboxes;
    private boolean enabled;
    private final ThymeleafProperties.Servlet servlet;
    private final ThymeleafProperties.Reactive reactive;
    
    // ...
    
}

我们可以在其中看到默认的前缀和后缀！

我们只需要把我们的html页面放在类路径下的 templates 下，thymeleaf 就可以帮我们自动渲染了。

使用 thymeleaf 什么都不需要配置，只需要将他放在指定的文件夹下即可！

2、测试

步骤：

  1. 编写一个 TestController

    package com.aze.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class TestController {

    @RequestMapping("/t1")
    public String test(){
        // classpath:/templates/test.html
        return "test";
    }

}

  2. 编写一个测试页面 test.html 放在 templates 目录下

    <!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>

<h1>测试</h1>

</body>
</html>

  3. 启动项目请求测试

    在这里插入图片描述

3、Thymeleaf 语法学习

要学习语法，还是参考官网文档最为准确，我们找到对应的版本看一下；

Thymeleaf 官网：https://www.thymeleaf.org/ ， 简单看一下官网！我们去下载 Thymeleaf 的官方文档！

我们做个最简单的练习 ：我们需要查出一些数据，在页面中展示

  1. 修改测试请求，增加数据传输

    package com.aze.controller;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class TestController {
    @RequestMapping("/t1")
    public String test(Model model){
        // 存入数据
        model.addAttribute("msg","Hello,SpringBoot!");
        // classpath:/templates/test.html
        return "test";
    }
}

  2. 我们要使用 thymeleaf，需要在 html 文件中导入命名空间的约束，方便提示。

    • 我们可以去官方文档的#3中看一下命名空间拿来过来：
    <html lang="en" xmlns:th="http://www.thymeleaf.org">

  3. 编写前端页面

    <!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>

<h1>测试</h1>
<!--th:text就是将div中的内容设置为它指定的值，和之前学习的Vue一样-->
<div th:text="${msg}"></div>

</body>
</html>

  4. 测试

    在这里插入图片描述

4、Thymeleaf的使用语法

OK，入门搞定，我们来认真研习一下 Thymeleaf 的使用语法！

  1. 我们可以使用任意的 th:attr 来替换 Html 中原生属性的值！

    在这里插入图片描述

  2. 表达式

    
Simple expressions:（表达式语法）
Variable Expressions: ${...}：获取变量值；OGNL；
    1）、获取对象的属性、调用方法
    2）、使用内置的基本对象：#18
         #ctx : the context object.
         #vars: the context variables.
         #locale : the context locale.
         #request : (only in Web Contexts) the HttpServletRequest object.
         #response : (only in Web Contexts) the HttpServletResponse object.
         #session : (only in Web Contexts) the HttpSession object.
         #servletContext : (only in Web Contexts) the ServletContext object.

    3）、内置的一些工具对象：
　　　　　　#execInfo : information about the template being processed.
　　　　　　#uris : methods for escaping parts of URLs/URIs
　　　　　　#conversions : methods for executing the configured conversion service (if any).
　　　　　　#dates : methods for java.util.Date objects: formatting, component extraction, etc.
　　　　　　#calendars : analogous to #dates , but for java.util.Calendar objects.
　　　　　　#numbers : methods for formatting numeric objects.
　　　　　　#strings : methods for String objects: contains, startsWith, prepending/appending, etc.
　　　　　　#objects : methods for objects in general.
　　　　　　#bools : methods for boolean evaluation.
　　　　　　#arrays : methods for arrays.
　　　　　　#lists : methods for lists.
　　　　　　#sets : methods for sets.
　　　　　　#maps : methods for maps.
　　　　　　#aggregates : methods for creating aggregates on arrays or collections.
==================================================================================

  Selection Variable Expressions: *{...}：选择表达式：和${}在功能上是一样；
  Message Expressions: #{...}：获取国际化内容
  Link URL Expressions: @{...}：定义URL；
  Fragment Expressions: ~{...}：片段引用表达式

Literals（字面量）
      Text literals: 'one text' , 'Another one!' ,…
      Number literals: 0 , 34 , 3.0 , 12.3 ,…
      Boolean literals: true , false
      Null literal: null
      Literal tokens: one , sometext , main ,…
      
Text operations:（文本操作）
    String concatenation: +
    Literal substitutions: |The name is ${name}|
    
Arithmetic operations:（数学运算）
    Binary operators: + , - , * , / , %
    Minus sign (unary operator): -
    
Boolean operations:（布尔运算）
    Binary operators: and , or
    Boolean negation (unary operator): ! , not
    
Comparisons and equality:（比较运算）
    Comparators: > , < , >= , <= ( gt , lt , ge , le )
    Equality operators: == , != ( eq , ne )
    
Conditional operators:条件运算（三元运算符）
    If-then: (if) ? (then)
    If-then-else: (if) ? (then) : (else)
    Default: (value) ?: (defaultvalue)
    
Special tokens:
    No-Operation: _

练习测试：

  1. 我们编写一个 Controller，放一些数据
@RequestMapping("/t2")
public String test2(Map<String,Object> map){
    //存入数据
    map.put("msg","<h1>Hello</h1>");
    map.put("users", Arrays.asList("a","b","c","d"));
    //classpath:/templates/test.html
    return "test";
}

  1. 测试页面取出数据

    <!--th:text就是将div中的内容设置为它指定的值，和之前学习的Vue一样-->
<div th:text="${msg}"></div>
<!--不转义-->
<div th:utext="${msg}"></div>

<hr>

<!--遍历数据-->
<!--th:each每次遍历都会生成当前这个标签：官网#9（推荐，前后端分离）-->
<h4 th:each="user :${users}" th:text="${user}"></h4>
<h4>
    <!--行内写法：官网#12-->
    <span th:each="user:${users}">[[${user}]]</span>
</h4>

  2. 测试

    在这里插入图片描述

语法，很多样式，我们即使现在学习了，也会忘记，所以我们在学习过程中，需要使用什么，根据官方文档来查询，才是最重要的，要熟练使用官方文档！

开玩喜66
关注
专栏目录
【SpringBoot】3、SpringBoot中整合Thymeleaf模板引擎
Asurplus
04-16 21万+
SpringBoot 为我们提供了 Thymeleaf 自动化配置解决方案，所以我们在 SpringBoot 中使用 Thymeleaf 非常方便 一、简介 Thymeleaf是一个流行的模板引擎，该模板引擎采用Java语言开发，模板引擎是一个技术名词，是跨领域跨平台的概念，在Java语言体系下有模板引擎，在C#、PHP语言体系下也有模板引擎。除了thymeleaf之外还有Velocity、Fr...
SpringBoot03-整合ThymeLeaf模板引擎的使用
花哥的博客
08-20 553
thymeleaf模板引擎的使用 ​ 在早期开发的时候，我们完成的都是静态页面也就是html页面，随着时间轴的发展，慢慢的引入了jsp页面，当在后端服务查询到数据之后可以转发到jsp页面，可以轻松的使用jsp页面来实现数据的显示及交互，jsp有非常强大的功能，但是，在使用springboot的时候，整个项目是以jar包的方式运行而不是war包，而且还嵌入了tomcat容器，因此，在默认情况下是不支持jsp页面的。如果直接以纯静态页面的方式会给我们的开发带来很大的麻烦，springboot推荐使用模板引擎。
Spring Boot 之 thymeleaf
踏 浪的博客
09-24 552
一、thymeleaf 简介 thymeleaf 是一种现代化服务端的模板引擎，能处理HTML，XML，JavaScript，CSS 甚至纯文本数据。 常见的模板引擎：thymeleaf、freemarker 和 JSP，Spring Boot 中默认是不支持 JSP。 官网文档：https://www.thymeleaf.org/doc/tutorials/3.0/usingthymel...
Spring Boot——Thymeleaf
热门推荐
一心同学的博客
12-25 2万+
通俗易懂地讲解Thymeleaf的基本语法以及其使用规则，用通俗易懂的文笔讲解Thymeleaf的使用。
SpringBoot之Thymeleaf
菜鸟清风http://www.hphblog.cn/
03-29 259
探究Thymeleaf模板引擎： 简介Thymeleaf是用于Web和独立环境的现代服务器端Java模板引擎。 Thymeleaf的主要目标是将优雅的自然模板带到您的开发工作流程中—HTML能够在浏览器中正确显示，并且可以作为静态原型，从而在开发团队中实现更强大的协作。Thymeleaf能够处理HTML，XML，JavaScript，CS...
spring boot(四)：thymeleaf使用详解
weixin_33804990的博客
09-02 4125
在上篇文章springboot(二)：web综合开发中简单介绍了一下thymeleaf，这篇文章将更加全面详细的介绍thymeleaf的使用。thymeleaf 是新一代的模板引擎，在spring4.0中推荐使用thymeleaf来做前端模版引擎。 thymeleaf介绍 简单说， Thymeleaf 是一个跟 Velocity、FreeMarker 类似的模板引擎，它可以完全替代 JSP 。相...
springboot Thymeleaf
tiancxz的专栏
02-02 100
引入依赖pom.xml 主要增加spring-boot-starter-thymeleaf和nekohtml这两个依赖 spring-boot-starter-thymeleaf：Thymeleaf 自动配置 nekohtml：允许使用非严格的 HTML 语法 <dependency> <groupId>org.spr...
SpringBoot：Thymeleaf模板引擎
yooppa的博客
08-17 199
Thymeleaf
Spring Boot-09：Thymeleaf模板引擎
qianyikang的博客
06-21 149
Thymeleaf基本语法 相关语法 ，请学习《thymeleaf_3.0.5_中文参考手册.pdf》 提取码：fqpu 1、Thymeleaf常用标签 th:标签 说明 th:insert 页面片段包含（类似JSP中的include标签） th:replace 页面片段包含（类似JSP中的include标签） th:each 元素遍历（类似JSP中的c:forEach标签） th:if 条件判断，如果为真 th:unless 条件判断，如果为假 th:switch 条件判断，进行选择性匹配 th:case
springboot框架+thymeleaf模板引擎+layui前端框架+数据库
12-19
本文将详细讲解基于SpringBoot框架、Thymeleaf模板引擎、Layui前端框架以及数据库集成的开源项目。该项目还涉及到了Redis缓存技术，旨在提供一个高效、易用的Web应用开发方案。 首先，SpringBoot是Spring生态系统的...
Springboot怎么集成Thymeleaf模板引擎？
03-07
Springboot 集成 Thymeleaf 模板引擎 Thymeleaf 是一个 XML/XHTML/HTML 模板引擎，开源的 Java 库，可以用于 SpringMVC 项目中，用于代替 JSP、FreeMarker 或者其他的模板引擎。它的主要特点是页面与数据分离，提高...
Spring Boot集成Thymeleaf模板引擎的完整步骤
08-26
Spring Boot集成Thymeleaf模板引擎的完整步骤 本文将为大家介绍Spring Boot集成Thymeleaf模板引擎的完整步骤，从基本概念到实际配置，详细地介绍了Thymeleaf模板引擎的使用方法。 一、Thymeleaf模板引擎概述 ...
SpringBoot Thymeleaf
zhangzhiping35的专栏
10-10 253
在SpringBoot【SSM+JSP篇】中使用了JSP来作为视图，需要我们自己将项目打成war包，并且部署到Tomcat上，随后项目才可以访问，觉得这有点麻烦，对于SpringBoot这个微服务框架来说，如果使用Thymeleaf或者FreeMarker模板引擎，那么就可以直接打成jar包运行了，而且使用模板引擎，相对于JSP来说，优点多多，那么就来看看什么是Thymeleaf。 本文只是简单...
springboot-thymeleaf
张锦的博客
04-24 2343
目录 一、thymeleaf简介 二、使用thymeleaf 1、添加依赖 2、在模板文件中加入解析 三、配置视图解析器 四、基础语法 1、引用命名空间 2、常用th标签 （1）th:text （2）th:object （3）th:action （4）th:value 3、thymeleaf中的URL写法 4、使用thymeleaf进行条件求值 五、th:switch……th:case 一、thymeleaf简介 Thymeleaf 可以轻易地与 Spring M.
springboot之thymeleaf
最新发布
梦想是很难很难的，所以先勇敢一点
03-11 4234
模板引擎（这里特指用于Web开发的模板引擎）是为了使用户界面与业务数据（内容）分离而产生的，它可以生成特定格式的文档，用于网站的模板引擎就会生成一个标准的html文档。从字面上理解模板引擎，最重要的就是模板二字，这个意思就是做好一个模板后套入对应位置的数据，最终以html的格式展示出来，这就是模板引擎的作用。模板引擎的功能就类似我们的会议室开会一样开箱即用，将模板设计好之后直接填充数据即可而不需要重新设计整个页面。提高页面、代码的复用性。
Spring boot 中使用 Thymeleaf
Somuns的博客
11-16 336
Thymeleaf  是一个java类库，他是一个xml/xhtml/html5的模板引擎，可使用在MVC的Web应用的View层.
SpringBoot（模板Thymeleaf）
weixin_43908530的博客
06-12 198
模板Thymeleaf 相关配置： <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-thymeleaf</artifactId> </dependency> 在 application.properties 中添加配置： spring.thymeleaf.cache=false 其中，properties
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值