freemarker_常用内置函数
freemarker 常用内置函数文章分类:Java编程1。在模板里边 变量引用使用：${a}, 如果给<#macro aa tmp=a > 这不需要 $,可以给模板注入一些自定义的函数 ，这个比较常用.=======================接下来 将网上一些 内置函数 记录下来一、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,返回结果为sequence2.hash?values 返回hash里的所有value,返回结果为sequence三、操作字符串函数1.substring（start,end）从一个字符串中截取子串start:截取子串开始的索引，start必须大于等于0，小于等于endend: 截取子串的长度，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 删除字符串首尾空格四、操作数字1.c 用于将数字转换为字符串2.string用于将数字转换为字符串Freemarker中预订义了三种数字格式：number,currency（货币）和percent(百分比)其中number为默认的数字格式转换五操作布尔值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>遍历 list map<#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> 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。以上方法在我的另一篇博客Freemarker中如何遍历List有详细的应用，感兴趣的朋友可以参考。二、 Hash的内置函数1. hash?keys 返回hash里的所有key,返回结果为sequence2. 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，小于等于endend: 截取子串的长度，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)}à结果为str2. cap_first 将字符串中的第一个单词的首字母变为大写。${‘str’？cap_first}à结果为Str3. uncap_first将字符串中的第一个单词的首字母变为小写。${‘Str’？cap_first}à结果为str4. capitalize将字符串中的所有单词的首字母变为大写${‘str’？ capitalize}à结果为STR5. 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”) à结果为-19. length返回字符串的长度 ${“string”?length}à结果为610. lower_case将字符串转为小写${“STRING”?lower_case}à结果为string11. upper_case将字符串转为大写${“string”?upper_case}à结果为STRING12. contains 判断字符中是否包含某个子串。返回布尔值 ${“string”?contains(“ing”)?string} à结果为true 注意：布尔值必须转换为字符串才能输出13. number将字符串转换为数字${“111.11”?number}à结果为111.1114. replace用于将字符串中的一部分从左到右替换为另外的字符串。${“strabg”?replace(“ab”,”in”)} à结果为string15. split使用指定的分隔符将一个字符串拆分为一组字符串<#list “This|is|split”?split(“|”) as s> ${s}</#list>结果为:Thisissplit16. trim 删除字符串首尾空格 ${“ String ”?trim} à结果为String 四、 操作数字1. c 用于将数字转换为字符串${123?c} à结果为1232. 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”,否则返回nofreemarker List的遍历Freemarker中如何遍历List摘要：在Freemarker应用中经常会遍历List获取需要的数据，并对需要的数据进行排序加工后呈现给用户。那么在Freemarker中如何遍历List，并对List中数据进行适当的排序呢？通过下文的介绍，相信您一定会找到答案。一、 Freemarker中list指令简单介绍要想在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>来完成。二、 Freemarker中对List进行排序通常我们的排序操作都是通过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>FreeMarker 基础知识 表达式(引用)表达式是FreeMarker的核心功能，FreeMarker中的插值支持多种表达式。一、直接指定值直接指定值可以是字符串、数值、布尔值、集合及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必须是字符串。二、输出变量值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"] 使用点语法时，变量名字有和顶层变量一样的限制，但中括号语法没有任何限制。三、字符串操作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” -->四、集合连接操作 连接集合的运算符为“+”五、Map连接操作Map连接操作的运算符为“+”六、算术运算符FreeMarker表达式中支持“+”、“－”、“*”、“/”、“%”运算符。七、比较运算符表达式中支持的比较运算符有如下几种：1. =（或者==）： 判断两个值是否相等；2. !=： 判断两个值是否不相等；注： =和!=可以用作字符串、数值和日期的比较，但两边的数据类型必须相同。而且FreeMarker的比较是精确比较，不会忽略大小写及空格。3. >（或者gt）： 大于4. >=（或者gte）： 大于等于5. <（或者lt）： 小于6. <=（或者lte）： 小于等于注： 上面这些比较运算符可以用于数字和日期，但不能用于字符串。大部分时候，使用gt比>有更好的效果，因为FreeMarker会把>解释成标签的结束字符。可以使用括号来避免这种情况，如：<#if (x>y)>。八、逻辑运算符1. &&： 逻辑与；2. ||： 逻辑或；3. !： 逻辑非逻辑运算符只能用于布尔值。九、内建函数FreeMarker提供了一些内建函数来转换输出，可以在任何变量后紧跟?，?后紧跟内建函数，就可以通过内建函数来转换输出变量。字符串相关常用的内建函数：1. html： 对字符串进行HTML编码；2. cap_first： 使字符串第一个字母大写；3. lower_case： 将字符串转成小写；4. upper_case： 将字符串转成大写；集合相关常用的内建函数：1. size： 获得集合中元素的个数；数字值相关常用的内建函数：1. int： 取得数字的整数部分。十、空值处理运算符FreeMarker的变量必须赋值，否则就会抛出异常。而对于FreeMarker来说，null值和不存在的变量是完全一样的，因为FreeMarker无法理解null值。FreeMarker提供两个运算符来避免空值：1. !： 指定缺失变量的默认值；2. ??：判断变量是否存在。!运算符有两种用法：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