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:
<h1>我是head.ftl中的文本</h1>
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在线手册