Thymeleaf模板
thymeleaf优点: 静态html嵌入标签属性,浏览器可以直接打开模板文件,便于前后端联调。
thymeleaf缺点: 模板必须符合xml规范
相关pom依赖
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
Spring Boot官方文档建议在开发时将缓存关闭,那就在application.properties文件中加入下面这行
spring:
thymeleaf:
cache: false
对应的后台代码
实体类(User):
package com.aurora.springboot02.entity;
import lombok.Data;
/**
* @author Aurora
*
*/
@Data
public class User {
private Integer uid;
private String uname;
private String pwd;
public User() {
}
public User(Integer uid, String uname, String pwd) {
this.uid = uid;
this.uname = uname;
this.pwd = pwd;
}
}
controller层:
package com.aurora.springboot02.controller;
import com.aurora.springboot02.entity.User;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import javax.servlet.http.HttpServletRequest;
import java.util.ArrayList;
import java.util.List;
/**
* @author Aurora
*
*/
@Controller
@RequestMapping("/thymeleaf")
public class UserController {
@RequestMapping("/list")
public String hello(HttpServletRequest request){
/*
* 1、获取单个值
* 2、能够在html页面进行遍历展示
* 3、如何在html页面转意html代码
* */
request.setAttribute("msg","传输单个字符串!!!!");
List<User> userList=new ArrayList<>();
userList.add(new User(1,"zs","123"));
userList.add(new User(2,"ls","234"));
userList.add(new User(3,"ww","345"));
request.setAttribute("userList",userList);
request.setAttribute("htmlStr","<span style='color:red'>转意html代码</span>");
return "list";
}
}
html页面:
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>thymeleaf模板介绍</title>
</head>
<body>
<div th:text="msg"></div>
<div th:text="${msg}"></div>
<table width="60%" border="1">
<tr>
<td>id</td>
<td>用户名</td>
<td>密码</td>
</tr>
<tr th:each="u : ${userList}">
<td th:text="${u.uid}"></td>
<td th:text="${u.uname}"></td>
<td th:text="${u.pwd}"></td>
</tr>
</table>
<div th:utext="${htmlStr}"></div>
</body>
</html>
运行结果:
thymeleaf中替代jsp:include的写法
两种情况:
一种是应用一段html代码在需要应用的地方添加
在templates下新建一个html页面:
<div th:fragment="h1">
第一部分内容
</div>
<div th:fragment="h2">
第二部分内容
</div>
<div th:fragment="h3">
第三部分内容
</div>
在原来的list页面进行调用:
<!-- 获取指定页面的指定内容-->
<div th:replace="common::h2"></div>
运行结果:
一种是包含整个html页面
<!--获取指定页面的所有内容-->
<div th:include="common.html"></div>
运行结果:
完整的list页面代码:
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>thymeleaf模板介绍</title>
</head>
<body>
<div th:text="msg"></div>
<div th:text="${msg}"></div>
<!--将指定页面内容放入指定位置-->
<div th:replace="common::h3"></div>
<table width="60%" border="1">
<tr>
<td>id</td>
<td>用户名</td>
<td>密码</td>
</tr>
<tr th:each="u : ${userList}">
<td th:text="${u.uid}"></td>
<td th:text="${u.uname}"></td>
<td th:text="${u.pwd}"></td>
</tr>
</table>
<div th:utext="${htmlStr}"></div>
<!--获取指定页面的所有内容-->
<div th:include="common.html"></div>
<!-- 获取指定页面的指定内容-->
<div th:replace="common::h2"></div>
</body>
</html>
Freemarker模板
freemarker 不足:thymeleaf由于使用了标签属性做为语法,模版页面直接用浏览器渲染,使得前端和后端可以并行开发。freemarket使用</>这样的语法,就无法直接使浏览器渲染出原本页面的样子
导入pom依赖:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>
在application.properties添加默认配置
freemarker:
# 设置模板后缀名
suffix: .ftl
# 设置文档类型
content-type: text/html
# 设置页面编码格式
charset: UTF-8
# 设置页面缓存
cache: false
# 设置ftl文件路径,默认是/templates,为演示效果添加role
template-loader-path: classpath:/templates/freemarker
mvc:
static-path-pattern: /static/**
创建一个后缀名为ftl的文件:
实体类(Role):
package com.aurora.springboot02.entity;
/**
* @author Aurora
*
*/
public class Role {
private Integer rid;
private String rname;
private String desc;
public Role() {
}
public Role(Integer rid, String rname, String desc) {
this.rid = rid;
this.rname = rname;
this.desc = desc;
}
}
controller层(RoleController)
package com.aurora.springboot02.controller;
import com.aurora.springboot02.entity.Role;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;
import java.util.ArrayList;
import java.util.List;
/**
* @author Aurora
*/
@Controller
@RequestMapping("/freemarker")
public class RoleController {
@RequestMapping("/role/list")
public ModelAndView roleList(){
ModelAndView mav = new ModelAndView();
mav.setViewName("/list");
mav.addObject("name",null);
mav.addObject("sex","gay");
List list = new ArrayList();
list.add(new Role(1,"老师","教书育人"));
list.add(new Role(2,"学生","知识改变命运"));
mav.addObject("roles",list);
return mav;
}
@RequestMapping("toLogin")
public String toLogin(){
return "login";
}
}
在templates创建freemarker文件,之后创建ftl页面
ftl页面(list):
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
</head>
<body>
<h2>取值</h2>
<h3>提供默认值</h3>
welcome 【${name!'未知'}】 to freemarker!
<h3>exists用在逻辑判断</h3>
<#if name?exists>
${name}
</#if>
<h2>条件</h2>
<#if sex=='girl'>
女
<#elseif sex=='boy'>
男
<#else>
保密
</#if>
<h2>循环</h2>
<table border="1px" width="600px">
<thead>
<tr>
<td>ID</td>
<td>角色名</td>
<td>描述</td>
</tr>
</thead>
<tbody>
<#list roles as role>
<tr>
<td>${role.rid}</td>
<td>${role.roleName}</td>
<td>${role.desc}</td>
</tr>
</#list>
</tbody>
</table>
<h2>include</h2>
<#include 'foot.ftl'>
<h2>局部变量(assign)/全局变量(global)</h2>
<#assign ctx1>
${springMacroRequestContext.contextPath}
</#assign>
<#global ctx2>
${springMacroRequestContext.contextPath}
</#global>
${ctx1}和${ctx2}
</body>
</html>
运行结果:
注意点
- application.yml中可以配置模板存放位置的根路径、以及静态资源文件存放位置的根路径
- ${springMacroRequestContext.contextPath}:SpringBoot中获取项目名
- 不推荐使用全局变量。即便它们属于不同的命名空间, 全局变量也被所有模板共享,因为它们是被 import进来的。
- freemarker模板也可以像jsp那样设置根路径
<#include 'common.ftl'>
<script src="js/xxx.js" type="text/javascript"></script>
比较两者:
- 从写code的习惯角度可能freemarker更习惯于我们的思维。
- 不过从前后分离开发的角度看thymeleaf更合适,值的绑定都是基于html的dom元素属性的,适合前后联调