Skip to content
开发传统Java WEB工程时,我们可以使用JSP页面模板语言,但是在SpringBoot中已经不推荐使用了。SpringBoot支持如下页面模板语言

Thymeleaf

FreeMarker

Velocity

Groovy

JSP

上面并没有列举所有SpringBoot支持的页面模板技术。其中Thymeleaf是SpringBoot官方所推荐使用的,下面来谈谈Thymeleaf一些常用的语法规则。
添加Thymeleaf依赖
要想使用Thhymeleaf,首先要在pom.xml文件中单独添加Thymeleaf依赖。
==\<====dependency====\>======    ==\<====groupId====\>org.springframework.boot\</====groupId====\>======    ==\<====artifactId====\>spring-boot-starter-thymeleaf\</====artifactId====\>========\</====dependency====\>==
Spring Boot默认存放模板页面的路径在==src/main/resources/templates==或者==src/main/view/templates==,这个无论是使用什么模板语言都一样,当然默认路径是可以自定义的,不过一般不推荐这样做。另外Thymeleaf默认的页面文件后缀是==.html==。
数据显示
在MVC的开发过程中,我们经常需要通过==Controller==将数据传递到页面中,让页面进行动态展示。
显示普通文本
创建一个Controller对象,在其中进行参数的传递
==@Controller========public class== ==ThymeleafController {==
==@RequestMapping====(value== ===== =="show"====, method== ===== ==RequestMethod.GET)======    ==public== ==String== ==show====(Model model){======        ==model.====addAttribute====(===="uid"====,===="123456789"====);======        ==model.====addAttribute====(===="name"====,===="Jerry"====);======        ==return== =="show"====;======    ==}========}==
在SpringBoot默认的页面路径下创建show.html文件,内容如下
==\<!DOCTYPE HTML\>========\<====html xmlns:th====="====http://www.thymeleaf.org===="\>========\<====head====\>======    ==\<====title====\>SpringBoot====模版渲染====\</====title====\>======    ==\<====meta http-equiv====="====Content-Type===="== ==content====="====text/html;charset=UTF-8===="/\>========\</====head====\>========\<====body====\>======    ==\<====p th:text====="'====用户====ID====:====' + ${uid}===="/\>======    ==\<====p th:text====="'====用户名称:====' + ${name}===="/\>========\</====body====\>========\</====html====\>==
可以看到在==p==标签中有==th:text==属性,这个就是thymeleaf的语法,它表示显示一个普通的文本信息。
如果我们要显示的信息是存在资源文件中的,同样可以在页面中显示,例如资源文件中定义了内容==welcome.msg=====欢迎===={0}====光临!==。可以在页面中将其显示
==\<====h2 th====:text========="====#{====welcome====.====msg====(===='admin'====)====}===="====/\>==
另外,在==th:utext==中还能做一些基础的数学运算
==\<====p th:text====="'====数学计算:====1+2=' + (1 + 2)===="/\>==
显示带有样式的普通文本
如果我们想要传递到的页面的信息,它本身是带有CSS样式的,这个时候如何在页面中将携带的样式信息也显示出来?此时我们的控制器方法这样写。
==@RequestMapping====(value== ===== =="showStyle"====, method== ===== ==RequestMethod.GET)========public== ==String== ==showStyle====(Model model){======    ==model.====addAttribute====(===="uid"====,===="123456789"====);======    ==model.====addAttribute====(===="name"====,===="\<span style='color:red'\>Jerry\</span\>"====);======    ==return== =="show_style"====;========}==
此时页面中需要借助==th:utext==属性进行显示
==\<p th:utext="'====用户名称:====' + ${name}"/\>==
通过浏览器查看页面源码可以看出==th:utext==和==th:text==的区别是:==th:text==会对==\<==和==\>==进行转义,而==th:utext==不会转义。
显示对象
我们常常需要将一个bean信息展示在前端页面当中。

用于前端展示的VO类

