虽然现在很多开发,都采用了前后端完全分离的模式,即后端只提供数据接口,前端通过AJAX请求获取数据,完全不需要用的模板引擎。这种方式的优点在于前后端完全分离,并且随着近几年前端工程化工具和MVC框架的完善,使得这种模式的维护成本相对来说也更加低一点。但是这种模式不利于SEO,并且在性能上也会稍微差一点,还有一些场景,使用模板引擎会更方便,比如说邮件模板。这篇文章主要讨论Spring boot与模板引擎Thymeleaf、Freemaker的集成。
Thymeleaf模板
相关pom依赖
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
然后在配置文件把缓存关闭。官方也是建议开发时关闭 当你项目上线时再打开。
server:
port: 80
servlet:
context-path: /
spring:
thymeleaf:
cache: false
相关配置:
prefix:指定模板所在的目录
check-tempate-location: 检查模板路径是否存在
cache: 是否缓存,开发模式下设置为false,避免改了模板还要重启服务器,线上设置为true,可以提高性能。
encoding&content-type:与Servlet中设置输出对应属性效果一致。
然后我们编写一个controller测试一下:
其实这两种返回类型效果都是一样的,注意的是使用的是@Controller注解并不是@RestController两者区别是@Controller返回页面@RestController返回字符串。
@Controller
@RequestMapping("/Thymeleaf")
public class ThymeleafController {
@RequestMapping("/list")
public ModelAndView list(){
ModelAndView mv = new ModelAndView();
mv.addObject("name","zs");
mv.setViewName("list");
return mv;
}
@RequestMapping("/list2")
public String list2(){
return "list";
}
}
list.html:
需要注意的是要在html标签体中引入标签提示库
<html xmlns:th="http://www.thymeleaf.org">
输出文本name的格式:th:text="${name}"
遍历的格式:th:each=" u : ${list}"
输出html的格式:th:utext="${name}"
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>Thymeleaf知识点</title>
</head>
<body>
Thymeleaf知识点
<h2>显示文本</h2>
<span th:text="${name}"></span>
<h2>显示html</h2>
<div th:utext="${msg}"></div>
<h2>循环</h2>
<table>
<tr>
<td>用户名</td>
<td>密码</td>
</tr>
<tr th:each="u : ${uList}">
<td th:text="${u.uname}"></td>
<td th:text="${u.pwd}"></td>
</tr>
</table>
</body>
</html>
Controller:
@RequestMapping("/list")
public ModelAndView list(){
ModelAndView mv = new ModelAndView();
List list = new ArrayList();
list.add(new User2("zs","123"));
list.add(new User2("ls","456"));
list.add(new User2("ww","789"));
//添加值
mv.addObject("uList",list);
mv.addObject("msg","<span style='color:red'>hello spring!!!!!</span>");
mv.addObject("name","zs");
mv.setViewName("list"); //设置返回页面
return mv;
}
效果:
Freemarker模板
导入pom依赖:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>
需要注意的是Freemarker需要的是.ftl后缀的文件,当然你也可以其他文件,但大部分人都是用这种,还是随主流把。
list.ftl
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>讲解freemaker知识点</title>
</head>
<body>
讲解freemaker知识点
<h2>获取值</h2>
<#--如果没有值则用未知代替-->
${loginName!"未知"}
<h2>遍历</h2>
<table border="1" width="70%">
<tr><td>角色ID</td><td>角色名</td></tr>
<#list roleList as role>
<tr>
<td>${role.uid}</td>
<td>${role.rname}</td>
</tr>
</#list>
</table>
<h2>导页面</h2>
<#--导入整个-->
<#include 'common/head.ftl'>
<#--导入部分-->
<div th:replace="foreground/common/head :: navbar" ></div>
<h2>全局变量和局部变量</h2>
<#--局部变量-->
<#assign ctx1>
${springMacroRequestContext.contextPath}
</#assign>
<#--全局变量-->
<#global ctx2>
${springMacroRequestContext.contextPath}
</#global>
<#--使用变量-->
${ctx1}
${ctx1}
</body>
</html>
Controller:
package com.zlk.springboot01.controller;
import com.zlk.springboot01.entity.Role;
import com.zlk.springboot01.entity.User2;
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 大宝
* @company 太厉害公司
* @create 2019-11-07 16:47
*
*/
@Controller
@RequestMapping("/Freemaker")
public class FreemakerController {
@RequestMapping("/list")
public ModelAndView list(){
ModelAndView mv = new ModelAndView();
List list = new ArrayList();
list.add(new Role("1","普通用户"));
list.add(new Role("2","会员"));
list.add(new Role("3","超级会员"));
//添加值
mv.addObject("loginName","张三");
mv.addObject("roleList",list);
mv.addObject("name","zs");
mv.setViewName("list"); //设置返回页面
return mv;
}
}