freemarker 语法详解

1 截取字符串
有的时候我们在页面中不需要显示那么长的字符串，比如新闻标题，这样用下面的例子就可以自定义显示的长度
<#if title.content?length lt 8>
           <a href>${title.content?default("")}</a>
      <#else>
           <a href title="${title.content}">${title.content[0..3]?default("")}...</a>
</#if>
意思就是如果这个字符串的长度小于8，那么就正常显示，反之则取4位
注意：常用的比较运算符
=(==):判断两个值是否相等
!=:不相等
>(gt):判断左边是否大于右边
>=(gte):
<(lt):
<=(lte):
2 连接字符串
${"Hello," + user + "!"} //输出结果为:hello,swiftlet.net!

3 日期格式和boolean类型，转化为string类型
${lastUpdate?string("yyyy-MM-dd HH:mm:ss")}      
输出结果如下:
2003-04-08 21:24:44
<#assign foo=true/>
${foo?string("yes","no")} //输出结果:yes

4 排序
升序用sort_by()
<#list list?sort_by("字段") as x>
</#list>
降序用sort_by()?reverse
<#list list?sort_by("字段")?reverse as x>
</#list>

5 去空格
${xx?trim}

6 数值精度控制
mX:小数部分最小X位。
MX:小数部分最大X位。
<#assign x=2.582/>
<#assign y=4/>
#{x; M2}//2.58
#{y; M2}//4
#{x; m1M2}//2.58
#{y; m1M2}//4.0

7 内置函数

html:字符串中所有的特殊HTML字符都需要用实体引用来代替（比如<代替&lt;）
cap_first:字符串的第一个字母变为大写形式
lower_case:字符串的小写形式
upper_case:字符串的大写形式
trim:去掉字符串首尾的空格

序列使用的内建函数：
size：序列中元素的个数

数字使用的内建函数：
int:数字的整数部分（比如-1.9?int就是-1）9>.空值运算符

length:字符串的长度
string :把其他格式的数据，转化为string类型
${test?html}
${test?upper_case?html}

假设字符串test存储”Tom & Jerry”，那么输出为：

Tom &amp; Jerry
TOM &amp; JERRY

${seasons?size}
${seasons[1]?cap_first}

${"horse"?cap_first}
假设seasons存储了序列"winter", "spring", "summer", "autumn"，那么上面的输出将会是：
4
Spring
Horse
                    
8 顶层变量
所谓顶层变量就是直接放在数据模型中的值。
Map root = new HashMap();
root.put("name","admin");//name是一个顶层对象
对于顶层变量,直接使用${variableName}来输出变量值
       
9 集合连接运算符
集合连接运算是将两个集合连接成一个新的集合,连接集合的运算符是'+'.
<#list ["一","二","三"] + ["四","五","六"] as x>
    ${x}
</#list>
//输出结果如下:
一二三四五六

10 算术运算符
取整运算
<#assign x=5>
${(x/2)?>int}//2
${1.1?int}//1
${1.999?int} //1
${-1.1?int}//-1

11 list、break指令
<#list sequence as item>
  ...
</#list>
tem_index:当前变量的索引值.
item_has_next:是否存在下一个对象.
<#list ["星期一","星期二","星期三","星期四","星期五","星期六"] as x>
${x_index + 1}.${x}
<#if x_has_next>,</#if>
<#if x="星期四"><#break></#if>
</#list>
输出结果:
1.星期一,
2.星期二,
3.星期三,
4.兴趣四,

12.FreeMarker的变量必须赋值，否则就会抛出异常。而对于FreeMarker来说，null值和不存在的变量是完全一样的，因为FreeMarker无法理解null值。FreeMarker提供两个运算符来避免空值：
（1）!运算符：指定缺失变量的默认值；
（2）??运算符：判断变量是否存在。
!运算符有两种用法：variable!或variable!defaultValue。第一种用法不给变量指定默认值，表明默认值是空字符串、长度为0的集合、或长度为0的Map对象。
注意：使用!运算符指定默认值并不要求默认值的类型和变量类型相同。下面是一个小例子：
<#-- ${sss}没有定义这个变量，会报异常!-->
${sss!} <#--没有定义这个变量，默认值是空字符串!-->
${sss!"abc"} <#--没有定义这个变量，默认值是字符串abc!-->
??运算符返回布尔值，如：variable??，如果变量存在，返回true，否则返回false。一般情况下与if指令共同使用。将它和if指令合并，如下面的例子：如果user变量不存在的话将会忽略整个问候代码段：
<#if user??><h1>Welcome ${user}!</h1></#if>

13.操作字符串内置函数
1.substring（start,end）从一个字符串中截取子串
start:截取子串开始的索引，start必须大于等于0，小于等于end
end: 截取子串的长度，end必须大于等于0，小于等于字符串长度，如果省略该参数，默认为字符串长度。
2.cap_first 将字符串中的第一个单词的首字母变为大写。
3.uncap_first将字符串中的第一个单词的首字母变为小写。
4.capitalize将字符串中的所有单词的首字母变为大写
5.date，time，datetime将字符串转换为日期
注意：如果指定的字符串格式不正确将引发错误
6.ends_with 判断某个字符串是否由某个子串结尾，返回布尔值
注意：布尔值必须转换为字符串才能输出
7.html 用于将字符串中的<、>、&和"替换为对应得<>&quot:&amp
8.index_of（substring,start）在字符串中查找某个子串，返回找到子串的第一个字符的索引，如果没有找到子串，则返回-1。
Start参数用于指定从字符串的那个索引处开始搜索，start为数字值。
如果start大于字符串长度，则start取值等于字符串长度，如果start小于0，则start取值为0。
9.length返回字符串的长度
10.lower_case将字符串转为小写
11.upper_case将字符串转为大写
12.contains 判断字符中是否包含某个子串。返回布尔值
注意：布尔值必须转换为字符串才能输出
13.number将字符串转换为数字
14.replace用于将字符串中的一部分从左到右替换为另外的字符串。
15.split使用指定的分隔符将一个字符串拆分为一组字符串
16.trim 删除字符串首尾空格
操作数字内置函数
1.c 用于将数字转换为字符串
2.string用于将数字转换为字符串
Freemarker中预订义了三种数字格式：number,currency（货币）和percent(百分比)其中number为默认的数字格式转换
操作布尔值内置函数
string用于将布尔值转换为字符串输出
true转为"true"，false转换为"false"
foo?string("yes","no")如果布尔值是true,那么返回"yes",否则返回no

转载地址：Freemarker常用技巧