FreeMarker--表达式和运算符的用法(全面/有示例)
原文网址：FreeMarker--表达式和运算符的用法(全面/有示例)_IT利刃出鞘的博客-CSDN博客
简介
本文介绍FreeMarker的表达式和运算符的用法。
表达式是FreeMarker的核心功能。表达式放置在插值语法（${...}）之中时，表明需要输出表达式的值，表达式语法也可以与FreeMarker标签结合，用于控制输出。
直接指定值
a、字符串
${"我的文件保存在C:\\盘"}
${'我名字是\"annlee\"'}输出结果是:
我的文件保存在C:\盘
我名字是"annlee"FreeMarker支持如下转义字符:
- \";双引号(u0022)
- \';单引号(u0027)
- \\;反斜杠(u005C)
- \n;换行(u000A)
- \r;回车(u000D)
- \t;Tab(u0009)
- \b;退格键(u0008)
- \f;Form feed(u000C)
- \l;<
- \g;>
- \a;&
- \{;{
- \xCode;直接通过4位的16进制数来指定Unicode码,输出该unicode码对应的字符.
如果某段文本中包含大量的特殊符号,FreeMarker提供了另一种特殊格式：可以在指定字符串内容的引号前增加r标记，在r标记后的文件将会直接输出。看如下代码:
${r"${foo}"}
${r"C:\foo\bar"}输出结果是:
${foo}
C:\foo\barb、数值
表达式中的数值直接输出，不需要引号，小数点使用"."分隔，不能使用分组","符号。FreeMarker目前还不支持科学计数法，所以"1E3"是错误 的。FreeMarker表达式中使用数值需要注意以下几点：
- 数值不能省略小数点前面的0，所以".5"是错误的写法
- 数值8 , +8 , 8.00都是相同的
c、布尔值
直接使用true和false，不使用引号。
d、日期型
FreeMarker支持date、time、datetime三种类型，这三种类型的值无法直接指定，通常需要借助字符串的date、time、datetime三个内建函数进行转换才可以
<#assign test1 = "2009-01-22"?date("yyyy-MM-dd") />;
<#assign test2 ="16:34:43"?time("HH:mm:ss") />
<#assign test2 = "2009-01-22 17:23:45"?datetime("yyyy-MM-dd HH:mm:ss") />
${test1?string.full}e、集合
集合以方括号包括,各集合元素之间以英文逗号","分隔,看如下的例子:
<#list ["星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期天"] as x>
${x}
输出结果是:
星期一
星期二
星期三
星期四
星期五
星期六
星期天除此之外,集合元素也可以是表达式,例子如下:
[2 + 2, [1, 2, 3, 4], "whatnot"]还可以使用数字范围定义数字集合,如2..5等同于[2, 3, 4, 5],但是更有效率.注意,使用数字范围来定义集合时无需使用方括号,数字范围也支持反递增的数字范围,如5..2
f、Map集合
Map对象使用花括号包括,Map中的key-value对之间以英文冒号":"分隔,多组key-value对之间以英文逗号","分隔.下面是一个例子:
{"语文":78, "数学":80}Map对象的key和value都是表达式，但是key必须是字符串.
输出变量值
FreeMarker的表达式输出变量时，这些变量可以是顶层变量，也可以是Map对象中的变量，还可以是集合中的变量，并可以使用点(.)语法来访问Java对象的属性。下面分别讨论这些情况
a、顶层变量
所谓顶层变量就是直接放在数据模型中的值，例如有如下数据模型:
Map root = new HashMap(); //创建数据模型
root.put("name","annlee"); //name是一个顶层变量对于顶层变量，直接使用${variableName}来输出变量值，变量名只能是字母，数字，下划线，$，@和#的组合，且不能以数字开头号.为了输出上面的name的值，可以使用如下语法:
${name}b、输出集合元素
如果需要输出集合元素，则可以根据集合元素的索引来输出集合元素，集合元素的索引以方括号指定.假设有索引:
["星期一"，"星期二"，"星期三"，"星期四"，"星期五"，"星期六"，"星期天"]该索引名为week，如果需要输出星期三，则可以使用如下语法:
${week[2]} //输出第三个集合元素此外，FreeMarker还支持返回集合的子集合，如果需要返回集合的子集合，则可以使用如下语法:
week[3..5] //返回week集合的子集合，子集合中的元素是week集合中的第4-6个元素c、输出Map元素
这里的Map对象可以是直接HashMap的实例，甚至包括JavaBean实例，对于JavaBean实例而言，我们一样可以把其当成属性为key，属性值为value的Map实例。为了输出Map元素的值，可以使用点语法或方括号语法。假如有下面的数据模型:
Map root = new HashMap();
Book book = new Book();
Author author = new Author();
author.setName("annlee");
author.setAddress("gz");
book.setName("struts2");
book.setAuthor(author);
root.put("info","struts");
root.put("book", book);为了访问数据模型中名为struts2的书的作者的名字,可以使用如下语法:
book.author.name //全部使用点语法
book["author"].name
book.author["name"] //混合使用点语法和方括号语法
book["author"]["name"] //全部使用方括号语法使用点语法时，变量名字有顶层变量一样的限制，但方括号语法没有该限制，因为名字可以是任意表达式的结果。
字符串操作
FreeMarker的表达式对字符串操作非常灵活，可以将字符串常量和变量连接起来，也可以返回字符串的子串等。
字符串连接有两种语法:
- 使用${..}或#{..}在字符串常量部分插入表达式的值,从而完成字符串连接.
- 直接使用连接运算符+来连接字符串
例如有如下数据模型:
Map root = new HashMap(); root.put("user","annlee");下面将user变量和常量连接起来:
${"hello, ${user}!"} //使用第一种语法来连接
${"hello, " + user + "!"} //使用+号来连接上面的输出字符串都是hello,annlee!，可以看出这两种语法的效果完全一样。
值得注意的是，${..}只能用于文本部分，不能用于表达式，下面的代码是错误的:
<#if ${isBig}>Wow!
<#if "${isBig}">Wow!应该写成
<#if isBig>Wow!截取子串可以根据字符串的索引来进行，截取子串时如果只指定了一个索引值，则用于取得字符串中指定索引所对应的字符;如果指定两个索引值，则返回两个索引中间的字符串子串.假如有如下数据模型：
Map root = new HashMap(); root.put("book","struts2,freemarker");可以通过如下语法来截取子串:
${book[0]}${book[4]} //结果是su
${book[1..4]} //结果是tru集合连接运算符
这里所说的集合运算符是将两个集合连接成一个新的集合，连接集合的运算符是+，看如下的例子:
<#list ["星期一","星期二","星期三"] + ["星期四","星期五","星期六","星期天"] as x>
${x}
输出结果是:
星期一 星期二 星期三 星期四 星期五 星期六 星期天Map连接运算符
Map对象的连接运算符也是将两个Map对象连接成一个新的Map对象，Map对象的连接运算符是+，如果两个Map对象具有相同的key，则右边的值替代左边的值。看如下的例子:
<#assign scores = {"语文":86,"数学":78} + {"数学":87,"Java":93}>
语文成绩是${scores.语文}
数学成绩是${scores.数学}
Java成绩是${scores.Java}输出结果是:
语文成绩是86
数学成绩是87
Java成绩是93算术运算符
FreeMarker表达式中完全支持算术运算，FreeMarker支持的算术运算符包括:+， - ， * ， / ， % 看如下的代码：
<#assign x=5>
${ x * x - 100 }
${ x /2 }
${ 12 %10 }输出结果是:
-75 2.5 2在表达式中使用算术运算符时要注意以下几点:
- 运算符两边的运算数字必须是数字
- 使用+运算符时，如果一边是数字，一边是字符串，就会自动将数字转换为字符串再连接，如:${3 + "5"}，结果是:35
使用内建的int函数可对数值取整，如:
<#assign x=5>
${ (x/2)?int }
${ 1.1?int }
${ 1.999?int }
${ -1.1?int }
${ -1.999?int }结果是:
2 1 1 -1 -1比较运算符
表达式中支持的比较运算符有如下几个:
- =或者==:判断两个值是否相等.
- !=:判断两个值是否不等.
- >或者gt:判断左边值是否大于右边值
- >=或者gte:判断左边值是否大于等于右边值
- <或者lt:判断左边值是否小于右边值
- <=或者lte:判断左边值是否小于等于右边值
注意：=和!=可以用于字符串，数值和日期来比较是否相等，但=和!=两边必须是相同类型的值，否则会产生错误，而且FreeMarker是精确比较，"x"，"x "，"X"是不等的。其它的运行符可以作用于数字和日期，但不能作用于字符串，大部分的时候，使用gt等字母运算符代替>会有更好的效果，因为 FreeMarker会把>解释成FTL标签的结束字符，当然，也可以使用括号来避免这种情况，如:<#if (x>y)>
逻辑运算符
逻辑运算符有如下几个：
逻辑与：&&
逻辑或：||
逻辑非：!
逻辑运算符只能作用于布尔值，否则将产生错误
内建函数
FreeMarker还提供了一些内建函数来转换输出，可以在任何变量后紧跟?，?后紧跟内建函数，就可以通过内建函数来轮换输出变量。下面是常用的内建的字符串函数:
- html：对字符串进行HTML编码
- cap_first：使字符串第一个字母大写
- lower_case：将字符串转换成小写
- upper_case：将字符串转换成大写
- trim：去掉字符串前后的空白字符
下面是集合的常用内建函数
- size：获取序列中元素的个数
下面是数字值的常用内建函数
- int：取得数字的整数部分，结果带符号
例如:
<#assign test="Tom & Jerry">
${test?html}
${test?upper_case?html}结果是:
Tom & Jerry TOM & JERRY空值处理运算符
概述
在FreeMarker中，不存在的变量和null都属于空值。
FreeMarker对空值的处理非常严格，FreeMarker的变量必须有值，没有被赋值的变量就会抛出异常，因为FreeMarker未赋值的变量强制出错可以杜绝很多潜在的错误，如缺失潜在的变量命名，或者其他变量错误。
为了处理缺失变量，FreeMarker提供了两个运算符。
- !：指定缺失变量的默认值
- ??：判断某个变量是否存在
用!指定默认值时，不要求默认值的类型和变量类型相同。
用??运算符非常简单，它总是返回一个布尔值，用法为：variable??，如果该变量存在，返回true，否则返回false。
!运算符的用法有如下两种:
- variable!
- variable!defaultValue
第1种用法不给缺失的变量指定默认值，表明默认值是空字符串，长度为0的集合，或者长度为0的Map对象。
第2种用法给缺失的变量指定默认值。
示例
通过exists关键字或者"??"运算符判断是否存在
都将返回一个布尔值
<#if user.name?exists>
//TO DO
<#if user.age??>
//TO DO
忽略null值
假设前提：user.name为null
- ${user.name}
- 异常
- ${user.name!}
- 显示空白（空字符串）
- ${user.name!'vakin'}
- 若user.name不为空则显示本身的值否则显示vakin
- ${user.name?default('vakin')}
- 若user.name不为空则显示本身的值否则显示vakin
- ${user.name???string(user.name,'vakin')}
- 若user.name不为空则显示本身的值否则显示vakin
加不加括号
- product.color??
- 只测试color是否为null
-
(product.color)??
- 测试product和color是否为null
运算符的优先级
FreeMarker中的运算符优先级如下(由高到低排列):
- 一元运算符：!
- 内建函数：?
- 乘除法：*， / ， %
- 加减法：- ， +
- 比较：> ， < ， >= ， <= (lt ， lte ， gt ， gte)
- 相等：== ， = ， !=
- 逻辑与：&&
- 逻辑或：||