引用自：https://blog.csdn.net/asa_prince/article/details/82017976
注意：使用freemaker，要求所有標簽必須閉合，否則會導致freemaker無法解析。
freemaker注釋:<#-- 注釋內容 -->格式部分,不會輸出。
1、字符輸出
${emp.name?if_exists} // 變量存在，輸出該變量，否則不輸出
${emp.name!} // 變量存在，輸出該變量，否則不輸出
${emp.name?default("xxx")} // 變量不存在，取默認值xxx
${emp.name!"xxx"} // 變量不存在，取默認值xxx
常用內部函數：
${"123<br>456"?html} // 對字符串進行HTML編碼，對html中特殊字符進行轉義
${"str"?cap_first} // 使字符串第一個字母大寫
${"Str"?lower_case} // 將字符串轉換成小寫
${"Str"?upper_case} // 將字符串轉換成大寫
${"str"?trim} // 去掉字符串前后的空白字符
字符串的兩種拼接方式拼接：
${"hello${emp.name!}"} // 輸出hello+變量名
${"hello"+emp.name!} // 使用+號來連接，輸出hello+變量名
可以通過如下語法來截取子串:
<#assign str = "abcdefghijklmn"/>
// 方法1
${str?substring(0,4)} // 輸出abcd
// 方法2
${str[0]}${str[4]} // 結果是ae
${str[1..4]} // 結果是bcde
// 返回指定字符的索引
${str?index_of("n")}
2、日期輸出
${emp.date?string('yyyy-MM-dd')} //日期格式
3、數字輸出(以數字20為例)
${emp.name?string.number} // 輸出20
${emp.name?string.currency} // ￥20.00
${emp.name?string.percent} // 20%
${1.222?int} // 將小數轉為int，輸出1
<#setting number_format="percent"/> // 設置數字默認輸出方式('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
數字格式化插值可采用#{expr;format}形式來格式化數字,其中format可以是:
mX:小數部分最小X位
MX:小數部分最大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/> // 聲明變量,插入布爾值進行顯示,注意不要用引號
${foo?string("yes","no")} // 當為true時輸出"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、比較運算符
表達式中支持的比較運算符有如下幾個:
= 或 == ：判斷兩個值是否相等.
!= ：判斷兩個值是否不等.
或 gt ：判斷左邊值是否大於右邊值
= 或 gte ：判斷左邊值是否大於等於右邊值
< 或 lt ：判斷左邊值是否小於右邊值
<= 或 lte ：判斷左邊值是否小於等於右邊值
6、算術運算符
FreeMarker表達式中完全支持算術運算,
FreeMarker支持的算術運算符包括:+, - , * , / , %
注意：
（1）、運算符兩邊必須是數字
（2）、使用+運算符時,如果一邊是數字,一邊是字符串,就會自動將數字轉換為字符串再連接,如:${3 + "5"},結果是:35
7、邏輯運算符
邏輯運算符有如下幾個:
邏輯與:&&
邏輯或:||
邏輯非:!
邏輯運算符只能作用於布爾值,否則將產生錯誤
8、FreeMarker中的運算符優先級如下(由高到低排列):
①、一元運算符:!
②、內建函數:?
③、乘除法:*, / , %
④、加減法:- , +
⑤、比較:> , < , >= , <= (lt , lte , gt , gte)
⑥、相等:== , = , !=
⑦、邏輯與:&&
⑧、邏輯或:||
⑨、數字范圍:..
實際上,我們在開發過程中應該使用括號來嚴格區分,這樣的可讀性好,出錯少
9、if 邏輯判斷（注意：elseif 不加空格）
<#if condition>
...
<#elseif condition2>
...
<#elseif condition3>
...
<#else>
...
</#if>
if 空值判斷
<!-- 當 photoList 不為空時-->
<#if photoList??>...</#if>
<!--值得注意的是,${..}只能用於文本部分,不能用於表達式,下面的代碼是錯誤的:-->
<#if ${isBig}>Wow!</#if>
<#if "${isBig}">Wow!</#if>
<!-- 正確寫法-->
<#if isBig>Wow!</#if>
10、switch (條件可為數字，可為字符串)
<#switch value>
<#case refValue1>
....
<#break>
<#case refValue2>
....
<#break>
<#case refValueN>
....
<#break>
<#default>
....
</#switch>
11、集合 & 循環
<!-- 遍歷集合: -->
<#list empList! as emp>
${emp.name!}
</#list>
<!-- 可以這樣遍歷集合: -->
<#list 0..(empList!?size-1) as i>
${empList[i].name!}
</#list>
<!-- 與jstl循環類似,也可以訪問循環的狀態。 -->
empList?size // 取集合的長度
emp_index: // int類型，當前對象的索引值
emp_has_next: // boolean類型，是否存在下一個對象
<!-- 使用<#break>跳出循環 -->
<#if emp_index = 0><#break></#if>
<!-- 集合長度判斷 -->
<#if empList?size != 0></#if> <!-- 判斷=的時候,注意只要一個=符號,而不是== -->
<#assign l=0..100/> <!-- 定義一個int區間的0~100的集合，數字范圍也支持反遞增,如100..2 -->
<#list 0..100 as i> <!-- 等效於java for(int i=0; i <= 100; i++) -->
${i}
</#list>
<!-- 截取子集合： -->
empList[3..5] <!-- 返回empList集合的子集合,子集合中的元素是empList集合中的第4-6個元素 -->
<!-- 創建集合： -->
<#list ["星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期天"] as x>
<!-- 集合連接運算,將兩個集合連接成一個新的集合 -->
<#list ["星期一","星期二","星期三"] + ["星期四","星期五","星期六","星期天"] as x>
<!-- 除此之外,集合元素也可以是表達式,例子如下: -->
[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：第一次出現的索引 -->
<#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>
<!-- 這個是按list中對象元素的[name]屬性排序的，是升序，如果需要降序的話，如下所示： -->
<#list movies?sort_by(["name"])?reverse as movie>
<a href="${movie.url}">${movie.name}</a>
</#list>
12、Map對象
<!-- 創建map -->
<#assign scores = {"語文":86,"數學":78}>
<!-- Map連接運算符 -->
<#assign scores = {"語文":86,"數學":78} + {"數學":87,"Java":93}>
<!-- Map元素輸出 -->
emp.name // 全部使用點語法
emp["name"] // 使用方括號
13、FreeMarker支持如下轉義字符:
\" ：雙引號(u0022)
\' ：單引號(u0027)
\ ：反斜杠(u005C)
\n ：換行(u000A)
\r ：回車(u000D)
\t ：Tab(u0009)
\b ：退格鍵(u0008)
\f ：Form feed(u000C)
\l ：< \g ：>
\a ：&
{ ：{
\xCode ：直接通過4位的16進制數來指定Unicode碼,輸出該unicode碼對應的字符.
如果某段文本中包含大量的特殊符號,FreeMarker提供了另一種特殊格式:可以在指定字符串內容的引號前增加r標記,在r標記后的文件將會直接輸出.看如下代碼:
${r"${foo}"} // 輸出 ${foo}
${r"C:/foo/bar"} // 輸出 C:/foo/bar
14、include指令
// include指令的作用類似於JSP的包含指令:
<#include "/test.ftl" encoding="UTF-8" parse=true>
// 在上面的語法格式中,兩個參數的解釋如下:
encoding="GBK" // 編碼格式
parse=true // 是否作為ftl語法解析,默認是true，false就是以文本方式引入,注意:在ftl文件里布爾值都是直接賦值的如parse=true,而不是parse="true"
15、import指令
// 類似於jsp里的import,它導入文件，然后就可以在當前文件里使用被導入文件里的宏組件
<#import "/libs/mylib.ftl" as my>
// 上面的代碼將導入/lib/common.ftl模板文件中的所有變量,交將這些變量放置在一個名為com的Map對象中，"my"在freemarker里被稱作namespace
16、compress 壓縮
// 用來壓縮空白空間和空白的行
<#compress>
...
</#compress>
17、特殊標簽
<#t> // 去掉左右空白和回車換行
<#lt>// 去掉左邊空白和回車換行
<#rt>// 去掉右邊空白和回車換行
<#nt>// 取消上面的效果
18、escape,noescape 對字符串進行HTML編碼
// escape指令導致body區的插值都會被自動加上escape表達式,但不會影響字符串內的插值,只會影響到body內出現的插值,使用escape指令的語法格式如下:
<#escape x as x?html>
First name: ${firstName}
<#noescape>Last name: ${lastName}</#noescape>
Maiden name: ${maidenName}
</#escape>
// 相同表達式
First name: ${firstName?html}
Last name: ${lastName}
Maiden name: ${maidenName?html}
分享支援 造福人間!