freemarker 基本实践

[size=medium]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 >[/size]