FreeMarker小总结

FreeMarker常用指令

前言

工作中经常用到FreeMarker模板引擎来发邮件、打印、还可以做网页静态化等功能，总结下，做下笔记。

原理

1.FTL指令

assign指令

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

1. 定义简单类型

<#assign linkman="周先生">
联系人：${linkman}

2. 定义对象类型

<#assign info={"mobile":"40082008820",'address':'深圳市宝安区固戍街道'} >
电话：${info.mobile}  地址：${info.address}

include指令

此指令用于模板文件的嵌套
创建模板文件head.ftl

<h1>test</h1>

我们修改test.ftl，在模板文件中使用include指令引入刚才我们建立的模板

<#include "head.ftl">

if指令

在代码中对success变量赋值
map.put("success", true);
/*-----------------------------*/
<#if success=true>
  true
<#else>  
  false
</#if>

list指令

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

如果想在循环中得到索引，使用循环变量+_index就可以得到。

2.内建函数

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

1. 获取集合大小
   ${变量?size}
2. 转换JSON字符串为对象

<#assign text="{'bank':'工商银行','account':'45646513554654687465416'}" />
	<#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}
   页面显示：

我们会发现数字会以每三位一个分隔符显示，有些时候我们不需要这个分隔符，就需要将数字转换为字符串,使用内建函数c
累计积分：${point?c}
页面显示效果如下：

3.空值处理运算符

如果你在模板中使用了变量但是在代码中没有对变量赋值，那么运行生成时会抛出异常。但是有些时候，有的变量确实是null，怎么解决这个问题呢？

1. 判断某变量是否存在:“??”
   用法为:variable??,如果该变量存在,返回true,否则返回false

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

2. 缺失变量默认值:“!”
   我们除了可以判断是否为空值，也可以使用!对null值做转换处理
   在模板文件中加入

${aaa!'-'}

在代码中不对aaa赋值，也不会报错了 ，当aaa为null则返回！后边的内容-

4.运算符

• 算数运算符
  FreeMarker表达式中完全支持算术运算,FreeMarker支持的算术运算符包括:+, - , * , / , %
• 逻辑运算符
  逻辑运算符有如下几个:
  逻辑与:&&
  逻辑或:||
  逻辑非:!

逻辑运算符只能作用于布尔值,否则将产生错误

• 比较运算符
  表达式中支持的比较运算符有如下几个:
  1 =或者==:判断两个值是否相等.
  2 !=:判断两个值是否不等.
  3 >或者gt:判断左边值是否大于右边值
  4 >=或者gte:判断左边值是否大于等于右边值
  5 <或者lt:判断左边值是否小于右边值
  6 <=或者lte:判断左边值是否小于等于右边值

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

后记

day day up