Freemarker入门
一. Freemarker概述
1. 为什么要使用网页静态化技术
网页静态化解决方案在实际开发中运用比较多,例如新闻网站,门户网站中的新闻频道或者是文章类的频道。
对于电商网站的商品详细页来说,至少几百万个商品,每个商品又有大量的信息,这样的情况同样也适用于使用网页静态化来解决。
网页静态化技术和缓存技术的共同点都是为了减轻数据库的访问压力,但是具体的应用场景不同,缓存比较适合小规模的数据,而网页静态化比较适合大规模且相对变化不太频繁的数据。另外网页静态化还有利于 SEO。
另外我们如果将网页以纯静态化的形式展现,就可以使用 Nginx 这样的高性能的 web 服务器来部署。Nginx 可以承载 5 万的并发,而 Tomcat 只有几百。关于 Nginx 我们在后续的课程中会详细讲解。
今天我们就研究网页静态化技术----Freemarker。
2. 什么是 Freemarker
FreeMarker 是一个用 Java 语言编写的模板引擎,它基于模板来生成文本输出。 FreeMarker 与 Web 容器无关,即在 Web 运行时,它并不知道 Servlet 或 HTTP。它不仅可以用作表现层的实现技术,而且还可以用于生成 XML,JSP 或 Java 等。
二. Freemarker入门
第一步,创建一个maven工程,并加入静态模板引擎的依赖坐标
<!--静态模板引擎依赖坐标 -->
<dependencies>
<dependency>
<groupId>org.freemarker</groupId>
<artifactId>freemarker</artifactId>
<version>2.3.23</version>
</dependency>
</dependencies>
第二步,创建模板文件.ftl(test.ftl)
注意:要把该文件编码格式改为UTF-8
<html>
<head>
<meta charset="UTF-8">
<title>入门Сdemo</title>
</head>
<body>
<#--这是一个注释-->
${name},你好,${message}
</body>
</html>
- 模板文件中四种元素
1、 文本,直接输出的部分
2、 注释,即<#–…-->格式不会输出
3、 插值(Interpolation):即${…}部分,将使用数据模型中的部分替代输出
4、 FTL 指令:FreeMarker 指令,和 HTML 标记类似,名字前加#予以区分,不会输出。
第三步,生成html文件的后台代码
注意:创建输出流的时候,不可以直接使用new FileWriter(),因为这样会乱码,
要使用OutPutStreamWriter流
/*
* freemarker测试类
*/
public class FreeMarkerDemo {
public static void main(String[] args) throws IOException, TemplateException {
//1.创建配置类
Configuration configuration=new Configuration(Configuration.getVersion());
//2.设置ftl所在的包路径地址
configuration.setDirectoryForTemplateLoading(
new File("D:\\eclipseWorkspace\\freemarker_demo\\src\\main\\resources\\"));
//3.设置字符集
configuration.setDefaultEncoding("utf-8");
//4.加载模板
Template template = configuration.getTemplate("test.ftl");
//5.创建模型,注意,前台有几个插值,这里就要封装几个数据
Map dataMap=new HashMap<>();
dataMap.put("name", "张三");
dataMap.put("message", "欢迎来到静态模板引擎的世界");
//6.创建输出流,设置输出地址
Writer out =new BufferedWriter(new OutputStreamWriter(
new FileOutputStream("D:\\pingyougouSetup\\freemarkerDemo\\test.html"), "UTF-8"));
//7.输出操作
template.process(dataMap, out);
//8.关闭流
out.close();
}
}
第四步,执行后,在D:\pingyougouSetup\freemarkerDemo目录即可看到生成的test.html ,
注意:如果改变了test.ftl里的内容,需要重新执行生成html的后台代码,方可看到效果
三. Freemarker指令
1. assign 指令
此指令是用来在页面上定义一个变量的指令
1.定义简单类型
assign指令-简单类型<br>
<#assign linkman="周先生">
联系人:${linkman}
2.定义对象类型
assign指令-对象类型<br>
<#assign info={"name":"李先生","age":12}>
姓名:${info.name} 年龄:${info.age}
2. include 指令
此指令用于模板文件的嵌套
创建一个head.ftl
<h1>黑马信息网</h1>
在test.ftl中引入head.ftl
include引入指令<br>
<#include "head.ftl">
显示效果
3. if 指令
<#if success=true>
你已通过实名认证
<#else>
你未通过实名认证
</#if>
在代码中对 success变量赋值
dataMap.put("success", false);
在 freemarker的判断中,可以使用= 也可以使用==
4. list 指令
需求,实现商品价格表,如下图:
(1)代码中对变量 goodsList赋值
List goodsList=new ArrayList();
Map goods1=new HashMap();
goods1.put("name", "苹果");
goods1.put("price", 5.8);
Map goods2=new HashMap();
goods2.put("name", "香蕉");
goods2.put("price", 2.5);
Map goods3=new HashMap();
goods3.put("name", "橘子");
goods3.put("price", 3.2);
goodsList.add(goods1);
goodsList.add(goods2);
goodsList.add(goods3);
dataMap.put("goodsList", goodsList);
(2)在模板文件上添加
list指令<br>
<#list goodsList as goods>
${goods_index+1} 商品名称:${goods.name} 商品价格:${goods.price}<br>
</#list>
如果想在循环中得到索引,使用循环变量+_index就可以得到。
四. Freemarker内建函数
内建函数语法格式: 变量?函数名称
1. 获取集合大小
我们使用size 函数来实现,代码如下:
共${goodsList?size}条记录
2. JSON 字符串转换
我们通常需要将 json 字符串转换为对象,那如何处理呢?看代码
JSON字符串转对象<br>
<#assign text="{'bank':'工商银行','account':'10101920201920212'}" />
<#assign data=text?eval />
开户行:${data.bank} 账号:${data.account}
3. 日期格式化
代码中对变量赋值:
dataMap.put("today", new Date());
在模板文件中加入
当前日期:${today?date} <br>
当前时间:${today?time} <br>
当前日期+时间:${today?datetime} <br>
日期格式化: ${today?string("yyyy年MM月")}
4. 数字转换为字符串
代码中对变量赋值:
map.put("point", 102920122);
修改模板:
累计积分:${point}
页面显示:
我们会发现数字会以每三位一个分隔符显示,有些时候我们不需要这个分隔符,就需要将数字转换为字符串,使用内建函数 c
累计积分:${point?c}
页面显示效果如下:
五. 空值处理
如果你在模板中使用了变量但是在代码中没有对变量赋值,那么运行生成时会抛出异常。但是有些时候,有的变量确实是 null,怎么解决这个问题呢?
1. 判断是否存在:??
用法为:variable??,如果该变量存在,返回 true,否则返回 false
<#if aa??>
我不存在
<#else>
我存在
</#if>
2. 指定默认值: bbb!转换值
我们除了可以判断是否为空值,也可以使用!对 null 值做转换处理
在模板文件中加入
${bbb!'ccc'}
在代码中不对 aaa 赋值,也不会报错了,当 bbb 为null 则返回!后边的内容ccc
六. 运算符
1. 算数运算符
FreeMarker 表达式中完全支持算术运算,FreeMarker 支持的算术运算符包括:+, - , * , / , %
2. 逻辑运算符
逻辑运算符有如下几个:
逻辑与:&& 逻辑或:||
逻辑非:!
逻辑运算符只能作用于布尔值,否则将产生错误
3. 比较运算符
表达式中支持的比较运算符有如下几个:
1 =或者==:判断两个值是否相等.
2 !=:判断两个值是否不等.
3 >或者 gt:判断左边值是否大于右边值
4 >=或者 gte:判断左边值是否大于等于右边值
5 <或者 lt:判断左边值是否小于右边值
6 <=或者 lte:判断左边值是否小于等于右边值
注意: =和!=可以用于字符串,数值和日期来比较是否相等,但=和!=两边必须是相同类型的值, 否则会产生错误,而且 FreeMarker 是精确比较,“x”,"x ","X"是不等的.其它的运行符可以作用于数字和日期,但不能作用于字符串,大部分的时候,使用gt等字母运算符代替>会有更好的效果, 因为 FreeMarker 会把>解释成 FTL 标签的结束字符,当然,也可以使用括号来避免这种情况, 如:<#if (x>y)>