Freemarker 初学

原文地址：http://dongwei.iteye.com/blog/231322

第一招：迭代Map
假设你有一个Map，像这样：
Xml代码
{"name":"mouse", "price":50 , "weight":30}

如何来迭代输出？
Html代码
<#-- 这里模拟了一个Map集合，定义了三对键值 -->
<#assign h = {"name":"mouse", "price":50, "weight":30}>

<#-- h?keys 将Map的key取出赋值，实质是调用了一个包装类的方法，
从这里我们也可以学到如何去调用一个类的方法 -->
<#assign keys = h?keys>

<#-- 关键点：${h[key]} 通过这样的方式，访问到了Map中的value属性 -->
<#list keys as key>${key} = ${h[key]}; </#list>

输出结果：
Html代码
name = mouse; price = 50; weight = 30;

第二招：如何判定字符串相等
这个有点小题大作，呵呵，其实很简单
Html代码
<#-- 定义了一种动物——狗 -->
<#assign annimal = "Dog">

<#-- 做一下条件判断，如果是狗就输出"Wang! Wang!"
注意:这里使用一个"="-->
<#if annimal = "Dog">
Wang! Wang!
<#else>
Ga! Ga!
</#if>

输出结果：
Html代码
Wang! Wang!

第三招：处理空值
先要说明的是，在freemarker中，如果你试图去访问一个不存在的值(null)，或者该值在访问时还没有被初始化，
那么它会毫不犹豫的抛给一个错误，并且立即终止模板的执行过程。为什么这么变态？

如何对付这样的情况？
答案：在它访问这个值失败的时候，给它一个默认的值！嘻嘻……

怎么赋默认值？
用这样的语法：
unsafe_expr!default_expr 或 unsafe_expr! 或 (unsafe_expr)!default_expr 或 (unsafe_expr)!

例子：
Html代码
<#-- 想要输出mouse,但是它没有被赋值，所以指定默认值为"No mouse"
当然"!"后面的这个值可以是一个表达式-->
${mouse!"No mouse."}

<#-- 给mouse赋值 "Jerry" -->
<#assign mouse="Jerry">

<#-- 再次访问mouse -->
${mouse!"No mouse."}

输出结果：
Html代码
No mouse.
Jerry

另外对于"!"后面没有写任何值的情况，那么它的值可能是空String、空sequence 、空hash。
但是如果你想默认值是0或者false，那么你最好还是显式的指定，因为它不会对你那么友好的(Bad luck!)
还需要注意的是：
Html代码
1. product.color!"red"
2. (product.color)!"red"

这两种写法所表示的含义是不一样的：
第一种写法只处理color为空的情况，对于product为空则束手无策。
第二种写法则可以同时处理product及color同时(或任意)为空的情况。

插播，如何判断空值？
[color=red][b]语法：unsafe_expr?? 或 (unsafe_expr)?? 返回值为true和false[/b][/color]

第四招：几个常用的函数
使用函数的方式就像这样:user?upper_case 简单吧？
字符串函数:
html：将会把一些特殊的html字符替换掉(比如：把 "<" 替换为"<")
cap_first：首字母大写
lower_case：转化为小写
upper_case：转化为大写
trim：去掉首尾的空白，包括空格、Tab、回车、换行

例子：
Html代码
<#-- 定义test值为"Tom & Jerry" -->
<#assign test = "Tom & Jerry">
${test?html}
${test?upper_case?html}

输出为:
Tom & Jerry
TOM & JERRY

序列(也就是常说的List或Set等集合)函数:
size：显示该序列的大小

数学函数:
int：取整(例如： -1.9?int 返回值是 -1)