1.创建一个普通的java+maven项目
2.引入freemarker的依赖
<dependency>
<groupId>org.freemarker</groupId>
<artifactId>freemarker</artifactId>
<version>2.3.23</version>
</dependency>
3.在src/main/resources下创建一个ftl文件test.ftl
<html>
<head>
<meta charset="utf-8">
<title>freemarker入门demo</title>
</head><#--
<#include "head.ftl">-->
<body>
<#--我是一个注释,不会存在任何输出-->
<!--也是一个注释,但是会存在输出到源码上-->
<#--${name},你好,${message}</br>-->
<#--定义普通类型-->
<#--<#assign linkman = '周卫国'>-->
<#--联系人:${linkman}</br>-->
<#--定义对象类型-->
<#--<#assign info ={'tel':'12312412312','person':'周文'}>
电话:${info.tel}</br>
真实姓名:${info.person}</br>-->
<#--if指令-->
<#--<#if success='true'>你已通过实名认证<#else>你未通过实名认证</#if>-->
<#------商品价格表----<br>
<#list goodsList as goods>
${goods_index+1} 商品名称: ${goods.name}价格:${goods.price}<br>
${goodsList?size}
</#list>
<br>
<#assign text="{'bank':'工商银行','account':'10101920201920212'}" />
<#assign data=text?eval />
开户行:${data.bank}<br>
账号:${data.account}<br>-->
当前日期:${today?date} <br>
当前时间:${today?time} <br>
当前日期+时间:${today?datetime} <br>
日期格式化: ${today?string("yyyy 年 MM 月")}
</body>
</html>
4.创建一个测试的方法
使用步骤:第一步:创建一个 Configuration 对象,直接 new 一个对象。构造方法的参数就是freemarker 的版本号。
第二步:设置模板文件所在的路径。
第三步:设置模板文件使用的字符集。一般就是 utf-8.
第四步:加载一个模板,创建一个模板对象。
第五步:创建一个模板使用的数据集,可以是 pojo 也可以是 map。一般是 Map。
第六步:创建一个 Writer 对象,一般创建一 FileWriter 对象,指定生成的文件名。
第七步:调用模板对象的 process 方法输出文件。
第八步:关闭流
public static void main(String[] args) throws IOException, TemplateException {
// 构建一个配置对象
Configuration configuration = new Configuration(Configuration.getVersion());
// 设置模板所在的目录
configuration.setDirectoryForTemplateLoading(new File("C:\\ideaworkspace\\FreemarkerDemo\\src\\main\\resources"));
// 设置字符集
configuration.setDefaultEncoding("utf-8");
// 加载模板
Template template = configuration.getTemplate("test.ftl");
// 创建数据模型
// HashMap<String, String> map1 = new HashMap<String, String>();
// HashMap<String, List> map = new HashMap<String, List>();
HashMap<String,Date> map = new HashMap<String, Date>();
// map1.put("name","zhangsan");
// map1.put("message","欢迎你!");
在代码中对str变量赋值
// map1.put("success","true");
map.put("today", new Date());
//
/* 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);
map.put("goodsList", goodsList);*/
//
// 创建Writer对象
Writer out = new FileWriter(new File("d:\\test.html"));
// 输出
// template.process(map1,out);
template.process(map,out);
// 关闭Writer对象
out.close();
}
执行后,在 D 盘根目录即可看到生成的 test.html
FTL 指令
1.assign指令(此指令用于在页面上定义一个变量)
(1)
<#--定义普通类型-->
<#assign linkman = "周卫国">
联系人:${linkman}</br>
(2)
<#--定义对象类型-->
<#assign info ={"tel":"12312412312","person":"周文"}>
电话:${info.tel}</br>
真实姓名:${info.person}</br>
2.include指令(此指令用于模板文件的嵌套)
测试:
先创建一个模板文件head.ftl
<h1>嵌套页面</h1>
我们使用include命令引入我们建立的模板
<#include "head.ftl">
3.if指令
在模板中添加
<#if success=true>你已通过实名认证<#else>你未通过实名认证</#if>
在代码中对str变量赋值
map.put("success",true);
注意:在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);
map.put("goodsList", goodsList);
(2)在模板文件上添加
----商品价格表----
<#list goodsList as goods>
${goods_index+1} 商品名称: ${goods.name} 价格:${goods.price}<br>
</#list>
如果想在循环中得到索引,使用 循环变量_index 就可以得到。
5.内建函数(内建函数语法格式: 变量+?+函数名称)
(1)获取集合大小
我们使用 size 函数来实现,代码如下:
共 ${goodsList?size} 条记录
(2)转换 JSON 字符串为对象
我们通常需要将 json 字符串转换为对象,那如何处理呢?
<#assign text="{'bank':'工商银行','account':'10101920201920212'}" />
<#assign data=text?eval />
开户行:${data.bank}
账号:${data.account}
(3)日期格式化
代码中对变量赋值:dataModel.put(“today”, new Date());
在模板文件中加入:
当前日期:${today?date} <br>
当前时间:${today?time} <br>
当前日期+时间:${today?datetime} <br>
日期格式化: ${today?string("yyyy 年 MM 月")}
(4)数字转换为字符串
代码中对变量赋值:map.put("point", 102920122);
修改模板:累计积分:${point}
页面显示:102,121,121
我们会发现数字会以每三位一个分隔符显示,有些时候我们不需要这个分隔符,就需要将数字转换为字符串,使用内建函数 c
累计积分:${point?c}
页面显示效果如下:页面显示:102121121
6.空值处理运算符
如果你在模板中使用了变量但是在代码中没有对变量赋值,那么运行生成时会抛出异常。
但是有些时候,有的变量确实是 null,怎么解决这个问题呢?
(1)判断某变量是否存在:“??”
用法为:variable??,如果该变量存在,返回 true,否则返回 false
<#if aaa??>aaa 变量存在<#else>aaa 变量不存在</#if>
(2)缺失变量默认值:“!”
我们除了可以判断是否为空值,也可以使用!对 null 值做转换处理
在模板文件中加入
${aaa!’-’}
在代码中不对 aaa 赋值,也不会报错了 ,当 aaa 为 null 则返回!后边的内容 -
7.运算符
(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)>