FreeMarker項目總結

最近在做一個産品，我習慣叫他項目，前端用的是FreeMarker+bootstrap,遇到些問題，做下總結。

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}" target="_blank" rel="external nofollow" >${moive.name}</a>

</#list>

//要是排序，則用

<#list movies?sort as movie>

　　<a href="${movie.url}" target="_blank" rel="external nofollow" target="_blank" rel="external nofollow" target="_blank" rel="external nofollow" >${movie.name}</a>

</#list>

// 這是按元素的首字母排序。若要按list中對象元素的某一屬性排序的話，則用

<#list moives?sort_by(["name"]) as movie>

　　<a href="${movie.url}" target="_blank" rel="external nofollow" target="_blank" rel="external nofollow" target="_blank" rel="external nofollow" >${movie.name}</a>

</#list>

//這個是按list中對象元素的[name]屬性排序的，是升序，如果需要降序的話，如下所示：

<#list movies?sort_by(["name"])?reverse as movie>

　　<a href="${movie.url}" target="_blank" rel="external nofollow" target="_blank" rel="external nofollow" target="_blank" rel="external nofollow" >${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

17、compress 壓縮

// 用來壓縮空白空間和空白的行 

<#compress> 

    ... 

</#compress>

<#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}