首先猬仁，先建議查看此文檔FreeMarker在線手冊

FTL指令常用標(biāo)簽及語法
注意：使用freemaker，要求所有標(biāo)簽必須閉合诈闺，否則會(huì)導(dǎo)致freemaker無法解析雅镊。

freemaker注釋:<#-- 注釋內(nèi)容 -->格式部分,不會(huì)輸出

---------------------------------- 基礎(chǔ)語法 ----------------------------------
1耸弄、字符輸出
${emp.name?if_exists}　　　　　　// 變量存在计呈，輸出該變量捌显，否則不輸出
${emp.name!}　　　　　　　　　　 // 變量存在扶歪，輸出該變量击罪，否則不輸出
${emp.name?default("xxx")} // 變量不存在，取默認(rèn)值xxx
 ${emp.name!"xxx"} 　　　　　　// 變量不存在竣稽，取默認(rèn)值xxx

常用內(nèi)部函數(shù)：
${"123<br>456"?html} 　　// 對字符串進(jìn)行HTML編碼毫别，對html中特殊字符進(jìn)行轉(zhuǎn)義
${"str"?cap_first} 　　 // 使字符串第一個(gè)字母大寫 
${"Str"?lower_case} // 將字符串轉(zhuǎn)換成小寫
 ${"Str"?upper_case} // 將字符串轉(zhuǎn)換成大寫
${"str"?trim} // 去掉字符串前后的空白字符

字符串的兩種拼接方式拼接：
${"hello${emp.name!}"} // 輸出hello+變量名
${"hello"+emp.name!} // 使用+號(hào)來連接岛宦，輸出hello+變量名

可以通過如下語法來截取子串:
<#assign str = "abcdefghijklmn"/>
// 方法1${str?substring(0,4)} // 輸出abcd
// 方法2${str[0]}${str[4]} // 結(jié)果是ae
${str[1..4]} 　　　 // 結(jié)果是bcde// 返回指定字符的索引${str?index_of("n")}

2、日期輸出
${emp.date?string('yyyy-MM-dd')} //日期格式

3变汪、數(shù)字輸出(以數(shù)字20為例)
${emp.name?string.number} 　// 輸出20
${emp.name?string.currency} // ￥20.00 
${emp.name?string.percent} // 20%
${1.222?int} 　　　　　　　　　　 // 將小數(shù)轉(zhuǎn)為int裙盾，輸出1
<#setting number_format="percent"/> // 設(shè)置數(shù)字默認(rèn)輸出方式('percent',百分比)
<#assign answer=42/> 　　　　　　　　 // 聲明變量 answer 42
#{answer} 　　　　　　　　 // 輸出 4,200%
${answer?string} 　　　　 // 輸出 4,200%
${answer?string.number} 　　// 輸出 42
${answer?string.currency} // 輸出 ￥42.00
${answer?string.percent} 　// 輸出 4,200%
#{answer} 　　　　　　　　// 輸出 42

數(shù)字格式化插值可采用#{expr;format}形式來格式化數(shù)字,其中format可以是:
mX:小數(shù)部分最小X位
MX:小數(shù)部分最大X位
如下面的例子:
<#assign x=2.582/><#assign y=4/>#{x; M2} // 輸出2.58
#{y; M2} // 輸出4
#{x; m2} // 輸出2.58
#{y; m2} // 輸出4.0
#{x; m1M2} // 輸出2.58
#{x; m1M2} // 輸出4.0

4庐完、申明變量
<#assign foo=false/> 
// 聲明變量,插入布爾值進(jìn)行顯示,注意不要用引號(hào)${foo?string("yes","no")} 
// 當(dāng)為true時(shí)輸出"yes",否則輸出"no"

申明變量的幾種方式
<#assign name=value>
 <#assign name1=value1 name2=value2 ... nameN=valueN>
 <#assign same as above... in namespacehash>
<#assign name> capture this </#assign>
<#assign name in namespacehash> capture this </#assign>

