FreeMarker惯用内置函数

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

<span style="color:#FF0000;">2、Hash的内置函数</span> 1.hash?keys 返回hash里的全部key,返回结果为sequence 2.hash?values 返回hash里的全部value,返回结果为sequence <span style="color:#FF0000;"> 3、操做字符串函数</span> 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 用于将字符串中的<、>、&和"替换为对应得<>":& 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 删除字符串首尾空格 <span style="color:#FF0000;">4、操做数字</span> 1.c 用于将数字转换为字符串 2.string用于将数字转换为字符串 Freemarker中预订义了三种数字格式:number,currency(货币)和percent(百分比)其中number为默认的数字格式转换 <span style="color:#FF0000;">五操做布尔值 </span> string 用于将布尔值转换为字符串输出 true转为"true",false转换为"false" foo?string("yes","no")若是布尔值是true,那么返回"yes",不然返回no <#assign x = "aa"/> <#if x=="aa"> x is aa <#else> x not aa </#if> <span style="color:#FF0000;">遍历 list map</span> <#list somelist as item> ${item} //若是是bean ${item.title} </#list> 判断list的长度 <#if somlist?size>0> </#if>
遍历map

<#list mapObj?keys as k> <#assign item = mapObj[k]> //or <#assign item = mapObj.get(k)> ${item.title} </#list> 防止null 值 黄色警告页面 ${(item.title)!"一些默认值"} freemarker 是能够调用java 里面的方法的 如 myList 是一个list ${myList.size()} 将输出list 的长度 freemarker 大于 小于 大于等于 小于等于 <#if x gt 1> "gt" 大于 </#if> <span style="color:#FF0000;">freemarker 经常使用内置函数的使用方法 </span> 在咱们应用Freemarker过程当中,常常会操做例如字符串,数字,集合等,却不清楚Freemrker有没有相似于Java同样有相关的类及方法。在本文当中,我将向你们详细的介绍Freemarke的内置函数及用法,以便能帮助你们更熟练的应用Freemarker完成项目开发。 <span style="color:#FF0000;">1、 Sequence的内置函数</span> 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。以上方法在个人另外一篇博客Freemarker中如何遍历List有详细的应用,感兴趣的朋友能够参考。 <span style="color:#FF0000;">2、Hash的内置函数</span> 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> <span style="color:#FF0000;"> 3、 操做字符串函数</span> 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 用于将字符串中的<、>、&和“替换为对应得<>":& 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 <span style="color:#FF0000;">4、操做数字</span> 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% <span style="color:#FF0000;">5、 操做布尔值</span> string 用于将布尔值转换为字符串输出 true转为“true”,false转换为“false” foo?string(“yes”,”no”)若是布尔值是true,那么返回“yes”,不然返回no <span style="color:#FF0000;">freemarker List的遍历</span> Freemarker中如何遍历List摘要:在Freemarker应用中常常会遍历List获取须要的数据, 并对须要的数据进行排序加工后呈现给用户。那么在Freemarker中如何遍历List, 并对List中数据进行适当的排序呢? 经过下文的介绍,相信您必定会找到答案。 <span style="color:#FF0000;">1、 Freemarker中list指令简单介绍</span> 要想在Freemarker中遍历list,必须经过使用list指令,即<#list sequence as item>…</#list> sequence是集合(collection)的表达式,item是循环变量的名字,不能是表达式。 当在遍历sequence时,会将遍历变量的值保存到item中。 举个例子说明吧: <#list userList as user> … </#list> userList中封装了不少个User对象,咱们在遍历userList时候,会将遍历的User对象的值,保存到上述的user变量中。 那么在取值时,咱们能够经过${user.userName }来获取User对象的userName属性值。 List指令还隐含了两个循环变量: item_index:当前迭代项在全部迭代项中的位置,是数字值。 item_has_next:用于判断当前迭代项是不是全部迭代项中的最后一项。 注意:在使用上述两个循环变量时,必定要将item换成你本身定义的循环变量名,item其实就是前缀罢了。 例如,若是你使用<# list list as l>..</#list>定义,那么就要使用l_index,l_has_next。 在循环过程当中,若是您想跳出循环,那么可使用结合break指令,即<#break>来完成。 <span style="color:#FF0000;">2、 Freemarker中对List进行排序</span> 一般咱们的排序操做都是经过DAO层来实现的,若是咱们想随时更改咱们的排序,那么就必须修改咱们的DAO层代码, 确实不方便。但Freemarker为咱们提供了这样的排序方法,解决了这个问题。 1. sort升序排序函数 sort对序列(sequence)进行排序,要求序列中的变量必须是:字符串(按首字母排序),数字,日期值。 <#list list?sort as l>…</#list> 2. sort_by函数 sort_by有一个参数,该参数用于指定想要排序的子变量,排序是按照变量对应的值进行排序,如: <#list userList?sort_by(“age”) as user>…</#list> age是User对象的属性,排序是按age的值进行的。 3. reverse降序排序函数 <#list list? reverse as l>…</#list> reverse使用同sort相同。reverse还能够同sort_by一块儿使用 如:想让用户按年龄降序排序,那么能够这个样写<#list userList?sort_by(“age”)?reverse as user>…</#list> "_index"是FreeMarker中对于循环索引变量的命名约定。  经过“迭代变量名_index”便可访问当前循环索引。  相似的循环状态访问约定还有“迭代变量名_has_next”,可经过这个循环状态属性判断是否还有后继循环。 因不少时候要用到“序号”、“索引”之类的东西,而FreeMarker恰好本身带有,但不少人还并不知道它的妙用。所以就从Spring开发指南摘录下来。 这样能够避免另申请一个变量,而后每次循环体又对它+1了。 不知道是否提到过这个。 <#list subDir as d>  <input type="checkbox" name="ids" value="file-${d_index}"/> </#list> <span style="color:#FF0000;">FreeMarker 基础知识 表达式(引用)</span> 表达式是FreeMarker的核心功能,FreeMarker中的插值支持多种表达式。 <span style="color:#FF6666;">1、直接指定值</span> 直接指定值能够是字符串、数值、布尔值、集合及Map对象。 1. 字符串 直接指定字符串值使用单引号或双引号限定。字符串中可使用转义字符”\"。若是字符串内有大量的特殊字符,则能够在引号的前面加上一个字母r,则字符串内的全部字符都将直接输出。2. 数值 数值能够直接输入,不须要引号。FreeMarker不支持科学计数法。3. 布尔值 直接使用true或false,不使用引号。4. 集合 集合用中括号包括,集合元素之间用逗号分隔。 使用数字范围也能够表示一个数字集合,如1..5等同于集合[1, 2, 3, 4, 5];一样也能够用5..1来表示[5, 4, 3, 2, 1]。5. Map对象 Map对象使用花括号包括,Map中的key-value对之间用冒号分隔,多组key-value对之间用逗号分隔。 注意:Map对象的key和value都是表达式,但key必须是字符串。 <span style="color:#FF6666;">2、输出变量值</span> FreeMarker的表达式输出变量时,这些变量能够是顶层变量,也能够是Map对象的变量,还能够是集合中的变量,并可使用点(.)语法来访问Java对象的属性。1. 顶层变量 所谓顶层变量就是直接放在数据模型中的值。输出时直接用${variableName}便可。2. 输出集合元素 能够根据集合元素的索引来输出集合元素,索引用中括号包括。如: 输出[“1”, “2”, “3”]这个名为number的集合,能够用${number[0]}来输出第一个数字。FreeMarker还支持用number[1..2]来表示原集合的子集合[“2”, “3”]。3. 输出Map元素 对于JavaBean实例,FreeMarker同样把它看做属性为key,属性值为value的Map对象。 输出Map对象时,可使用点语法或中括号语法,以下面的几种写法的效果是同样的:    book.author.name    book.author["name"]    book["author"].name    book["author"]["name"] 使用点语法时,变量名字有和顶层变量同样的限制,但中括号语法没有任何限制。 <span style="color:#FF6666;">3、字符串操做</span> 1. 字符串链接 字符串链接有两种语法: (1) 使用${..}或#{..}在字符串常量内插入表达式的值; (2) 直接使用链接运算符“+”链接字符串。 如,下面两种写法等效:    ${"Hello, ${user}"}    ${"Hello, " + user + "!"} 有一点须要注意: ${..}只能用于文本部分做为插值输出,而不能用于比较等其余用途,如:    <#if ${isBig}>Wow!</#if>    <#if "${isBig}">Wow!</#if> 应该写成:    <#if isBig>Wow!</#if> 2. 截取子串 截取子串能够根据字符串的索引来进行,若是指定一个索引值,则取得字符串该索引处的字符;若是指定两个索引值,则截取两个索引中间的字符串子串。如:    <#assign number="01234">    ${number[0]} <#-- 输出字符0 -->    ${number[0..3]} <#-- 输出子串“0123” --> <span style="color:#FF6666;">4、集合链接操做</span>  链接集合的运算符为“+” <span style="color:#FF6666;">5、Map链接操做</span> Map链接操做的运算符为“+” <span style="color:#FF6666;">6、算术运算符</span> FreeMarker表达式中支持“+”、“-”、“*”、“/”、“%”运算符。 <span style="color:#FF6666;">7、比较运算符</span> 表达式中支持的比较运算符有以下几种: 1. =(或者==): 判断两个值是否相等; 2. !=: 判断两个值是否不相等; 注: =和!=能够用做字符串、数值和日期的比较,但两边的数据类型必须相同。并且FreeMarker的比较是精确比较,不会忽略大小写及空格。 3. >(或者gt): 大于 4. >=(或者gte): 大于等于 5. <(或者lt): 小于 6. <=(或者lte): 小于等于 注: 上面这些比较运算符能够用于数字和日期,但不能用于字符串。大部分时候,使用gt比>有更好的效果,由于FreeMarker会把>解释成标签的结束字符。可使用括号来避免这种状况,如:<#if (x>y)>。8、逻辑运算符 1. &&: 逻辑与; 2. ||: 逻辑或; 3. !: 逻辑非 逻辑运算符只能用于布尔值。9、内建函数 FreeMarker提供了一些内建函数来转换输出,能够在任何变量后紧跟?,?后紧跟内建函数,就能够经过内建函数来转换输出变量。字符串相关经常使用的内建函数: 1. html: 对字符串进行HTML编码; 2. cap_first: 使字符串第一个字母大写; 3. lower_case: 将字符串转成小写; 4. upper_case: 将字符串转成大写;集合相关经常使用的内建函数: 1. size: 得到集合中元素的个数;数字值相关经常使用的内建函数: 1. int: 取得数字的整数部分。10、空值处理运算符 FreeMarker的变量必须赋值,不然就会抛出异常。而对于FreeMarker来讲,null值和不存在的变量是彻底同样的,由于FreeMarker没法理解null值。 FreeMarker提供两个运算符来避免空值: <span style="color:#FF0000;">1. !: 指定缺失变量的默认值; 2. ??:判断变量是否存在。</span> !运算符有两种用法:variable!或variable!defaultValue。第一种用法不给变量指定默认值,代表默认值是空字符串、长度为0的集合、或长度为0的Map对象。 使用!运算符指定默认值并不要求默认值的类型和变量类型相同。 ??运算符返回布尔值,如:variable??,若是变量存在,返回true,不然返回false。 freemarker 的内建函数 contains 的使用 freemarker 的内建函数 contains 的使用 关键字: freemarker contains freemarker 的内建函数 contains 的使用: <#if employee.departments?contains(department)>checked="checked"</#if> 其中departments是一个集合,而department是departments集合里的一个元素。contains函数能够判断出,元素 department是否存在于集合departments里,最终返回一个Booleancontains是freemarker的内建函数,即自带的 。 FreeMarker 的内建函数有: chunk, is_date, last, root, j_string, round, contains, is_hash, long, float, ends_with, namespace, matches, time, values, seq_last_index_of, uncap_first, byte, substring, is_transform, web_safe, groups, seq_contains, is_macro, index_of, word_list, int, is_method, eval, parent, xml, number, capitalize, if_exists, rtf, node_type, double, is_directive, url, size, default, floor, ceiling, is_boolean, split, node_name, is_enumerable, seq_index_of, is_sequence, sort, is_node, sort_by, left_pad, cap_first, interpret, children, node_namespace, chop_linebreak, date, short, last_index_of, is_collection, ancestors, length, trim, datetime, is_string, reverse, c, keys, upper_case, js_string, has_content, right_pad, replace, is_hash_ex, new, is_number, lower_case, is_indexable, string, exists, html, first
相关文章
相关标签/搜索