什么是 Freemarker
FreeMarker 是一个用 Java 语言编写的模板引擎,它基于模板来生成文本输出。 FreeMarker 与 Web 容器无关,即在 Web 运行时,它并不知道 Servlet 或 HTTP。它不仅可以用作表现层的实现技术,而且还可以用于生成 XML,JSP 或 Java 等。
一. 入门 assign 指令 此指令用于在页面上定义一个变量
1. 创建 maven 工程, 导入依赖:
<dependency>
<groupId>org.freemarker</groupId>
<artifactId>freemarker</artifactId>
<version>2.3.23</version>
</dependency>
2. 在 resources 文件夹下创建 test.ftl 模板文件:
<html>
<title>demo</title>
<meta charset="utf-8">
<body>
<!-- 这是一个注释 -->
${name}, ${message}
<br>
<!-- 定义简单类型 -->
<#assign linkman="曾先生"> 联系人:${linkman}
<!-- 定义对象类型 -->
<!assign info={"mobile":"1537767311*",'address':'湖北省武汉市'}> 电话:${info.mobile} 地址:${info.address}
</body>
</html>
3. 编写 java 测试类:
package cn.cast.demo;
import freemarker.template.Configuration;
import freemarker.template.Template;
import java.io.File;
import java.io.FileWriter;
import java.io.Writer;
import java.util.HashMap;
import java.util.Map;
public class Test {
public static void main(String[] args) throws Exception {
//1.创建配置类
Configuration configuration=new Configuration(Configuration.getVersion());
//2.设置模板所在的目录 - test.ftl
configuration.setDirectoryForTemplateLoading(new File("D:\MyProject\Idea\freemarkerDemo\src\main\resources\"));
//3.设置字符集
configuration.setDefaultEncoding("utf-8");
//4.加载模板
Template template = configuration.getTemplate("test.ftl");
//5.创建数据模型
Map map=new HashMap();
map.put("name", "张三 ");
map.put("message", "你好!");
//6.创建 Writer 对象 - 指定输出路径
Writer out =new FileWriter(new File("d:/test.html"));
//7.执行输出
template.process(map, out);
//8.关闭 Writer 对象
out.close();
}
}
4. 执行 java 代码, 即可在指定路径下生成 test.html 页面. 页面内容:
生成文件的步骤:
第一步:创建一个 Configuration 对象,直接 new 一个对象。构造方法的参数就是 freemarker 的版本号;
第二步:设置模板文件所在的路径;
第三步:设置模板文件使用的字符集。一般就是 utf-8;
第四步:加载一个模板,创建一个模板对象;
第五步:创建一个模板使用的数据集,可以是 pojo 也可以是 map。一般是 Map;
第六步:创建一个 Writer 对象,一般创建一 FileWriter 对象,指定生成的文件名;
第七步:调用模板对象的 process 方法输出文件;
第八步:关闭流.
二. include 指令 此指令用于模板文件的嵌套
1. 创建一个引入页面的文件 head.ftl:
<h3>我是一个引入文件,可以被引入到其他模板</h3>
2. 在 test.ftl 模板<body></body>中引入 head.ftl 文件:
<#include "head.ftl">
三. if 指令
<#if success=true>
success 为 true, 我就显示出来.....
<#else>
success 为 false, 我就显示出来.....
</#if>
需要在 java 测试类 map 集合中添加:
map.put("success", true);
四. list 指令
<#list list as goods>
商品序号: ${goods_index+1} 商品名称: ${goods.name} 价格:${goods.price}<br>
</#list>
需要在 java 测试类 map 集合中添加:
//创建集合 - 往集合中添加多个商品
List list = 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);
list.add(goods1);
list.add(goods2);
list.add(goods3);
//将商品集合存入 map 集合
map.put("list", list);
五. 内建函数
1. 获取商品数量
<!-- 內建函数 -->
共 ${list?size} 件商品<#-- 获取商品 list 集合的长度 -->
2. json 字符串转换成 json 对象
<!-- 定义一个 json 字符串 -->
<#assign studetn="{'name':'张三', 'age':'24', 'sex':'男'}" />
<!-- json 字符串转换成 json 对象 -->
<#assign stu=studetn?eval />
姓名: ${stu.name} 年龄: ${stu.age} 性别: ${stu.sex}
3. 获取日期
<!-- 获取相关时间日期 -->
当前日期: ${today?date}
<br>
当前时间:${today?time}
<br>
当前日期+时间:${today?datetime}
<br>
日期格式化:
${today?string("yyyy年MM月")}
<br>
需要在 java 测试类 map 集合中添加:
map.put("today", new Date());
4. 获取数据
账户金额: ${money} 去除逗号: ${money?c}
需要在 java 测试类 map 集合中添加:
map.put("money", 200000000.00);
六. 判断某变量是否存在
<!-- 判断 a b 变量是否存在 -->
<#if a??>
a 变量存在
<#else>
a 变量不存在
</#if>
<br>
${b!'b 变量不存在'}
七. 运算符
<!-- 比较 -->
<#if (money > 1000000) >
富豪
</#if>
<br>
<#if money lt 100 >
穷鬼
</#if>
1. 算数运算符
FreeMarker 表达式中完全支持算术运算,FreeMarker 支持的算术运算符包括: +, - , * , / , %.
2. 逻辑运算符
逻辑与:&& 逻辑或:|| 逻辑非:!
逻辑运算符只能作用于布尔值, 否则将产生错误.
3. 比较运算符
表达式中支持的比较运算符有如下几个:
- = 或者 == : 判断两个值是否相等;
- != : 判断两个值是否不等.;
- > 或者 gt : 判断左边值是否大于右边值;
- >= 或者 gte : 判断左边值是否大于等于右边值;
- < 或者 lt : 判断左边值是否小于右边值;
- <= 或者 lte : 判断左边值是否小于等于右边值.
注意: = 和 != 可以用于字符串, 数值和日期来比较是否相等, 但 = 和 != 两边必须是相同类型的值, 否则会产生错误, 而且 FreeMarker 是精确比较, "x", "x " ,"X" 是不等的. 其它的运行符可以作用于数字和日期, 但不能作用于字符串, 大部分的时候, 使用 gt 等字母运算符代替 > 会有更好的效果, 因为 FreeMarker 会把 > 解释成 FTL 标签的结束字符, 当然, 也可以使用括号来避免这种情况, 如 : <#if (x>y)>