5门躯、比較運(yùn)算符
表達(dá)式中支持的比較運(yùn)算符有如下幾個(gè):= 或 == ：判斷兩個(gè)值是否相等.
!= ：判斷兩個(gè)值是否不等.
> 或 gt ：判斷左邊值是否大于右邊值
>= 或 gte ：判斷左邊值是否大于等于右邊值
< 或 lt ：判斷左邊值是否小于右邊值
<= 或 lte ：判斷左邊值是否小于等于右邊值
6宁否、算術(shù)運(yùn)算符
FreeMarker表達(dá)式中完全支持算術(shù)運(yùn)算,FreeMarker支持的算術(shù)運(yùn)算符包括:+, - , * , / , % 注意：
（1）慕匠、運(yùn)算符兩邊必須是數(shù)字
（2）台谊、使用+運(yùn)算符時(shí),如果一邊是數(shù)字,一邊是字符串,就會(huì)自動(dòng)將數(shù)字轉(zhuǎn)換為字符串再連接,如:${3 + "5"},結(jié)果是:35
7酪呻、邏輯運(yùn)算符
邏輯運(yùn)算符有如下幾個(gè):邏輯與:&&邏輯或:||邏輯非:!邏輯運(yùn)算符只能作用于布爾值,否則將產(chǎn)生錯(cuò)誤
8玩荠、FreeMarker中的運(yùn)算符優(yōu)先級(jí)如下(由高到低排列):
①阶冈、一元運(yùn)算符:!
②、內(nèi)建函數(shù):?
③匆骗、乘除法:*, / , %
④绰筛、加減法:- , +
⑤、比較:> , < , >= , <= (lt , lte , gt , gte)
⑥毛甲、相等:== , = , !=
⑦玻募、邏輯與:&&
⑧、邏輯或:||
⑨艾栋、數(shù)字范圍:..實(shí)際上,我們在開發(fā)過程中應(yīng)該使用括號(hào)來嚴(yán)格區(qū)分,這樣的可讀性好,出錯(cuò)少
9蝗砾、if 邏輯判斷（注意：elseif 不加空格）
<#if condition>
...
<#elseif condition2>
...
<#elseif condition3>
...
<#else>
...
</#if>

if 空值判斷
// 當(dāng) photoList 不為空時(shí)<#if photoList??>...</#if> 
值得注意的是,${..}只能用于文本部分,不能用于表達(dá)式,
下面的代碼是錯(cuò)誤的:
<#if ${isBig}>Wow!</#if><#if "${isBig}">Wow!</#if>
// 正確寫法<#if isBig>Wow!</#if>

10曾棕、switch (條件可為數(shù)字申尤，可為字符串)
<#switch value>
 <#case refValue1>
 ....
<#break> 
<#case refValue2> 
....
<#break>
 <#case refValueN>
 ....
<#break>
 <#default>
 ....
 </#switch>
11瀑凝、集合 & 循環(huán)
// 遍歷集合:
<#list empList! as emp> 
    ${emp.name!}
</#list>
// 可以這樣遍歷集合:
<#list 0..(empList!?size-1) as i>
    ${empList[i].name!}
</#list>

// 與jstl循環(huán)類似,也可以訪問循環(huán)的狀態(tài)。

empList?size 　　　// 取集合的長度
emp_index: 　　　　// int類型寥枝，當(dāng)前對象的索引值 
emp_has_next:     // boolean類型比搭，是否存在下一個(gè)對象
// 使用<#break>跳出循環(huán)
<#if emp_index = 0><#break></#if>

// 集合長度判斷 
<#if empList?size != 0></#if> // 判斷=的時(shí)候,注意只要一個(gè)=符號(hào),而不是==

<#assign l=0..100/>    // 定義一個(gè)int區(qū)間的0~100的集合蜜托，數(shù)字范圍也支持反遞增,如100..2
<#list 0..100 as i> 　　// 等效于java for(int i=0; i <= 100; i++)
　　${i}
</#list>

// 截取子集合：
empList[3..5] //返回empList集合的子集合,子集合中的元素是empList集合中的第4-6個(gè)元素

// 創(chuàng)建集合：
<#list ["星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期天"] as x>

// 集合連接運(yùn)算,將兩個(gè)集合連接成一個(gè)新的集合
<#list ["星期一","星期二","星期三"] + ["星期四","星期五","星期六","星期天"] as x>

