登录 注册

Freemarker 学习小结

本贴最后更新于 1550 天前，其中的信息可能已经时移世改

FreeMarker 简介

FreeMarker 是一个用 Java 语言编写的模板引擎，它基于模板来生成文本输出。FreeMarker 与 Web 容器无关，即在 Web 运行时，它并不知道 Servlet 或 HTTP。它不仅可以用作表现层的实现技术，而且还可以用于生成 XML，JSP 或 Java 等。

FreeMarker 有何作用

  • 从服务端来看，能减轻数据库访问压力，同时能部署在并发承载能力强的 Web 容器上(如 nginx)
  • 从 SEO(搜索引擎优化)来看，静态页面比动态页面更利于搜索引擎的检索，网站排名更靠前

FreeMarker 的特点

  • FreeMarker 不是一个 Web 应用框架，而适合作为 Web 应用框架一个组件
  • FreeMarker 与容器无关，因为它并不知道 HTTP 或 Servlet；FreeMarker 同样可以应用于非 Web 应用程序环境
  • FreeMarker 是免费的这是重点

入门小 DEMO

1.往 maven 库中导入 jar 包

下载地址：https://freemarker.apache.org/freemarkerdownload.html

下载这两文件，上面的包含 jar 包，下面的是源码

命令行进入到 包含 jar 包的目录，执行以下命令安装到本地仓库

mvn install:install-file -Dfile=W:\temp\freemarker.jar -DgroupId=org.apache.freemarker -DartifactId=freemarker -Dversion=2.3.29 -Dpackaging=jar

成功

2.创建 maven 项目

3.工程引入依赖

<dependency><!-- freemarker的依赖jar包 -->
	<groupId>org.apache.freemarker</groupId>
	<artifactId>freemarker</artifactId>
	<version>2.3.29</version>
</dependency>

创建模板文件

<html>
<head>
	<meta charset="utf-8">
	<title>${title} </title>
</head>
<body>
<#--我只是一个注释，我不会有任何输出  -->
${name},你好。${message}
</body>
</html>

创建测试类并执行

//1.创建配置类
Configuration configuration = new Configuration(Configuration.getVersion());
//2.设置模板所在的目录 
configuration.setDirectoryForTemplateLoading(new File("W:\\我的网站\\网站开发\\Code\\java\\StudyDemo\\src\\main\\resources\\template\\"));
//3.设置字符集
configuration.setDefaultEncoding("utf-8");
//4.加载模板
Template template = configuration.getTemplate("test.ftl");
//5.创建数据模型     实体类 或者 Map
HashMap map = new HashMap();
map.put("title", "标题");
map.put("name", "康娜");
map.put("message", "蝉被吃了");
//6.创建Writer对象
FileWriter out = new FileWriter(new File("W:\\我的网站\\网站开发\\Code\\java\\StudyDemo\\src\\main\\webapp\\test.html"));
//7.输出
template.process(map, out);
//8.释放资源
out.close();

查看执行结果

这是自动生成的 test.html 代码

<html>
<head>
	<meta charset="utf-8">
	<title>标题 </title>
</head>
<body>
康娜,你好。蝉被吃了
</body>
</html>

FTL 指令

PS：以下测试均是在 test.ftl 中加入，test.html 中看效果

assign 指令：用于在页面上定义一个变量

<#--定义简单类型  -->
<#assign linkman="小林">
联系人：${linkman}
<#--定义对象类型  -->
<#assign info={"mobile":"326666666",'address':'二次元XXX界XX镇XX栋XX号XXX'} >
电话：${info.mobile}  地址：${info.address}

test.html 中生成的内容

联系人：小林
电话：326666666  地址：二次元XXX界XX镇XX栋XX号XXX

include 指令：用于模板文件的嵌套

ftl 中的
<#include "head.ftl">
test.html 中生成的内容

<h1>这是header.ftl内的内容</h1>

if 指令

Java 测试类添加
map.put("isTrueVarible", true);
ftl 添加
<#--if 指令 -->
<#if isTrueVarible=true>
结果符合条件执行的代码
<#else>
结果不符合条件执行的代码
</#if>
HTML 结果
结果符合条件执行的代码

