FreeMarker 是一个用 Java 语言编写的模板引擎,它基于模板来生成文本输出。FreeMarker与 Web 容器无关,即在 Web 运行时,它并不知道 Servlet 或 HTTP。它不仅可以用作表现层的实现技术,而且还可以用于生成 XML,JSP 或 Java 等。可用作生成静态html。
入门案例:
案例结构:
pom.xml引入依赖包:
<dependency>
<groupId>org.freemarker</groupId>
<artifactId>freemarker</artifactId>
<version>2.3.23</version>
</dependency>
案例模板test.ftl:
<html>
<head>
<meta charset="utf-8">
<title>FreemarkerDemo</title>
</head>
<body>
<#--我只是一个注释,我不会有任何输出 -->
<#--插值 可以理解为占位符-->
${name},你好。${message}
<br/>
<#--指令-----------------------------------------------------start-->
<#--assign指令 定义变量-->
<#assign linkman="刘德华" />
联系人:${linkman}
<br/>
<#--定义对象类型变量-->
<#assign info={"mobile":"13888888888",'address':'中国香港'} />
电话:${info.mobile} 地址:${info.address}
<#--include指令 嵌入其他文件-->
<#include "head.ftl" />
<#--if指令 判断-->
<#if success =true>
成功
<#else>
失败
</#if>
<br/><br/>
<#--list指令 循环-->
<#list list as m>
下标+1:${m_index+1}; 值:${m.name} <br/>
</#list>
<#--指令---------------------------------------------------------end-->
<#--内建函数---------------------------------------------------start-->
<#--内建函数 size 获取集合size-->
list中共${list?size}条记录
<br/><br/>
<#--内建函数 eval 将字符串转换成json对象-->
<#assign text="{'bank':'工商银行','account':'10101920201920212'}" />
<#assign data=text?eval />
开户行:${data.bank} 账号:${data.account}
<br/><br/>
<#--日期格式化的内建函数-->
当前日期:${now?date} <br>
当前时间:${now?time} <br>
当前日期+时间:${now?datetime} <br>
日期格式化: ${now?string("yyyy年MM月")}
<br/><br/>
<#--内建函数 c 将数字转换成字符串-->
累计积分:${point?c}
<br/><br/>
<#--内建函数-----------------------------------------------------end-->
<#--空值处理---------------------------------------------------start-->
<#--判断某变量是否存在:“??”-->
<#if aaa??>
aaa变量存在
<#else>
aaa变量不存在
</#if>
<br/><br/>
<#--使用!对null值做转换处理-->
${aaa!'aaa为空时的默认值'}
<br/><br/>
<#--空值处理-----------------------------------------------------end-->
</body>
</html>
head.ftl:
java代码 FreemarkerDemo:
package com.zy.demo;
import freemarker.template.Configuration;
import freemarker.template.Template;
import java.io.File;
import java.io.FileWriter;
import java.io.Writer;
import java.util.*;
public class FreemarkerDemo {
public static void main(String[] args) throws Exception {
//第一步:创建一个 Configuration 对象,直接 new 一个对象。构造方法的参数就是 freemarker的版本号。
Configuration configuration = new Configuration(Configuration.getVersion());
//第二步:设置模板文件所在的路径。
configuration.setDirectoryForTemplateLoading(new File("D:\\IDEAWorkSpace\\freemarker_demo\\src\\main\\resources\\"));
//第三步:设置模板文件使用的字符集。一般就是 utf -8.
configuration.setDefaultEncoding("utf-8");
//第四步:加载一个模板,创建一个模板对象。
Template template = configuration.getTemplate("test.ftl");
//第五步:创建一个模板使用的数据集,可以是 pojo 也可以是 map。一般是 Map。
Map map = new HashMap();
map.put("name", "张学友");
map.put("message", "共你有过最美的邂逅,共你有过一些风雨忧愁。");
map.put("success", false);
List<Map> list = new ArrayList<Map>();
for (int i = 1; i <= 5; i++) {
Map m = new HashMap();
m.put("name", i);
list.add(m);
}
map.put("list", list);
map.put("now", new Date());
map.put("point", 123456789);
//第六步:创建一个 Writer 对象,一般创建一 FileWriter 对象,指定生成的文件名。
Writer out = new FileWriter(new File("d:\\test.html"));
//第七步:调用模板对象的 process 方法输出文件。
template.process(map, out);
//第八步:关闭流
out.close();
}
}
运算符
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)>
更多用法可参考官方在线手册 freemarker在线手册 |