freemarker 基本实践

1.freemarker在struts2里面的整合

<actionname="Action1"  class="com.abc.Action1">
    <result type="freemarker">/fm.ftl</result>
</action>

这里没有涉及到struts2的标签的使用，如果需要使用struts2的标签可能需要额外的配置，本人对使用标签持反对意见.

2.基本的输出

基本输出: ${student.name}        (student的定义在本文末尾)
 
空值判断：${student.name?if_exists}
 
默认值：  ${student.name?default(‘xxx’)}或者${ book.name!"xxx"}
 
日期格式：${student.birthday?string('yyyy-MM-dd')}
 
数字格式：${student.age?string.number}--->20
        ${student.age?string.currency}---><#-- $20.00 -->
        ${student.age?string.percent}—--><#-- 20% -->
 
传递url的参数: <a href='search.htm?name=${student.name?url}'>查询</a>  对于中文参数，freemarker会自动给我们编码
 
boolean值：<#assign flag=ture />
          ${flag?string("yes","no")} <#-- yes -->
 
每次输出的时候最好是带个默认值，否则没有被赋值的变量就会抛出异常，那个黄黄的freemarker出错页面，真是让人看了太难过了

3 逻辑判断

a：if else 形式

<#if condition>
.
<#elseif condition2>

<#elseif condition3>
.
<#else>

<#if

b：switch 形式

<#switch value>
<#case refValue1>
     
     <#break>
<#case refValue2>
     
     <#break>

<#case refValueN>
     
     <#break>
<#default>
     
</#switch>

4 循环

遍历普通list：
<#list someList as item>
 
</#list>
 
 
遍历list的前面几项：
<#assign x=3>
<#list 1..x as i>
  ${i}
</#list>
 
 
遍历map：
<#list nameMap.keySet() as name>
   ${nameMap.get(name)}
</#list>
  或者
<#list nameMap?keys as name>     
   ${nameMap.get(name)}                                     
</#list>
 
 
list排序输出：
<#list someList?sort_by(["name"]) as item>
     ${item.name}
</#list>
 按照属性name进行排序（默认升序）
 
<#list somelist?sort_by(["name"])?reverse as item>
     ${item.name}
</#list>
 按照属性name进行降序排序
 
 
 
list指令还隐含了两个循环变量：item_index:当前迭代项在所有迭代项中的位置，是数字值。
item_has_next:用于判断当前迭代项是否是所有迭代项中的最后一项。
 
map 关于map的key，它必须是String，这个在一定程度上限制了后台程序对于map的表达。

5 其他指令

freemarker  大于  小于 大于等于  小于等于比较符
 
大于 gt
小于 lt
大于等于 gte
小于等于 lte
 
使用方法很简单
<#if x gt 1>
..
</#if>
 
 
struts2环境中freemarker读取后台程序的静态变量和静态方法
 
${stack.findValue("@package.ClassName@method")}
${stack.findValue("@package.ClassName@property")}

6 宏

1 基本用法
宏是和某个变量关联的模板片断，以便在模板中通过用户定义指令使用该变量，下面是一个例子：
<#macro greet>
  <font size="+2">Hello Joe!</font>
</#macro>
调用宏时，与使用freemarker的其他指令类似，只是使用@替代FTL标记中的#:
<@greet/>
 
 
2 在macro指令中可以在宏变量之后定义参数，如：
<#macro greet person>
  <font size="+2">Hello ${person}!</font>
</#macro>
可以这样使用这个宏变量： <@greet person="Fred"/>
但是下面的代码具有不同的意思： <@greet person=Fred/>
 
这意味着将Fred变量的值传给person参数，该值不仅是字符串，还可以是其它类型，甚至是复杂的表达式。
 
 
宏可以有多参数，下面是一个例子：
<#macro greet person color>
  <font size="+2" color="${color}">Hello ${person}!</font>
</#macro>
可以这样使用该宏变量，其中参数的次序是无关的:<@greet person="Fred" color="black"/>
 
 
 
可以在定义参数时指定缺省值，否则，在调用宏的时候，必须对所有参数赋值：
 <#macro greet person color="black">
    <font size="+2" color="${color}">Hello ${person}!</font>
 </#macro>
注意：宏的参数是局部变量，只能在宏定义中有效。
 
 
3 在宏里嵌套内容
<#nested>指令会执行宏调用指令开始和结束标记之间的模板片断，举一个简单的例子：
<#macro border>
 <table>
   <tr><td>
      <#nested>
   </tr></td>
 </table>
</#macro>
执行宏调用：<@border>The bordered text</@border >

转自:http://www.blogjava.net/nod0620/articles/325561.html