// 除此之外,集合元素也可以是表達(dá)式,例子如下:
[2 + 2, [1, 2, 3, 4], "whatnot"]
/ seq_contains：判斷序列中的元素是否存在
<#assign x = ["red", 16, "blue", "cyan"]> 
${x?seq_contains("blue")?string("yes", "no")}    // yes
${x?seq_contains("yellow")?string("yes", "no")}  // no
${x?seq_contains(16)?string("yes", "no")}        // yes
${x?seq_contains("16")?string("yes", "no")}      // no

// seq_index_of：第一次出現(xiàn)的索引
<#assign x = ["red", 16, "blue", "cyan", "blue"]> 
${x?seq_index_of("blue")}  // 2

// sort_by：排序（升序）
<#list movies?sort_by("showtime") as movie></#list>

// sort_by：排序（降序）
<#list movies?sort_by("showtime")?reverse as movie></#list>

// 具體介紹：
// 不排序的情況：
<#list movies as moive>
　　<a href="${moive.url}">${moive.name}</a>
</#list>
//要是排序，則用
<#list movies?sort as movie>
　　<a href="${movie.url}">${movie.name}</a>
</#list>

// 這是按元素的首字母排序。若要按list中對象元素的某一屬性排序的話，則用
<#list moives?sort_by(["name"]) as movie>
　　<a href="${movie.url}">${movie.name}</a>
</#list>

//這個(gè)是按list中對象元素的[name]屬性排序的玻粪，是升序伦仍，如果需要降序的話，如下所示：
<#list movies?sort_by(["name"])?reverse as movie>
　　<a href="${movie.url}">${movie.name}</a>
</#list>
12、Map對象
// 創(chuàng)建map
<#assign scores = {"語文":86,"數(shù)學(xué)":78}>

// Map連接運(yùn)算符
<#assign scores = {"語文":86,"數(shù)學(xué)":78} + {"數(shù)學(xué)":87,"Java":93}>

// Map元素輸出
emp.name       // 全部使用點(diǎn)語法
emp["name"]    // 使用方括號(hào)