==public class== ==User== ==implements== ==Serializable== =={======    ==private== ==Long== ==uid ;======    ==private== ==String== ==name ;======    ==private== ==Integer== ==age ;======    ==private== ==Date== ==birthday ;======    ==private== ==Double== ==salary ;======    ==//====省略====get/set====方法========}==

控制器方法

==@====RequestMapping====(value== ===== =="/message/member_show"====, method== ===== ==RequestMethod.====GET====)========public== ==String== ==memberShow====(Model model) {======    ==User vo== ===== ==new== ==User====();======    ==vo.====setUid====(====12345678====L);======    ==vo.====setName====(===="====尼古拉丁====.====赵四===="====);======    ==vo.====setAge====(====59====);======    ==vo.====setSalary====(====1000.00====);======    ==vo.====setBirthday====(====new== ==Date====());======    ==model.====addAttribute====(===="member"====, vo);======    ==return== =="message/member_show"====;========}==

页面展示

==\<====div====\>======    ==\<====p th:text====="'====用户编号:====' + ${member.uid}===="/\>======    ==\<====p th:text====="'====用户姓名:====' + ${member.name}===="/\>======    ==\<====p th:text====="'====用户年龄:====' + ${member.age}===="/\>======    ==\<====p th:text====="'====用户工资:====' + ${member.salary}===="/\>======    ==\<====p th:text====="'====出生日期:====' + ${member.birthday}===="/\>======    ==\<====p th:text====="'====出生日期:====' + ${#dates.format(member.birthday,'yyyy-MM-dd')}===="/\>========\</====div====\>==
==\<====hr====/\>========\<====div th:object====="====${member}===="\>======    ==\<====p th:text====="'====用户编号:====' + *{uid}===="/\>======    ==\<====p th:text====="'====用户姓名:====' + *{name}===="/\>======    ==\<====p th:text====="'====用户年龄:====' + *{age}===="/\>======    ==\<====p th:text====="'====用户工资:====' + *{salary}===="/\>======    ==\<====p th:text====="'====出生日期:====' + *{birthday}===="/\>======    ==\<====p th:text====="'====出生日期:====' + *{#dates.format(birthday,'yyyy-MM-dd')}===="/\>========\</====div====\>==
上面给出了两种展现方式,一种是通过${属性},另外一种是通过_{__属性__}__。_
_关于“__${__属性__}__”和“__{__属性__}__”的区别?_
_$__访问完整信息,而_访问指定对象中的属性内容, 如果访问的只是普通的内容两者没有区别;
数据处理
在 thymeleaf 之中提供有相应的集合的处理方法,例如:在使用 List 集合的时候可以考虑采用 get()方法获取指定索引的数据,那么在使用 Set 集合的时候会考虑使用 contains()来判断某个数据是否存在,使用 Map 集合的时候也希望可以使用 containsKey()判断某个 key 是否存在,以及使用get()根据 key 获取对应的 value,而这些功能在之前并不具备,下面来观察如何在页面中使用此类操作

控制器方法向页面传递一些数据,以供操作

==@RequestMapping====(value== ===== =="/user/set"====, method== ===== ==RequestMethod.GET)========public String== ==set====(Model model) {======    ==Set====\<====String====\>== ==allNames== ===== ==new== ==HashSet====\<====String====\>====() ;======    ==List====\<====Integer====\>== ==allIds== ===== ==new== ==ArrayList====\<====Integer====\>====() ;======    ==for== ==(int x== ===== ==0== ==; x== ==\<== ==5== ==; x== ==++====) {======        ==allNames.====add====(===="boot-"== ==+== ==x) ;======        ==allIds.====add====(x) ;======    ==}======    ==model.====addAttribute====(===="names"====, allNames) ;======    ==model.====addAttribute====(===="ids"====, allIds) ;======    ==model.====addAttribute====(===="mydate"====,== ==new== ==java====.====util====.====Date====()) ;======    ==return== =="user_set"== ==;========}==

数据处理

==\<====body====\>======    ==\<====p th:text========="${#dates.format(mydate,'yyyy-MM-dd')}"====/\>======    ==\<====p th:text========="${#dates.format(mydate,'yyyy-MM-dd HH:mm:ss.SSS')}"====/\>======    ==\<====hr====/\>======    ==\<====p th:text========="${#strings.replace('www.baidu.cn','.','$')}"====/\>======    ==\<====p th:text========="${#strings.toUpperCase('www.baidu.cn')}"====/\>======    ==\<====p th:text========="${#strings.trim('www.baidu.cn')}"====/\>======    ==\<====hr====/\>======    ==\<====p th:text========="${#sets.contains(names,'boot-0')}"====/\>======    ==\<====p th:text========="${#sets.contains(names,'boot-9')}"====/\>======    ==\<====p th:text========="${#sets.size(names)}"====/\>======    ==\<====hr====/\>======    ==\<====p th:text========="${#sets.contains(ids,0)}"====/\>======    ==\<====p th:text========="${ids[1]}"====/\>======    ==\<====p th:text========="${names[1]}"====/\>========\</====body====\>==
路径处理
在传统WEB工程开发时,路径的处理操作是有点麻烦的。SpringBoot中为我们简化了路径的处理。

在"src/main/view/static/js"中创建一个js文件

js文件路径

然后在页面中可以通过“@{路径}”来引用。

==\<====script type====="====text/javascript===="== ==th:src====="====@{/js/main.js}===="\>\</====script====\>==
页面之间的跳转也能通过@{}来实现
==\<====a th:href====="====@{/show}===="\>====访问====controller====方法====\</====a====\>========\<====a th:href====="====@{/static_index.html}===="\>====访问静态页面====\</====a====\>==
操作内置对象
虽然在这种模版开发框架里面是不提倡使用内置对象的,但是很多情况下依然需要使用内置对象进行处理,所以下面来看下如何在页面中使用JSP内置对象。

在控制器里面增加一个方法,这个方法将采用内置对象的形式传递属性。

==@RequestMapping====(value== ===== =="/inner"====, method== ===== ==RequestMethod.GET)========public== ==String== ==inner====(HttpServletRequest request, Model model) {======    ==request.====setAttribute====(===="requestMessage"====,== =="springboot-request"====);======    ==request.====getSession====().====setAttribute====(===="sessionMessage"====,== =="springboot-session"====);======    ==request.====getServletContext====().====setAttribute====(===="applicationMessage"====,======            =="springboot-application"====);======    ==model.====addAttribute====(===="url"====,== =="====www.baidu.cn===="====);======    ==request.====setAttribute====(===="url2"====,======            =="\<span style='color:red'\>www.baidu.cn\</span\>"====);======    ==return== =="show_inner"====;========}==

在页面之中如果要想访问不同属性范围中的内容,则可以采用如下的做法完成:

==\<!DOCTYPE HTML\>========\<====html xmlns:th====="====http://www.thymeleaf.org===="\>========\<====head====\>======    ==\<====title====\>SpringBoot====模版渲染====\</====title====\>======    ==\<====script type====="====text/javascript===="== ==th:src====="====@{/js/main.js}===="\>\</====script====\>== ====    ==\<====meta http-equiv====="====Content-Type===="== ==content====="====text/html;charset=UTF-8===="/\>========\</====head====\>========\<====body====\>======    ==\<====p th:text====="====${#httpServletRequest.getRemoteAddr()}===="/\>======    ==\<====p th:text====="====${#httpServletRequest.getAttribute('requestMessage')}===="/\>======    ==\<====p th:text====="====${#httpSession.getId()}===="/\>======    ==\<====p th:text====="====${#httpServletRequest.getServletContext().getRealPath('/')}===="/\>======    ==\<====hr====/\>======    ==\<====p th:text====="'====requestMessage = ' + ${requestMessage}===="/\>======    ==\<====p th:text====="'====sessionMessage = ' + ${session.sessionMessage}===="/\>======    ==\<====p th:text====="'====applicationMessage = ' + ${application.applicationMessage}===="/\>========\</====body====\>========\</====html====\>==
thymeleaf 考虑到了实际的开发情况,因为 request 传递属性是最为常用的,但是 session 也有可能使用,例如:用户登录之后需要显示用户 id,那么就一定要使用到 session,所以现在必须增加属性范围的形式后才能够正常使用。在 thymeleaf 里面也支持有 JSP 内置对象的获取操作,不过一般很少这样使用。
逻辑处理
所有的页面模版都存在各种基础逻辑处理,例如:判断、循环处理操作。在 Thymeleaf 之中对于逻辑可以使用如下的一些运算符来完成,例如:and、or、关系比较(\>、\<、\>=、\<=、==、!=、lt、gt、le、ge、eq、ne)。
通过控制器传递一些属性内容到页面之中:
==\<====span th:====if========="${member.age lt 18}"====\>========未成年人!========\</====span====\>========\<====span th:====if========="${member.name eq '====啊三===='}"====\>========欢迎小三来访问!========\</====span====\>==
不满足条件的判断
==\<====span th:unless====="====${member.age gt 18}===="\>========你还不满====18====岁,不能够看电影!========\</====span====\>==
通过swith进行分支判断
==\<====span th:switch====="====${member.uid}===="\>========\<====p th:case====="====100===="\>uid====为====101====的员工来了====\</====p====\>========\<====p th:case====="====99===="\>uid====为====102====的员工来了====\</====p====\>========\<====p th:case====="====*===="\>====没有匹配成功的数据!====\</====p====\>========\</====span====\>==
数据遍历
在实际开发过程中常常需要对数据进行遍历展示,一般会将数据封装成list或map传递到页面进行遍历操作。

定义控制器类,向页面传递List数据和Map数据

==@Controller========public== ==class== ==UserController== =={======    ==@RequestMapping====(value== ===== =="/user/map"====, method== ===== ==RequestMethod.GET)======    ==public String== ==map====(Model model) {======        ==Map====\<====String,User====\>== ==allMembers== ===== ==new== ==HashMap====\<====String,User====\>====();======        ==for== ==(int x== ===== ==0====; x== ==\<== ==10====; x====++====) {======            ==User vo== ===== ==new== ==User====();======            ==vo.====setUid====(====101====L== ==+== ==x);======            ==vo.====setName====(===="====赵四== ==- "== ==+== ==x);======            ==vo.====setAge====(====9====);======            ==vo.====setSalary====(====99999.99====);======            ==vo.====setBirthday====(====new== ==Date====());======            ==allMembers.====put====(===="mldn-"== ==+== ==x, vo);======        ==}======        ==model.====addAttribute====(===="allUsers"====, allMembers);======        ==return== =="user_map"====;======    ==}==
==@RequestMapping====(value== ===== =="/user/list"====, method== ===== ==RequestMethod.GET)======    ==public String== ==list====(Model model) {======        ==List====\<====User====\>== ==allMembers== ===== ==new== ==ArrayList====\<====User====\>====();======        ==for== ==(int x== ===== ==0====; x== ==\<== ==10====; x====++====) {======            ==User vo== ===== ==new== ==User====();======            ==vo.====setUid====(====101====L== ==+== ==x);======            ==vo.====setName====(===="====赵四== ==- "== ==+== ==x);======            ==vo.====setAge====(====9====);======            ==vo.====setSalary====(====99999.99====);======            ==vo.====setBirthday====(====new== ==Date====());======            ==allMembers.====add====(vo) ;======        ==}======        ==model.====addAttribute====(===="allUsers"====, allMembers);======        ==return== =="user_list"====;======    ==}========}==

list类型数据遍历

==\<====body====\>======    ==\<====table====\>======        ==\<====tr====\>\<====td====\>No.\</====td====\>\<====td====\>UID\</====td====\>\<====td====\>====姓名====\</====td====\>\<====td====\>====年龄====\</====td====\>\<====td====\>====偶数====\</====td====\>\<====td====\>====奇数====\</====td====\>\</====tr====\>======        ==\<====tr th:each====="====user,memberStat:${allUsers}===="\>======            ==\<====td th:text====="====${memberStat.index + 1}===="/\>======            ==\<====td th:text====="====${user.uid}===="/\>======            ==\<====td th:text====="====${user.name}===="/\>======            ==\<====td th:text====="====${user.age}===="/\>======            ==\<====td th:text====="====${memberStat.even}===="/\>======            ==\<====td th:text====="====${memberStat.odd}===="/\>======        ==\</====tr====\>======    ==\</====table====\>========\</====body====\>==

map类型数据遍历

==\<====body====\>======    ==\<====table====\>======        ==\<====tr====\>\<====td====\>No.\</====td====\>\<====td====\>KEY\</====td====\>\<====td====\>UID\</====td====\>\<====td====\>====姓名====\</====td====\>\<====td====\>====年龄====\</====td====\>\<====td====\>====偶数====\</====td====\>\<====td====\>====奇数====\</====td====\>\</====tr====\>======        ==\<====tr th:each====="====memberEntry,memberStat:${allUsers}===="\>======            ==\<====td th:text====="====${memberStat.index + 1}===="/\>======            ==\<====td th:text====="====${memberEntry.key}===="/\>======            ==\<====td th:text====="====${memberEntry.value.uid}===="/\>======            ==\<====td th:text====="====${memberEntry.value.name}===="/\>======            ==\<====td th:text====="====${memberEntry.value.age}===="/\>======            ==\<====td th:text====="====${memberStat.even}===="/\>======            ==\<====td th:text====="====${memberStat.odd}===="/\>======        ==\</====tr====\>======    ==\</====table====\>========\</====body====\>==
页面引入
我们常常需要在一个页面当中引入另一个页面,例如,公用的导航栏以及页脚页面。thymeleaf中提供了两种方式进行页面引入。

th:replace

th:include

新建需要被引入的页面文件,路径为"src/main/view/templates/commons/footer.html"

==\<====meta http-equiv====="====Content-Type===="== ==content====="====text/html;charset=UTF-8===="/\>========\<====footer th:fragment====="====companyInfo===="\>======    ==\<====p====\>====设为首页== ==©====2018 SpringBoot== ==使用====\<====span th:text====="====${projectName}===="/\>====前必读======        ==意见反馈== ==京====ICP====证====030173====号== ==\</====p====\>========\</====footer====\>==
可以看到页面当中还存在一个变量projectName,这个变量的值可以在引入页面中通过==th:with="projectName=====百度===="==传过来。

引入页面中只需要添加如下代码即可

==\<====div th:include========="@{/commons/footer} :: companyInfo"== ==th:====with========="projectName=====百度===="====/\>==
85人点赞
[SpringBoot](https://www.jianshu.com/nb/23119572)
 \> 来自

 \<https://www.jianshu.com/p/a842e5b5012e\>
  \> 来自

 \<https://www.jianshu.com/p/a842e5b5012e\>

本站总访问 — 次