Freemarker 惯用内置函数和用法

Freemarker 常用内置函数和用法

Freemarker 常用内置函数和用法 

一、   Sequence的内置函数 
1.      sequence?first 返回sequence的第一个值。 
2.      sequence?last 返回sequence的最后一个值。 
3.      sequence?reverse 将sequence的现有顺序反转,即倒序排序 
4.      sequence?size    返回sequence的大小 
5.      sequence?sort    将sequence中的对象转化为字符串后顺序排序 
6.      sequence?sort_by(value) 按sequence中对象的属性value进行排序 
注意:Sequence不能为null。 
二、           Hash的内置函数 
1.                      hash?keys 返回hash里的所有key,返回结果为sequence 
2.                      hash?values 返回hash里的所有value,返回结果为sequence 
例如: 
<#assign user={“name”:“hailang”, “sex”:“man”}> 
            <#assign keys=user?keys> 
            <#list keys as key> 
                ${key}=${user[key]} 
            </#list> 
三、           操作字符串函数 
1.                      substring(start,end)从一个字符串中截取子串 
start:截取子串开始的索引,start必须大于等于0,小于等于end 
end: 截取子串的长度,end必须大于等于0,小于等于字符串长度,如果省略该参数,默认为字符串长度。 
例子: 
${‘str’?substring(0)} 结果为str 
${‘str’?substring(1)} 结果为tr 
${‘str’?substring(2)} 结果为r 
${‘str’?substring(3)} 结果为 
${‘str’?substring(0,0)} 结果为 
${‘str’?substring(0,1)} 结果为s 
${‘str’?substring(0,2)} 结果为st 
${‘str’?substring(0,3)} 结果为str 
2.                      cap_first 将字符串中的第一个单词的首字母变为大写。 
${‘str’?cap_first} 结果为Str 
3.                      uncap_first将字符串中的第一个单词的首字母变为小写。 
${‘Str’?cap_first} 结果为str 
4.                      capitalize将字符串中的所有单词的首字母变为大写 
${‘str’? capitalize} 结果为STR 
5.                      date,time,datetime将字符串转换为日期 
例如: 
<#assign date1=”2009-10-12”?date(“yyyy-MM-dd”)> 
<#assign date2=”9:28:20”?time(“HH:mm:ss”)> 
<#assign date3=” 2009-10-12 9:28:20”?time(“HH:mm:ss”)> 
${date1} 结果为2009-10-12 
${date2} 结果为9:28:20 
${date3} 结果为2009-10-12 9:28:20 
注意:如果指定的字符串格式不正确将引发错误。 
6.                      ends_with 判断某个字符串是否由某个子串结尾,返回布尔值。 
${“string ”?ends_with(“ing”)?string } 返回结果为true 
注意:布尔值必须转换为字符串才能输出 
7.                      html 用于将字符串中的<、>、&和“替换为对应得&lt;&gt;&quot:&amp 
8.                      index_of(substring,start)在字符串中查找某个子串,返回找到子串的第一个字符的索引,如果没有找到子串,则返回-1。 
Start参数用于指定从字符串的那个索引处开始搜索,start为数字值。 
如果start大于字符串长度,则start取值等于字符串长度,如果start小于0, 则start取值为0。 
${“ string ”?index_of(“in”) 结果为3 
${“ string ”?index_of(“ab”) 结果为-1 
9.                      length返回字符串的长度 ${“ string ”?length} 结果为6 
10.                   lower_case将字符串转为小写 
${“ STRING ”?lower_case} à 结果为 string 
11.                   upper_case将字符串转为大写 
${“ string ”?upper_case} à 结果为 STRING 
12.                   contains 判断字符中是否包含某个子串。返回布尔值 
${“ string ”?contains(“ing”)? string } 结果为true 
    注意:布尔值必须转换为字符串才能输出 
13.                   number将字符串转换为数字 
${“111.11”?number} 结果为111.11 
14.                   replace用于将字符串中的一部分从左到右替换为另外的字符串。 
${“strabg”?replace(“ab”,”in”)} 结果为 string 
15.                    split使用指定的分隔符将一个字符串拆分为一组字符串 
<#list “This|is|split”?split(“|”) as s> 
    ${s} 
</#list> 
结果为: 
This 
is 
split 
16.                   trim 删除字符串首尾空格 ${“  String ”?trim} 结果为 String 
四、           操作数字 
1.                      c 用于将数字转换为字符串 
${123?c} 结果为123 
2.                      string 用于将数字转换为字符串 
Freemarker 中预订义了三种数字格式:number,currency(货币)和percent(百分比)其中number为默认的数字格式转换 
例如: 
<#assign tempNum=20> 
${tempNum}   
${tempNum? string .number}或${tempNum? string (“number”)} 结果为20 
${tempNum? string .currency}或${tempNum? string (“currency”)} 结果为¥20.00 
${tempNum? string . percent}或${tempNum? string (“percent”)} 结果为2,000% 
五、     操作布尔值 
string 用于将布尔值转换为字符串输出 
true转为“true”,false转换为“false” 
foo?string (“yes”,”no”)如果布尔值是true,那么返回“yes”,否则返回no