13、FreeMarker支持如下轉(zhuǎn)義字符:
\" ：雙引號(hào)(u0022)
\' ：單引號(hào)(u0027)
\\ ：反斜杠(u005C)
\n ：換行(u000A)
\r ：回車(u000D)
\t ：Tab(u0009)
\b ：退格鍵(u0008)
\f ：Form feed(u000C)
\l ：<
\g ：>
\a ：&
\{ ：{
\xCode ：直接通過4位的16進(jìn)制數(shù)來指定Unicode碼,輸出該unicode碼對應(yīng)的字符.

如果某段文本中包含大量的特殊符號(hào),FreeMarker提供了另一種特殊格式:
可以在指定字符串內(nèi)容的引號(hào)前增加r標(biāo)記,在r標(biāo)記后的文件將會(huì)直接輸出.看如下代碼:
${r"${foo}"}    // 輸出 ${foo}
${r"C:/foo/bar"}    // 輸出 C:/foo/bar
14、include指令
// include指令的作用類似于JSP的包含指令:
<#include "/test.ftl" encoding="UTF-8" parse=true>

// 在上面的語法格式中,兩個(gè)參數(shù)的解釋如下:
encoding="GBK"  // 編碼格式
parse=true 　　 // 是否作為ftl語法解析,默認(rèn)是true陨帆，false就是以文本方式引入,
注意:在ftl文件里布爾值都是直接賦值的如parse=true,而不是parse="true"

15岸浑、import指令
// 類似于jsp里的import,它導(dǎo)入文件，然后就可以在當(dāng)前文件里使用被導(dǎo)入文件里的宏組件
<#import "/libs/mylib.ftl" as my>
// 上面的代碼將導(dǎo)入/lib/common.ftl模板文件中的所有變量,
交將這些變量放置在一個(gè)名為com的Map對象中瑰步，
"my"在freemarker里被稱作namespace

16矢洲、compress 壓縮
// 用來壓縮空白空間和空白的行 
<#compress> 
    ... 
</#compress>
<#t> // 去掉左右空白和回車換行 

<#lt>// 去掉左邊空白和回車換行 

<#rt>// 去掉右邊空白和回車換行 

<#nt>// 取消上面的效果
17、escape,noescape 對字符串進(jìn)行HTML編碼
// escape指令導(dǎo)致body區(qū)的插值都會(huì)被自動(dòng)加上escape表達(dá)式,
但不會(huì)影響字符串內(nèi)的插值,只會(huì)影響到body內(nèi)出現(xiàn)的插值,
使用escape指令的語法格式如下:
<#escape x as x?html> 
　　First name: ${firstName} 
<#noescape>Last name: ${lastName}</#noescape> 
　　Maiden name: ${maidenName} 
</#escape>

// 相同表達(dá)式
First name: ${firstName?html} 
Last name: ${lastName} 
Maiden name: ${maidenName?html}

---------------------------------- 高級(jí)語法 ----------------------------------
1缩焦、global全局賦值語法
<#global name=value> 

<#global name1=value1 name2=value2 ... nameN=valueN> 

<#global name> 
　　capture this 
</#global>
// 利用這個(gè)語法給變量賦值读虏，那么這個(gè)變量在所有的namespace中是可見的，
如果這個(gè)變量被當(dāng)前的assign語法覆蓋如<#global x=2><#assign x=1>在當(dāng)前頁面里x=2將被隱藏袁滥，
或者通過${.globals.x} 來訪問
2盖桥、setting 語法
// 用來設(shè)置整個(gè)系統(tǒng)的一個(gè)環(huán)境 
locale // zh_CN 中文環(huán)境
number_format 
boolean_format 
date_format , time_format , datetime_format 
time_zone 
classic_compatible
// 例1：
<#setting number_format="percent"/>    // 設(shè)置數(shù)字默認(rèn)輸出方式('percent',百分比)

// 例2：
// 假如當(dāng)前是匈牙利的設(shè)置，然后修改成美國
${1.2} // 輸出1,2
<#setting locale="en_US"> 
${1.2} // 輸出1.2,因?yàn)樾傺览遣捎?, "作為十進(jìn)制的分隔符题翻，美國是用". "
3揩徊、macro宏指令
例子1：

<#-- 定義宏 -->
<#macro test foo bar="Bar" baaz=-1> 
　　Text: ${foo}, ${bar}, ${baaz}
</#macro>

<#-- 使用宏 -->
<@test foo="a" bar="b" baaz=5*5/>  // 輸出：Text: a, b, 25
<@test foo="a" bar="b"/>    　　　　// 輸出：Text: a, b, -1
<@test foo="a" baaz=5*5-2/> 　　　　// 輸出：Text: a, Bar, 23
<@test foo="a"/>                   // 輸出：Text: a, Bar, -1
例子2：

<#-- 定義一個(gè)循環(huán)輸出的宏 -->
<#macro list title items> 
　　${title}
　　<#list items as x>
　　　　*${x}
　　</#list> 
</#macro> 

<#-- 使用宏 -->
<@list items=["mouse", "elephant", "python"] title="Animals"/>
// 輸出Animals *mouse *elephant *python
例子3：

<#-- 嵌套宏 -->
<#macro border>
　　<table>
　　　　<#nested>
　　</table>
</#macro>

<#-- 嵌套宏使用 -->
<@border>
　　<tr><td>hahaha</td></tr>
</@border> 
輸出結(jié)果：
<table>
　　<tr><td>hahaha</td></tr>
</table>
 例子4：在nested指令中使用循環(huán)變量時(shí),可以使用多個(gè)循環(huán)變量,看如下代碼:
<#-- 循環(huán)嵌套宏 --><#macro repeat count>　　
<#list 1..count as x>
<#nested x, x/2, x==count>
 // 使用nested指令時(shí)指定了三個(gè)循環(huán)變量　　
</#list></#macro><#-- 使用宏 -->
<@repeat count = 4; c, halfc, last>　　
${c}. ${halfc}<#if last> Last!</#if></@repeat>
// 輸出結(jié)果：// 1. 0.5// 2. 1// 3. 1.5// 4. 2 Last!

freemarker 宏嵌套nested 的使用:http://blog.sina.com.cn/s/blog_7e5699790100z59g.html

4、結(jié)束macro指令
// return指令用于結(jié)束macro指令
<#-- 創(chuàng)建宏 -->
<#macro book>
　　spring
　　<#return>
　　j2ee
</#macro>

<#-- 使用宏 -->
<@book />
// 上面的代碼輸出:spring,而j2ee位于return指令之后,不會(huì)輸出.

-自定義函數(shù)等高級(jí)應(yīng)用請看下節(jié)