FreeMarker内置函数及其用法



在我们应用Freemarker 过程中，经常会操作例如字符串，数字，集合等，却不清楚Freemrker 有没有类似于Java 一样有相关的类及方法。在本文当中，我将向大家详细的介绍Freemarke 的内置函数及用法，以便能帮助大家更熟练的应用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>

<#if promo??> //判断promo是否存在

 <#list promo as pro>

    <#if pro.content?length gte 10>

          ${pro.content[0..10]}...//截取输出文字的长度

    <#else>

          ${pro.content}

  </#if>

</#list>

</#if>

 

三、          操作字符串函数

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