目录
thymeleaf模板
Freemarker模板
thymeleaf模板
thymeleaf模板和freemarker模板都一套可以替代JSP开发的一套引擎模板,它可以生成静态页面,可以让美工在浏览器查看页面的静态效果,也可以让程序员在服务器查看带数据的动态页面效果。这是由于它支持 html 原型,然后在 html 标签里增加额外的属性来达到模板+数据的展示方式。
项目层级结构
相关pom依赖
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
Spring Boot官方文档建议在开发时将缓存关闭,那就在application.properties文件中加入下面这行
spring:
thymeleaf:
cache: false
正式环境还是要将缓存开启的
然后我们写一些案例,来演示一些标签的使用
User
@Data
public class User {
private Integer uid;
private String uname;
private String pwd;
public void setUid(Integer uid) {
this.uid = uid;
}
public void setUname(String uname) {
this.uname = uname;
}
public void setPwd(String pwd) {
this.pwd = pwd;
}
public User(Integer uid, String uname, String pwd) {
this.uid = uid;
this.uname = uname;
this.pwd = pwd;
}
}
UserController
package com.lyl.springboot01.controller;
import com.lyl.springboot01.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;
/**
* @authorlyl
* @site
* @company
* @create 2019-11-25 20:05
*/
@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","456"));
userList.add(new User(3,"ww","789"));
request.setAttribute("userList",userList);
request.setAttribute("htmlStr","<span style='color:pink'>转义html代码块</span>");
return "list";
}
}
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>
<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>-->
<div th:replace="common :: h2"></div>
</body>
</html>
引入页面common.html
<div th:fragment="h1">
第一部分内容
</div>
<div th:fragment="h2">
第二部分内容
</div>
<div th:fragment="h3">
第三部分内容
</div>
页面效果
Freemarker模板
学习网站:link
导入pom依赖
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>
<!--可以不加,但是做项目的时候可能会用-->
<resources>
<!--解决mybatis-generator-maven-plugin运行时没有将XxxMapper.xml文件放入target文件夹的问题-->
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.xml</include>
</includes>
</resource>
<!--freemarker模板也读取需要注释标红地方-->
<resource>
<directory>src/main/resources</directory>
<includes>
<!--<include>*.properties</include>-->
<!--<include>*.xml</include>-->
<!--<include>*.yml</include>-->
</includes>
</resource>
</resources>
application.yml文件的默认配置
spring:
thymeleaf:
cache: false
freemarker:
# 设置模板后缀名
suffix: .ftl
# 设置文档类型
content-type: text/html
# 设置页面编码格式
charset: UTF-8
# 设置页面缓存
cache: false
# 设置ftl文件路径,默认是/templates,为演示效果添加role
template-loader-path: classpath:/templates/role
mvc:
static-path-pattern: /static/**
Role
package com.lyl.springboot01.entity;
import lombok.Data;
/**
* @authorlyl
* @site
* @company
* @create 2019-11-25 21:00
*/
@Data
public class Role {
private Integer rid;
private String roleName;
private String desc;
public Role(Integer rid, String roleName, String desc) {
this.rid = rid;
this.roleName = roleName;
this.desc = desc;
}
public Integer getRid() {
return rid;
}
public void setRid(Integer rid) {
this.rid = rid;
}
public String getRoleName() {
return roleName;
}
public void setRoleName(String roleName) {
this.roleName = roleName;
}
public String getDesc() {
return desc;
}
public void setDesc(String desc) {
this.desc = desc;
}
}
RoleController
@Controller
@RequestMapping("/freemaker")
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";
}
}
Freemarkder文件后缀一般都为ftl,但是这并不是硬性要求
role.ftl
<!DOCTYPE html>
<html lang="en">
<head>
<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>
一般我们都有这么一个页面,专门来定义全局变量,然后导入这个页面,就能直接使用那些变量了
global.ftl
<#global ctx2>
${springMacroRequestContext.contextPath}
</#global>
foot.ftl
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>$Title$</title>
</head>
<body>
版权信息
</body>
</html>
注意点:
1、application.yml中可以配置模板存放位置的根路径、以及静态资源文件存放位置的根路径
2、${springMacroRequestContext.contextPath}:SpringBoot中获取项目名
3、不推荐使用全局变量。即便它们属于不同的命名空间, 全局变量也被所有模板共享,因为它们是被 import进来的。
4、freemarker模板也可以像jsp那样设置根路径
<#include 'common.ftl'>
<script src="js/xxx.js" type="text/javascript"></script>
thymeleaf中替代jsp:include的写法
两种情况
一种是应用一段html代码
在需要应用的地方添加
<div th:replace="foreground/common/head :: navbar" ></div>
一种是包含整个html页面
<div th:include="freemarker/common/head"></div>
注意:
1、这里的th:replace里的路径是相对于templetes文件夹的。
2、冒号冒号前后都有空格,我没注意这一点踩了大坑