FreeMaker 常见实用指南

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>

 

三、split(“XX”):截取XX之后的字符

 

<#list "someMOOtestMOOtext"?split("MOO") as x>

- ${x}

</#list>

 

输出:

- some

- test

- text

四、定义变量，结合if else

<#assign optype ="${product.optype?if_exists}" > 
   <#if optype=="0" || optype=="">
    <#assign btn_type="结算">
    订购
   <#elseif optype=="4" >
    <#assign btn_type="结算">
    退订
   <#elseif optype=="1" >
    <#assign btn_type="结算">
    暂停
   <#elseif optype=="3" >
    <#assign btn_type="结算">
    恢复
   <#elseif optype=="2" >
    <#assign btn_type="结算">
    属性修改
   </#if> 

五、判断

<#if (productList ? exists) && (productList ? size > 0)>

六、设置模板的数据类型

<#setting number_format="0">

七、数据格式化带来的操作问题

freemarker在解析数据格式的时候，自动默认将数字按3为分割（1，000），这个问题给操作带来一定的额外处理复杂度，解决方法有如下几种：
    1、在模板中直接加.toString()转化数字为字符串，如：${languageList.id.toString()}；
    2、在freemarker配置文件freemarker.properties加<#setting number_format="#">或者      <#setting number_format="0">；
    3、在模板中直接加<#setting number_format="#">或者<#setting number_format="0">，如：<#if AdminLanguagePaginationMsg?exists>
<#setting number_format="#">

    4、加？c，如${a.sid？c}，${aa?c}作用把String转换为数字,因为freemarker默认的会采用科学计数法,比如1,000,000  

八、freemaker整数变小数

将${a.currentPrice/100} 改为#{a.currentPrice/100; m1}，急把前面的转换成小数，Mx最大多少小数位，mx最低小数位。