FreeMarker介绍
FreeMarker是一款模板引擎: 即一种基于模板和要改变的数据, 并用来生成输出文本(HTML网页、电子邮件、配置文件、源代码等)的通用工具。它不是面向最终用户的,而是一个Java类库,是一款程序员可以嵌入他们所开发产品的组件。
引入依赖
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>
编写模板文件
编写一个hello.ftl文件,此文件的路径在src/main/resources/templates下,其中hello.ftl文件的内容如下:
<!DOCTYPE html>
<html>
<head>
<title>hello</title>
</head>
<body>
welcome ${name} to freemarker!
</body>
</html>
编写访问接口
@Controller
public class HelloController {
@RequestMapping("/hello")
public String hello(Map<String,Object> map){
map.put("name", "Gentle Man");
return "hello";
}
}
启动测试
访问http://127.0.0.1:8080/hello ,浏览器中看到如下信息:
welcome Gentle Man to freemarker!
FreeMarker配置
# config for freekmarker
spring.freemarker.allow-request-override=false
spring.freemarker.cache=true
spring.freemarker.check-template-location=true
spring.freemarker.charset=UTF-8
spring.freemarker.content-type=text/html
spring.freemarker.expose-request-attributes=false
spring.freemarker.expose-session-attributes=false
spring.freemarker.expose-spring-macro-helpers=false
#spring.freemarker.prefix=
#spring.freemarker.request-context-attribute=
#spring.freemarker.settings.*=
#spring.freemarker.suffix=.ftl
#spring.freemarker.template-loader-path=classpath:/templates/ #comma-separated list
#spring.freemarker.view-names= # whitelist of view names that can be resolved
FreekMarker常用语法
这里还是简单的介绍下几个常用的if else,list,首先我们改造下HelloController的hello方法:
@Controller
public class HelloController {
@RequestMapping("/hello")
public String hello(Map<String, Object> map){
map.put("name", "GentleMan");
map.put("age", 23);
map.put("gender", 1);//gender:性别,1:男;0:女;
List<Map<String,Object>> friends =new ArrayList<Map<String,Object>>();
Map<String,Object> friend = new HashMap<String,Object>();
friend.put("name", "李蕾");
friend.put("age", 21);
friend.put("gender", 0);
friends.add(friend);
friend = new HashMap<String,Object>();
friend.put("name", "张三");
friend.put("age", 22);
friend.put("gender", 1);
friends.add(friend);
map.put("friends", friends);
return "hello";
}
}
接下来我们看看怎么在freemarker进行展示:
<!DOCTYPE html>
<html>
<head>
<title>hello</title>
</head>
<body>
<p>
welcome ${name} to freemarker!
</p>
<p>
姓名:${name}
年龄:${age}
性别:
<#if gender==0>
女
<#elseif gender==1>
男
<#else>
保密
</#if>
</p>
<p>
<h4>我的好友</h4>
<#list friends as item>
姓名:${item.name} , 年龄:${item.age} , 性别:${item.gender}
<br>
</#list>
</p>
</body>
</html>
FreekMarker布局
freemarker layout主要处理具有相同内容的页面,比如每个网站的header和footer页面。freemarker 的布局主要常见的两种方式是#import(“文件路径”)和#include(“文件路径”),其中import和include的区别在于,include常用于公共部分的页面,如果要使用<#assign username=“张三”>涉及到内部函数以及变量声明之类的,使用import进行导入,如果在import中的页面含有页面当前将不会进行渲染。 我们编写一个header和footer,其中的header使用include引入,footer页面也使用include引入。(当然freemarker 还有别的布局方式,这里只是介绍一种,请自行学习研究)
header.ftl
<header>
This is a header, welcome ${name} to my web site!
</header>
<hr>
footer.ftl
<hr>
<footer>
This is a footer, welcome ${name} to my web site!
</footer>
main.ftl
<!DOCTYPE html>
<html>
<head>
<title>layout</title>
</head>
<body>
<#include "header.ftl">
<h3>This is content</h3>
<#include "footer.ftl">
</body>
</html>
增加访问接口
@RequestMapping("/layout")
public String layout(Map<String, Object> map){
map.put("name", "迈克.杰克逊");
return "main";
}
启动工程访问:http://127.0.0.1:8080/layout 效果如下:
【小记】
1、spring boot + freemarker 怎么获取contextPath?
在application.properties添加如下信息:
spring.freemarker.request-context-attribute=request
在x.ftl文件中进行使用:
${request.contextPath}