list 指令

Java 测试类添加

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); //添加数据

ftl 文件

----商品价格表----<br />
<#list goodsList as goods>
  ${goods_index+1} 商品名称： ${goods.name} 价格：${goods.price}<br>
</#list>

HTML 生成的

----商品价格表----<br />
  1 商品名称： 苹果 价格：5.8<br>
  2 商品名称： 香蕉 价格：2.5<br>
  3 商品名称： 橘子 价格：3.2<br>

内建函数

内建函数语法格式： 变量 +?+ 函数名称

获取集合大小

ftl

共  ${goodsList?size}  条记录

HTML 生成的

共  3  条记录

转换 JSON 字符串为对象

JSON 格式
对象{}
数组[]
ftl 模板文件，注意这里 text= 的是 JSON 字符串

 <#assign text="{'bank':'工商银行','account':'10101920201920212'}" />
	<#assign data=text?eval />
	开户行：${data.bank}  账号：${data.account}

HTML 生成的

开户行：工商银行  账号：10101920201920212

日期格式化

代码中对变量赋值
map.put("today", new Date());

ftl 模板文件

当前日期：${today?date} <br> 
当前时间：${today?time} <br>   
当前日期+时间：${today?datetime} <br>        
日期格式化：  ${today?string("yyyy年MM月")}

HTML 生成的

当前日期：2020-1-11 <br> 
当前时间：17:33:45 <br>   
当前日期+时间：2020-1-11 17:33:45 <br>        
日期格式化：  2020年01月

数字转换为字符串

代码中对变量赋值
map.put("today", new Date());

修改模板

累计积分：${point}

HTML 生成的

累计积分：102,920,122

空值处理运算符

用来处理 null 时程序运行中止，提示程序的健壮性
在模板中使用了变量但是在代码中没有对变量赋值，那么运行生成时会抛出异常。但是有些时候，有的变量确实是 null

判断某变量是否存在：“??”

ftl

<#if aaa??>
aaa变量存在
<#else>
aaa变量不存在
</#if>

HTML

aaa变量不存在

缺失变量默认值：“!”(建议习惯用这种方式)

ftl

${aaa!'aaa没有被赋值'}

HTML

aaa没有被赋值

算数运算符

FreeMarker 表达式中完全支持算术运算，FreeMarker 支持的算术运算符包括：+, - , * , / , %

逻辑运算符

逻辑运算符有如下几个：
逻辑与：&&
逻辑或：||
逻辑非：!
逻辑运算符只能作用于布尔值，否则将产生错误

比较运算符

1 = 或者 ==:判断两个值是否相等。
2 !=:判断两个值是否不等。
3 > 或者 gt:判断左边值是否大于右边值
4 >= 或者 gte:判断左边值是否大于等于右边值
5 < 或者 lt:判断左边值是否小于右边值
6 <= 或者 lte:判断左边值是否小于等于右边值

注意: = 和！= 可以用于字符串，数值和日期来比较是否相等，但 = 和！= 两边必须是相同类型的值，否则会产生错误，而且 FreeMarker 是精确比较，"x","x ","X"是不等的。其它的运行符可以作用于数字和日期，但不能作用于字符串，大部分的时候，使用 gt 等字母运算符代替 > 会有更好的效果，因为 FreeMarker 会把 > 解释成 FTL 标签的结束字符，当然，也可以使用括号来避免这种情况，如：<#if (x>y)>

去掉数字默认带的三位

默认的显示格式

${aaa!0 + 1000000000}

1,000,000,000

去掉后

${(aaa!0 + 1000000000)?c }

1000000000
  • FreeMarker

    FreeMarker 是一款好用且功能强大的 Java 模版引擎。

    23 引用 • 20 回帖 • 427 关注
南昌 位置
613 23 92 43 162 19 28 240

相关帖子

回帖
Freemarker 学习小结

欢迎来到这里！

我们正在构建一个小众社区，大家在这里相互信任，以平等 • 自由 • 奔放的价值观进行分享交流。最终，希望大家能够找到与自己志同道合的伙伴，共同成长。

注册 关于
请输入回帖内容 ...
someone56575
南昌
回帖
12
 帖子
11
 积分
595