8、SpringBoot:thymeleaf模板引擎
文章目录
7.1、模板引擎
前端交给我们的页面,是html页面。如果是我们以前开发,我们需要把他们转成jsp页面,jsp好处就是当我们查出一些数据转发到JSP页面以后,我们可以用jsp轻松实现数据的显示,及交互等。
jsp支持非常强大的功能,包括能写Java代码,但是呢,我们现在的这种情况,SpringBoot这个项目首先是以jar的方式,而不是war,像第二,第二,我们用的还是嵌入式的Tomcat,所以呢,他现在默认是不支持jsp的。
那么不支持jsp,如果我们直接用纯静态页面的方式,拿给我们开发会带来非常大的麻烦,那怎么办呢?
SpringBoot推荐你可以来使用模板引擎:
模板引擎,我们其实听到很多,其实jsp就是一个模板引擎,还有用的比较多的freemarker,包括SpringBoot给我们推荐的Thymleaf,模板引擎有非常多,但再多的模板引擎,他们的思想都是一样的,什么样一个思想呢?我们来看以下这张图:
模板引擎的作用就是我们来写一个页面模板,比如有些值呢,是动态的,我们写一些表达式。而这些值,从哪来呢,就是我们在后台封装的一些数据。然后把这个模板和这个数据交给我们模板引擎,模板引擎按照我们这个数据帮你把表达式解析、填充到我们指定的位置,然后把这个数据最终生成一个我们想要的内容给我们写出去,这就是我们这个模板引擎,不管是jsp还是其它模板引擎,都是这个思想。只不过呢,就是说不同模板引擎之间,它们可能这个语法有点不一样。我主要来介绍一下SpringBoot给我们推荐的Thymeleaf模板引擎,这模板引擎呢,是一个高级语言的模板引擎,他的这个语法更简单。而且呢,功能更强大。
我们呢,就来看一下这个模板引擎,那既然要看这个模板引擎。首先,我们来看SpringBoot里边怎么用。
7.2、引入Thymeleaf
怎么引入呢,对于springboot来说,什么事情不都是一个starter的事情嘛,我们去在项目中一下。给大家介绍三个网址:
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包,我们可以去看下下载的东西;
7.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; //... }
我们可以再其中看到默认的前缀和后缀!
我们只需要把我们的html页面放在类路径下的templates下,thymeleaf就可以帮我们自动渲染了。
使用thymeleaf什么都不需要配置,只需要将他放在指定的文件夹下即可!
测试
- 编写一个TestController
//在templates目录下的所有页面,只能通过controller来跳转! //这个需要模板引擎的支持! thymeleaf @Controller public class TestController { @RequestMapping("/test") public String index(){ return "test"; } }
- 编写一个测试页面test.html 放在templates目录下
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Title</title> </head> <body> <h1>测试页面</h1> </body> </html>
- 启动项目请求测试
7.4、Thymeleaf 语法学习
要学习语法,还是参考官方文档最为准确,我们找到对应的版本看一下;
Thymeleaf 官网:https://www.thymeleaf.org/,简单看一下官网!我们去下载Thymeleaf的官方文档!
我们做个最简单的练习:我们需要查出一些数据,在页面中展示
- 修改测试请求,增加数据传输
@RequestMapping("/test") public String index(Model model){ model.addAttribute("msg","hello"); return "test"; }
- 我们要使用thymeleaf,需要在html文件中导入命名空间的约束,方便提示。
我们可以去官方文档的#3中看一下命名空间拿过来;
xmlns:th="http://www.thymeleaf.org"
- 我们去编写下前端页面
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>Title</title> </head> <body> <!--所有的html元素都可以被thymeleaf替换接管 : th:元素吗--> <h1 th:text="${msg}"></h1> </body> </html>
- 启动测试
OK,入门搞定,我们来认真学习一下Thymeleaf的使用语法!
-
我们可以使用热议的 th:attr 来替换Html中原生属性的值!
-
我们能写哪些表达式呢?
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: _
练习测试
- 我们编写一个Controller,放一些数据
@RequestMapping("/test") public String index(Model model){ model.addAttribute("msg","<h1>hello</h1>"); model.addAttribute("users", Arrays.asList("张三","李四")); return "test"; }
- 测试页面取出数据
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>Title</title> </head> <body> <!--所有的html元素都可以被thymeleaf替换接管 : th:元素吗--> <h1 th:text="${msg}"></h1> <h1 th:utext="${msg}"></h1> <!-- 写法一 --> <!--th:each每次遍历都会生成当前这个标签:官网#9--> <h3 th:each="user:${users}" th:text="${user}"></h3> <!-- 写法二 行内写法 --> <h3 th:each="user:${users}" >[[${user}]]</h3> </body> </html>
- 启动测试项目
7.5、关闭缓存
有些版本,如果引入静态资源不起作用的话,需要在配置文件中将thymeleaf的缓存关闭。
spring.thymeleaf.cache=false
- Springboot系列:Springboot与Thymeleaf模板引擎整合基础教程(附源码)
- Springboot系列:Springboot与Thymeleaf模板引擎整合基础教程(附源码)
- Springboot系列:Springboot与Thymeleaf模板引擎整合基础教程(附源码)
- Springboot系列:Springboot与Thymeleaf模板引擎整合基础教程(附源码)
- Springboot系列:Springboot与Thymeleaf模板引擎整合基础教程(附源码)
- springboot配置模板引擎thymeleaf
- SpringBoot集成Thymeleaf模板引擎,并实现页面实时刷新
- Springboot系列:Springboot与Thymeleaf模板引擎整合基础教程(附源码)
- Springboot系列:Springboot与Thymeleaf模板引擎整合基础教程(附源码)
- Springboot系列:Springboot与Thymeleaf模板引擎整合基础教程(附源码)
- Springboot系列:Springboot与Thymeleaf模板引擎整合基础教程(附源码)
- Springboot系列:Springboot与Thymeleaf模板引擎整合基础教程(附源码)
- Springboot系列:Springboot与Thymeleaf模板引擎整合基础教程(附源码)
- Springboot系列:Springboot与Thymeleaf模板引擎整合基础教程(附源码)
- Springboot系列:Springboot与Thymeleaf模板引擎整合基础教程(附源码)
- springboot之模板引擎 --- thymeleaf
- Spring Boot入门初体验(4) --配置thymeleaf模板引擎
- 快速搭建springboot项目,并整合mybatis+druid以及thymeleaf模板引擎
- Spring-boot学习笔记(一)gradle安装、集成eclipse、导入gradle项目、集成Thymeleaf模板引擎
- springboot整合模板引擎