FreeMarker是非常古老的引擎,可以用在Web环境或非Web环境下,与Thymeleaf相比,FreeMarker需要经过解析才能够在浏览器中展示出来。FreeMarker不仅可以用来配置HTML页面模板,也可以作为电子邮件模板、配置文件模板及源码模板等。Spring boot整合FreeMarker步骤如下:
1、创建项目,添加依赖
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-freemarker</artifactId>
]</dependency>
2、配置FreeMarker
Spring boot对FreeMarker提供自动化配置类FreeMarkerProProperties
@Component
@ConfigurationProperties(prefix = "spring.freemarker")
public class FreeMarkerProProperties extends AbstractTemplateViewResolverProperties {
public static final String DEFAULT_TEMPLATE_LOADER_PATH = "classpath:/templates/";
public static final String DEFAULT_PREFIX = "";
public static final String DEFAULT_SUFFIX = ".ftl";
protected FreeMarkerProProperties(String defaultPrefix, String defaultSuffix) {
super(defaultPrefix, defaultSuffix);
}
}
如上所示,配置模板位置和默认文件后缀是.htl
还可以在application.properties对这些默认配置进行修改,部分配置如下:
#HTTPServletRequest的属性是否可以覆盖controller中model的网络项
spring.freemarker.allow-session-override=false
#HttpSession的属性是否可以覆盖controller中model的同名项
spring.freemarker.allow-request-override=false
#是否开启缓存
spring.freemarker.cache=false
#模板文件编码
spring.freemarker.charset=UTF-8
#是否检验模板位置
spring.freemarker.check-template-location=true
#Content-Type的值
spring.freemarker.content-type=text/html
#是否将HttpServletRequest中的属性添加到Model中
spring.freemarker.expose-request-attributes=false
#是否将HttpSession中的属性添加到Model中
spring.freemarker.expose-session-attributes=false
#模板文件后缀
spring.freemarker.suffix=.ftl
#模板文件位置
spring.freemarker.template-loader-path=classpath:/templates/
3、配置控制类
@RestController
public class BooksController {
@GetMapping("/booksFree")
public ModelAndView books() {
List<BookEntity> books = new ArrayList<>();
BookEntity b1 = new BookEntity();
b1.setId(3);
b1.setAuthor("吴承恩");
b1.setName("西游记");
BookEntity b2 = new BookEntity();
b2.setId(4);
b2.setAuthor("施耐庵");
b2.setName("水浒传");
books.add(b1);
books.add(b2);
ModelAndView mv = new ModelAndView();
mv.addObject("books",books);
mv.setViewName("books");
return mv;
}
}
4、创建视图
按照配置文件,在resources/templates目录下创建books.ftl文件,内容如下:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>图书列表</title>
</head>
<boby>
<table border="1">
<tr>
<td>图书编号</td>
<td>图书名称</td>
<td>图书作者</td>
</tr>
<#-- 首先判断model中的books不为空且books中有数据,然后进行遍历-->
<#if books ??&&(books?size>0)>
<#list books as book>
<tr>
<td>${book.id}</td>
<td>${book.name}</td>
<td>${book.author}</td>
</tr>
</#list>
</#if>
</table>
</boby>
</html>
5、运行
在浏览器访问http://localhost:8080/booksFree,如下所示: