FreeMarker使用

前言

FreeMarker的模板文件并不比HTML頁面復雜多少,FreeMarker模板文件主要由如下4個部分組成:

文本:直接輸出的部分
注釋:<#-- ... -->格式部分,不會輸出
插值:即${...}或#{...}格式的部分,將使用數據模型中的部分替代輸出
FTL指令:FreeMarker指定,和HTML標記類似,名字前加#予以區分,不會輸出

下面是一個FreeMarker模板的例子,包含了以上所說的4個部分:

<html>
    <head>
        <title>Welcome!</title>
    </head>
    <body>
        <#-- 注釋部分 -->
        <#-- 下面使用插值 -->
        <h1>Welcome ${user} !</h1>
        <p>We have these animals:</p>
        <u1>
            <#-- 使用FTL指令 -->
            <#list animals as being>
            <li>${being.name} for ${being.price} Euros</li>
            <#list>
        <u1>
    </body>
</html>

1. FTL指令規則

在FreeMarker中,使用FTL標簽來使用指令,FreeMarker有3種FTL標簽,這和HTML標簽是完全類似的.

開始標簽:<#directivename parameter>
結束標簽:</#directivename>
空標簽:<#directivename parameter/>

實際上,使用標簽時前面的符號#也可能變成@,如果該指令是一個用戶指令而不是系統內建指令時,應將#符號改成@符號.

使用FTL標簽時,應該有正確的嵌套,而不是交叉使用,這和XML標簽的用法完全一樣.如果全用不存在的指令,FreeMarker不會使用模板輸出,而是產生一個錯誤消息.FreeMarker會忽略FTL標簽中的空白字符.值得注意的是< , /> 和指令之間不允許有空白字符.

2. 插值規則

FreeMarker的插值有如下兩種類型:

通用插值${expr};
數字格式化插值:#{expr}或#{expr;format}

2.1 通用插值

對于通用插值,又可以分為以下4種情況:

插值結果為字符串值:直接輸出表達式結果
插值結果為數字值:根據默認格式(由#setting指令設置)將表達式結果轉換成文本輸出.可以使用內建的字符串函數格式化單個插值,如下面的例子:

<#settion number_format="currency"/>
<#assign answer=42/>
${answer}
${answer?string} <#-- the same as ${answer} -->
${answer?string.number}
${answer?string.currency}
${answer?string.percent}
${answer}

輸出結果是:

$42.00
$42.00
42
$42.00
4,200%

插值結果為日期值:根據默認格式(由#setting指令設置)將表達式結果轉換成文本輸出.可以使用內建的字符串函數格式化單個插值,如下面的例子:

${lastUpdated?string("yyyy-MM-dd HH:mm:ss zzzz")}
${lastUpdated?string("EEE, MMM d, ''yy")}
${lastUpdated?string("EEEE, MMMM dd, yyyy, hh:mm:ss a '('zzz')'")}

輸出結果是:

2008-04-08 08:08:08 Pacific Daylight Time
Tue, Apr 8, '03
Tuesday, April 08, 2003, 08:08:08 PM (PDT)

插值結果為布爾值:根據默認格式(由#setting指令設置)將表達式結果轉換成文本輸出.可以使用內建的字符串函數格式化單個插值,如下面的例子:

<#assign foo=true/>
${foo?string("yes", "no")}

輸出結果是:

yes

2.2 數字格式化插值

數字格式化插值可采用#{expr;format}形式來格式化數字,其中format可以是:

mX:小數部分最小X位
MX:小數部分最大X位

如下面的例子:

<#assign x=2.582/>
<#assign y=4/>
#{x; M2} <#-- 輸出2.58 -->
#{y; M2} <#-- 輸出4 -->
#{x; m2} <#-- 輸出2.6 -->
#{y; m2} <#-- 輸出4.0 -->
#{x; m1M2} <#-- 輸出2.58 -->
#{x; m1M2} <#-- 輸出4.0 -->

3. 表達式

表達式是FreeMarker模板的核心功能,表達式放置在插值語法${}之中時,表明需要輸出表達式的值;表達式語法也可與FreeMarker標簽結合,用于控制輸出.實際上FreeMarker的表達式功能非常強大,它不僅支持直接指定值,輸出變量值,也支持字符串格式化輸出和集合訪問等功能.

3.1 直接指定值

使用直接指定值語法讓FreeMarker直接輸出插值中的值,而不是輸出變量值.直接指定值可以是字符串,數值,布爾值,集合和MAP對象.

字符串

直接指定字符串值使用單引號或雙引號限定,如果字符串值中包含特殊字符需要轉義,看下面的例子:

${"我的文件保存在C:\\盤"}
${'我名字是\"annlee\"'}

輸出結果是:

我的文件保存在C:\盤
我名字是"annlee"

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}"}
${r"C:\foo\bar"}

輸出結果是:

${foo}
C:\foo\bar

數值

表達式中的數值直接輸出,不需要引號.小數點使用"."分隔,不能使用分組","符號.FreeMarker目前還不支持科學計數法,所以"1E3"是錯誤的.在FreeMarker表達式中使用數值需要注意以下幾點:

數值不能省略小數點前面的0,所以".5"是錯誤的寫法
數值8 , +8 , 8.00都是相同的
布爾值,直接使用true和false,不使用引號.
集合, 集合以方括號包括,各集合元素之間以英文逗號","分隔

如下為集合元素遍歷的例子:
```
<#list ["星期一", "星期二", "星期三", "星期四", "星期五",     "星期六", "星期天"] as x>
    ${x}
</#list>
```
輸出結果是:
```
星期一
星期二
星期三
星期四
星期五
星期六
星期天
```
除此之外,集合元素也可以是表達式,例子如下:
```
[2 + 2, [1, 2, 3, 4], "whatnot"]
```
還可以使用數字范圍定義數字集合,如2..5等同于[2, 3, 4, 5], 但是更有效率。

注意,使用數字范圍來定義集合時無需使用方括號,數字范圍也支持反遞增的數字范圍,如5..2
Map對象,Map對象使用花括號包括,Map中的key-value對之間以英文冒號":"分隔，多組key-value對之間以英文逗號","分隔。

下面是一個例子:
```
{"語文":78, "數學":80}
```
Map對象的key和value都是表達式,但是key必須是字符串。

3.2 輸出變量值

FreeMarker的表達式輸出變量時,這些變量可以是頂層變量,也可以是Map對象中的變量,還可以是集合中的變量,并可以使用點(.)語法來訪問Java對象的屬性。下面分別討論這些情況：

1. 頂層變量

所謂頂層變量就是直接放在數據模型中的值,例如有如下數據模型:

Map root = new HashMap();   //創建數據模型
root.put("name","annlee");   //name是一個頂層變量

對于頂層變量,直接使用${variableName}來輸出變量值,變量名只能是字母,數字,下劃線,$,@和#的組合,且不能以數字開頭號.為了輸出上面的name的值,可以使用如下語法:

${name}

2. 輸出集合元素

如果需要輸出集合元素,則可以根據集合元素的索引來輸出集合元素,集合元素的索引以方括號指定。

假設有索引:["星期一","星期二","星期三","星期四","星期五","星期六","星期天"]，該索引名為week,如果需要輸出星期三,則可以使用如下語法:

${week[2]} //輸出第三個集合元素

此外,FreeMarker還支持返回集合的子集合,如果需要返回集合的子集合,則可以使用如下語法:

week[3..5] //返回week集合的子集合,子集合中的元素是week集合中的第4-6個元素

3. 輸出Map元素

這里的Map對象可以是直接HashMap的實例,甚至包括JavaBean實例,對于JavaBean實例而言,我們一樣可以把其當成屬性為key,屬性值為value的Map實例.為了輸出Map元素的值,可以使用點語法或方括號語法.假如有下面的數據模型:

Map root = new HashMap();
Book book = new Book();
Author author = new Author();
author.setName("annlee");
author.setAddress("gz");
book.setName("struts2");
book.setAuthor(author);
root.put("info","struts");
root.put("book", book);

為了訪問數據模型中名為struts2的書的作者的名字,可以使用如下語法:

book.author.name //全部使用點語法

book["author"].name

book.author["name"] //混合使用點語法和方括號語法

book["author"]["name"] //全部使用方括號語法

使用點語法時,變量名字有頂層變量一樣的限制,但方括號語法沒有該限制,因為名字可以是任意表達式的結果.

3.3 字符串操作

FreeMarker的表達式對字符串操作非常靈活,可以將字符串常量和變量連接起來,也可以返回字符串的子串等。

字符串連接有兩種語法:

使用${..}或#{..}在字符串常量部分插入表達式的值,從而完成字符串連接.
直接使用連接運算符+來連接字符串

例如有如下數據模型:

Map root = new HashMap(); 
root.put("user","annlee");

下面將user變量和常量連接起來:

${"hello, ${user}!"}   //使用第一種語法來連接
${"hello, " + user + "!"} //使用+號來連接

上面的輸出字符串都是hello,annlee!,可以看出這兩種語法的效果完全一樣.
值得注意的是,${..}只能用于文本部分,不能用于表達式,下面的代碼是錯誤的:

<#if ${isBig}>Wow!</#if>
<#if "${isBig}">Wow!</#if>

應該寫成:

<#if isBig>Wow!</#if>

截取子串可以根據字符串的索引來進行,截取子串時如果只指定了一個索引值,則用于取得字符串中指定索引所對應的字符;如果指定兩個索引值,則返回兩個索引中間的字符串子串。假如有如下數據模型:

Map root = new HashMap(); 
root.put("book","struts2,freemarker");

可以通過如下語法來截取子串:

${book[0]}${book[4]}   //結果是su
${book[1..4]}     //結果是tru

3.4 集合連接運算符

這里所說的集合運算符是將兩個集合連接成一個新的集合,連接集合的運算符是+,看如下的例子:

<#list ["星期一","星期二","星期三"] + ["星期四","星期五","星期六","星期天"] as x>
    ${x}
</#list>

輸出結果是:

星期一 星期二 星期三 星期四 星期五 星期六 星期天

3.5 Map連接運算符

Map對象的連接運算符也是將兩個Map對象連接成一個新的Map對象,Map對象的連接運算符是+,如果兩個Map對象具有相同的key,則右邊的值替代左邊的值.看如下的例子:

<#assign scores = {"語文":86,"數學":78} + {"數學":87,"Java":93}>
語文成績是${scores.語文}
數學成績是${scores.數學}
Java成績是${scores.Java}

輸出結果是:

語文成績是86
數學成績是87
Java成績是93

3.6 算術運算符

FreeMarker表達式中完全支持算術運算,FreeMarker支持的算術運算符包括:+, - , * , / , % 看如下的代碼:

<#assign x=5>
${ x * x - 100 }
${ x /2 }
${ 12 %10 }

輸出結果是:

-75   2.5   2

在表達式中使用算術運算符時要注意以下幾點:

運算符兩邊的運算數字必須是數字
使用+運算符時,如果一邊是數字,一邊是字符串,就會自動將數字轉換為字符串再連接,如: ${3 + "5"}，結果是:35

使用內建的int函數可對數值取整,如:

<#assign x=5>
${ (x/2)?int }
${ 1.1?int }
${ 1.999?int }
${ -1.1?int }
${ -1.999?int }

結果是:

2 1 1 -1 -1

3.7 比較運算符

表達式中支持的比較運算符有如下幾個:

=或者==:判斷兩個值是否相等.
!=:判斷兩個值是否不等.
>或者gt:判斷左邊值是否大于右邊值
>=或者gte:判斷左邊值是否大于等于右邊值
<或者lt:判斷左邊值是否小于右邊值
<=或者lte:判斷左邊值是否小于等于右邊值

注意:=和!=可以用于字符串,數值和日期來比較是否相等,但=和!=兩邊必須是相同類型的值,否則會產生錯誤,而且FreeMarker是精確比較,"x","x ","X"是不等的.其它的運行符可以作用于數字和日期,但不能作用于字符串,大部分的時候,使用gt等字母運算符代替>會有更好的效果,因為FreeMarker會把>解釋成FTL標簽的結束字符,當然,也可以使用括號來避免這種情況,如:<#if (x>y)>。

3.8 邏輯運算符

邏輯運算符有如下幾個:

邏輯與: &&
邏輯或: ||
邏輯非: !

邏輯運算符只能作用于布爾值,否則將產生錯誤。

3.9 內建函數

FreeMarker還提供了一些內建函數來轉換輸出,可以在任何變量后緊跟“?”，“?”后緊跟內建函數,就可以通過內建函數來輪換輸出變量.下面是常用的內建的字符串函數:

html:對字符串進行HTML編碼
cap_first:使字符串第一個字母大寫
lower_case:將字符串轉換成小寫
upper_case:將字符串轉換成大寫
trim:去掉字符串前后的空白字符

下面是集合的常用內建函數

size:獲取序列中元素的個數

下面是數字值的常用內建函數

int:取得數字的整數部分,結果帶符號

例如:

<#assign test="Tom & Jerry">
${test?html}
${test?upper_case?html}

結果是:

Tom &amp; Jerry   TOM &amp; JERRY

3.10 空值處理運算符

FreeMarker對空值的處理非常嚴格,FreeMarker的變量必須有值,沒有被賦值的變量就會拋出異常,因為FreeMarker未賦值的變量強制出錯可以杜絕很多潛在的錯誤,如缺失潛在的變量命名,或者其他變量錯誤.這里所說的空值,實際上也包括那些并不存在的變量,對于一個Java的null值而言,我們認為這個變量是存在的,只是它的值為null,但對于FreeMarker模板而言,它無法理解null值,null值和不存在的變量完全相同.

為了處理缺失變量,FreeMarker提供了兩個運算符:

! :指定缺失變量的默認值
??:判斷某個變量是否存在

其中,!運算符的用法有如下兩種:variable!或variable!defaultValue,第一種用法不給缺失的變量指定默認值,表明默認值是空字符串,長度為0的集合,或者長度為0的Map對象。使用!指定默認值時,并不要求默認值的類型和變量類型相同.使用??運算符非常簡單,它總是返回一個布爾值,用法為:variable??,如果該變量存在,返回true,否則返回false。

3.11 運算符的優先級

FreeMarker中的運算符優先級如下(由高到低排列):

一元運算符: !
內建函數: ?
乘除法: *, / , %
加減法: - , +
比較: > , < , >= , <= (lt , lte , gt , gte)
相等: == , = , !=
邏輯與: &&
邏輯或: ||
數字范圍: ..

實際上,我們在開發過程中應該使用括號來嚴格區分,這樣的可讀性好,出錯少。

4. FreeMarker的常用指令

FreeMarker的FTL指令也是模板的重要組成部分,這些指令可實現對數據模型所包含數據的撫今迭代,分支控制.除此之外,還有一些重要的功能,也是通過FTL指令來實現的.

4.1 if指令

這是一個典型的分支控制指令,該指令的作用完全類似于Java語言中的if,if指令的語法格式如下:

<#if condition>...
<#elseif condition>...
<#elseif condition>...
<#else> ...
</#if>

例子如下:

<#assign age=23>
<#if (age>60)>
    老年人
<#elseif (age>40)>
    中年人
<#elseif (age>20)>
    青年人
<#else> 
    少年人
</#if>

輸出結果是:

青年人

上面的代碼中的邏輯表達式用括號括起來主要是因為里面有>符號,由于FreeMarker會將>符號當成標簽的結束字符,可能導致程序出錯,為了避免這種情況,我們應該在凡是出現這些符號的地方都使用括號。

4.2 switch , case , default , break指令

這些指令顯然是分支指令,作用類似于Java的switch語句,switch指令的語法結構如下:

<#switch value>
    <#case refValue>...<#break>
    <#case refValue>...<#break>
    <#default>...
</#switch>

4.3 list, break指令

list指令是一個迭代輸出指令,用于迭代輸出數據模型中的集合,list指令的語法格式如下:

<#list sequence as item>
    ...
</#list>

上面的語法格式中,sequence就是一個集合對象,也可以是一個表達式,但該表達式將返回一個集合對象,而item是一個任意的名字,就是被迭代輸出的集合元素.此外,迭代集合對象時,還包含兩個特殊的循環變量:

item_index:當前變量的索引值
item_has_next:是否存在下一個對象

除此之外，也可以使用<#break>指令跳出迭代。

例子如下:

<#list ["星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期天"] as x>
    ${x_index + 1}.${x}<#if x_has_next>,</if>
    <#if x="星期四"><#break></#if>
</#list>

4.4 include指令

include指令的作用類似于JSP的包含指令,用于包含指定頁.include指令的語法格式如下:

<#include filename [options]>

在上面的語法格式中,兩個參數的解釋如下:

filename:該參數指定被包含的模板文件
options:該參數可以省略,指定包含時的選項,包含encoding和parse兩個選項,其中encoding指定包含頁面時所用的解碼集,而parse指定被包含文件是否作為FTL文件來解析,如果省略了parse選項值,則該選項默認是true.

4.5 import指令

import指令用于導入FreeMarker模板中的所有變量,并將該變量放置在指定的Map對象中,import指令的語法格式如下:

<#import "/lib/common.ftl" as com>

上面的代碼將導入/lib/common.ftl模板文件中的所有變量,交將這些變量放置在一個名為com的Map對象中.

4.6 noparse指令

noparse指令指定FreeMarker不處理該指定里包含的內容,該指令的語法格式如下:

<#noparse>...</#noparse>

看如下的例子:

<#noparse>
<#list books as book>
   <tr><td>${book.name}<td>作者:${book.author}
</#list>
</#noparse>

輸出如下:

<#list books as book>
   <tr><td>${book.name}<td>作者:${book.author}
</#list>

4.7 escape , noescape指令

escape指令導致body區的插值都會被自動加上escape表達式,但不會影響字符串內的插值,只會影響到body內出現的插值,使用escape指令的語法格式如下:

<#escape identifier as expression>...
    <#noescape>...</#noescape>
</#escape>

看如下的代碼:

<#escape x as x?html>
    First name:${firstName}
    Last name:${lastName}
    Maiden name:${maidenName}
</#escape>

上面的代碼等同于:

First name:${firstName?html}
Last name:${lastName?html}
Maiden name:${maidenName?html}

escape指令在解析模板時起作用而不是在運行時起作用,除此之外,escape指令也嵌套使用,子escape繼承父escape的規則,如下例子:

<#escape x as x?html>
    Customer Name:${customerName}
    Items to ship;
    <#escape x as itemCodeToNameMap[x]>
       ${itemCode1}
       ${itemCode2}
       ${itemCode3}
       ${itemCode4}
    </#escape>
</#escape>

上面的代碼類似于:

Customer Name:${customerName?html}
Items to ship;
${itemCodeToNameMap[itemCode1]?html}
${itemCodeToNameMap[itemCode2]?html}
${itemCodeToNameMap[itemCode3]?html}
${itemCodeToNameMap[itemCode4]?html}

對于放在escape指令中所有的插值而言,這此插值將被自動加上escape表達式,如果需要指定escape指令中某些插值無需添加escape表達式,則應該使用noescape指令,放在noescape指令中的插值將不會添加escape表達式。

4.8 assign指令

assign指令在前面已經使用了多次,它用于為該模板頁面創建或替換一個頂層變量,assign指令的用法有多種,包含創建或替換一個頂層變量,或者創建或替換多個變量等,它的最簡單的語法如下:

<#assign name=value [in namespacehash]>

這個用法用于指定一個名為name的變量,該變量的值為value,此外,FreeMarker允許在使用assign指令里增加in子句,in子句用于將創建的name變量放入namespacehash命名空間中。

assign指令還有如下用法:

<#assign name1=value1 name2=value2 ... nameN=valueN [in namespacehash]>

這個語法可以同時創建或替換多個頂層變量,此外,還有一種復雜的用法,如果需要創建或替換的變量值是一個復雜的表達式,則可以使用如下語法格式:

<#assign name [in namespacehash]>capture this</#assign>

在這個語法中,是指將assign指令的內容賦值給name變量。如下例子:

<#assign x>
    <#list ["星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期天"] as n>
        ${n}
    </#list>
</#assign>
${x}

上面的代碼將產生如下輸出:

星期一 星期二 星期三 星期四 星期五 星期六 星期天

雖然assign指定了這種復雜變量值的用法,但是我們也不要濫用這種用法,如下例子:

<#assign x>Hello ${user}!</#assign>

以上代碼改為如下寫法更合適:

<#assign x="Hello ${user}!">

4.9 setting指令

該指令用于設置FreeMarker的運行環境,該指令的語法格式如下:<#setting name=value>,在這個格式中,name的取值范圍包含如下幾個:

locale:該選項指定該模板所用的國家/語言選項
number_format:指定格式化輸出數字的格式
boolean_format:指定兩個布爾值的語法格式,默認值是true,false
date_format,time_format,datetime_format:指定格式化輸出日期的格式
time_zone:設置格式化輸出日期時所使用的時區

4.10 macro , nested , return指令

macro可以用于實現自定義指令,通過使用自定義指令,可以將一段模板片段定義成一個用戶指令,使用macro指令的語法格式如下:

<#macro name param1 param2 ... paramN>
    ...
    <#nested loopvar1, loopvar2, ..., loopvarN>
    ...
    <#return>
    ...
</#macro>

在上面的格式片段中,包含了如下幾個部分:

name:name屬性指定的是該自定義指令的名字,使用自定義指令時可以傳入多個參數
paramX:該屬性就是指定使用自定義指令時報參數,使用該自定義指令時,必須為這些參數傳入值
nested指令:nested標簽輸出使用自定義指令時的中間部分
nested指令中的循環變量:這此循環變量將由macro定義部分指定,傳給使用標簽的模板
return指令:該指令可用于隨時結束該自定義指令.

看如下的例子:

<#macro book>   //定義一個自定義指令
j2ee
</#macro>
<@book />    //使用剛才定義的指令

上面的代碼輸出結果為:

j2ee

在上面的代碼中,可能很難看出自定義標簽的用處,因為我們定義的book指令所包含的內容非常簡單,實際上,自定義標簽可包含非常多的內容,從而可以實現更好的代碼復用.此外,還可以在定義自定義指令時,為自定義指令指定參數,看如下代碼:

<#macro book booklist>     //定義一個自定義指令booklist是參數
    <#list booklist as book>
       ${book}
    </#list>
</#macro>
<@book booklist=["spring","j2ee"] />   //使用剛剛定義的指令

上面的代碼為book指令傳入了一個參數值,上面的代碼的輸出結果為:

spring j2ee

不僅如此,還可以在自定義指令時使用nested指令來輸出自定義指令的中間部分,看如下例子:

<#macro page title>
<html>
<head>
   <title>FreeMarker示例頁面 - ${title?html}</title>
</head>
<body>
   <h1>${title?html}</h1>
   <#nested>      //用于引入用戶自定義指令的標簽體
</body>
</html>
</#macro>

上面的代碼將一個HTML頁面模板定義成一個page指令,則可以在其他頁面中如此page指令:

<#import "/common.ftl" as com>     //假設上面的模板頁面名為common.ftl,導入頁面
<@com.page title="book list">
<u1>
<li>spring</li>
<li>j2ee</li>
</ul>
</@com.page >

從上面的例子可以看出,使用macro和nested指令可以非常容易地實現頁面裝飾效果,此外,還可以在使用nested指令時,指定一個或多個循環變量,看如下代碼:

<#macro book>
<#nested 1>      //使用book指令時指定了一個循環變量值
<#nested 2>
</#macro>
<@book ;x> ${x} .圖書</@book >

當使用nested指令傳入變量值時,在使用該自定義指令時,就需要使用一個占位符(如book指令后的;x).上面的代碼輸出文本如下:

1 .圖書    2 .圖書

在nested指令中使用循環變量時,可以使用多個循環變量,看如下代碼:

<#macro repeat count>
    <#list 1..count as x>     //使用nested指令時指定了三個循環變量
       <#nested x, x/2, x==count>
    </#list>
</#macro>
<@repeat count=4 ; c halfc last>
    ${c}. ${halfc}<#if last> Last! </#if>
</@repeat >

上面的輸出結果為:

1. 0.5   2. 1   3. 1.5   4. 2 Last;

return指令用于結束macro指令,一旦在macro指令中執行了return指令,則FreeMarker不會繼續處理macro指令里的內容,看如下代碼:

<#macro book>
spring
<#return>
j2ee
</#macro>
<@book />

上面的代碼輸出:

spring

而j2ee位于return指令之后,不會輸出。

4.11 t, lt, rt 指令

語法:

<#t> 去掉左右空白和回車換行

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

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

<#nt> 取消上面的效果

4.12 指令總結

if, else, elseif
switch, case, default, break
list, break
include
Import
compress
escape, noescape
assign
global
setting
macro, nested, return
t, lt, rt, nt

5. 高級方法

5.1 自定義方法

自定義方法，如：

${timer("yyyy-MM-dd H:mm:ss", x)}
${timer("yyyy-MM-dd ", x)}

在模板中除了可以通過對象來調用方法外（${object.methed(args)}）也可以直接調用java實現的方法，java類必須實現接口TemplateMethodModel的方法exec(List args). 下面以把毫秒的時間轉換成按格式輸出的時間為例子：

public class LongToDate implements TemplateMethodModel {
    
    public TemplateModel exec(List args) throws TemplateModelException {
        SimpleDateFormat mydate = new SimpleDateFormat((String) args.get(0)));
        return mydate.format(new Date(Long.parseLong((String)args.get(1)));
    }
}

將LongToDate對象放入到數據模型中:

root.put("timer", new LongToDate());

ftl模板里使用：

<#assign x = "123112455445">
${timer("yyyy-MM-dd H:mm:ss", x)}
${timer("yyyy-MM-dd ", x)}

輸出結果：

2001-10-12 5:21:12
2001-10-12

5.2 自定義 Transforms

實現自定義的<@transform>文本或表達式</@transform >的功能,允許對中間的最終文本進行解析轉換

例子：實現<@upcase>str</@upcase > 將str轉換成STR的功能.

代碼如下：

import java.io.*;
import java.util.*;
import freemarker.template.TemplateTransformModel;
public class UpperCaseTransform implements TemplateTransformModel {
    public Writer getWriter(Writer out, Map args) {
        return new UpperCaseWriter(out);
    }
    private class UpperCaseWriter extends Writer {
       
        private Writer out;
           
        UpperCaseWriter (Writer out) {
            this.out = out;
        }
        public void write(char[] cbuf, int off, int len)
                throws IOException {
            out.write(new String(cbuf, off, len).toUpperCase());
        }
        public void flush() throws IOException {
            out.flush();
        }
        public void close() {
        }
    }
}

然后將此對象put到數據模型中, 如下所示：

root.put("upcase", new UpperCaseTransform());

在view(ftl)頁面中可以如下方式使用：

<@upcase>
hello world
</@upcase >

打印輸出:

HELLO WORLD

最后編輯于：2017.12.06 21:37:33

?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明：文章內容（如有圖片或視頻亦包括在內）由作者上傳并發布，文章內容僅代表作者本人觀點，簡書系信息發布平臺，僅提供信息存儲服務。

人面猴
序言：七十年代末，一起剝皮案震驚了整個濱河市，隨后出現的幾起案子，更是在濱河造成了極大的恐慌，老刑警劉巖，帶你破解...
沈念sama閱讀 229,885評論 6贊 541
死咒
序言：濱河連續發生了三起死亡事件，死亡現場離奇詭異，居然都是意外死亡，警方通過查閱死者的電腦和手機，發現死者居然都...
沈念sama閱讀 99,312評論 3贊 429
救了他兩次的神仙讓他今天三更去死
文/潘曉璐我一進店門，熙熙樓的掌柜王于貴愁眉苦臉地迎上來，“玉大人，你說我怎么就攤上這事。” “怎么了？”我有些...
開封第一講書人閱讀 177,993評論 0贊 383
道士緝兇錄：失蹤的賣姜人
文/不壞的土叔我叫張陵，是天一觀的道長。經常有香客問我，道長，這世上最難降的妖魔是什么？我笑而不...
開封第一講書人閱讀 63,667評論 1贊 317
?港島之戀（遺憾婚禮）
正文為了忘掉前任，我火速辦了婚禮，結果婚禮上，老公的妹妹穿的比我還像新娘。我一直安慰自己，他們只是感情好，可當我...
茶點故事閱讀 72,410評論 6贊 411
惡毒庶女頂嫁案：這布局不是一般人想出來的
文/花漫我一把揭開白布。她就那樣靜靜地躺著，像睡著了一般。火紅的嫁衣襯著肌膚如雪。梳的紋絲不亂的頭發上，一...
開封第一講書人閱讀 55,778評論 1贊 328
城市分裂傳說
那天，我揣著相機與錄音，去河邊找鬼。笑死，一個胖子當著我的面吹牛，可吹牛的內容都是我干的。我是一名探鬼主播，決...
沈念sama閱讀 43,775評論 3贊 446
雙鴛鴦連環套：你想象不到人心有多黑
文/蒼蘭香墨我猛地睜開眼，長吁一口氣：“原來是場噩夢啊……” “哼！你這毒婦竟也來了？” 一聲冷哼從身側響起，我...
開封第一講書人閱讀 42,955評論 0贊 289
萬榮殺人案實錄
序言：老撾萬榮一對情侶失蹤，失蹤者是張志新（化名）和其女友劉穎，沒想到半個月后，有當地人在樹林里發現了一具尸體，經...
沈念sama閱讀 49,521評論 1贊 335
?護林員之死
正文獨居荒郊野嶺守林人離奇死亡，尸身上長有42處帶血的膿包…… 初始之章·張勛以下內容為張勛視角年9月15日...
茶點故事閱讀 41,266評論 3贊 358
?白月光啟示錄
正文我和宋清朗相戀三年，在試婚紗的時候發現自己被綠了。大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
茶點故事閱讀 43,468評論 1贊 374
活死人
序言：一個原本活蹦亂跳的男人離奇死亡，死狀恐怖，靈堂內的尸體忽然破棺而出，到底是詐尸還是另有隱情，我是刑警寧澤，帶...
沈念sama閱讀 38,998評論 5贊 363
?日本核電站爆炸內幕
正文年R本政府宣布，位于F島的核電站，受9級特大地震影響，放射性物質發生泄漏。R本人自食惡果不足惜，卻給世界環境...
茶點故事閱讀 44,696評論 3贊 348
男人毒藥：我在死后第九天來索命
文/蒙蒙一、第九天我趴在偏房一處隱蔽的房頂上張望。院中可真熱鬧，春花似錦、人聲如沸。這莊子的主人今日做“春日...
開封第一講書人閱讀 35,095評論 0贊 28
一樁弒父案，背后竟有這般陰謀
文/蒼蘭香墨我抬頭看了看天上的太陽。三九已至，卻和暖如春，著一層夾襖步出監牢的瞬間，已是汗流浹背。一陣腳步聲響...
開封第一講書人閱讀 36,385評論 1贊 294
情欲美人皮
我被黑心中介騙來泰國打工，沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留，地道東北人。一個月前我還...
沈念sama閱讀 52,193評論 3贊 398
代替公主和親
正文我出身青樓，卻偏偏與公主長得像，于是被迫代替她去往敵國和親。傳聞我的和親對象是個殘疾皇子，可洞房花燭夜當晚...
茶點故事閱讀 48,431評論 2贊 378

三个男躁一个女,国精产品一区一手机的秘密,麦子交换系列最经典十句话,欧美国产综合欧美视频

FreeMarker使用

FreeMarker使用

目錄

前言

1. FTL指令規則

2. 插值規則

2.1 通用插值

2.2 數字格式化插值

3. 表達式

3.1 直接指定值

3.2 輸出變量值

3.3 字符串操作

3.4 集合連接運算符

3.5 Map連接運算符

3.6 算術運算符

3.7 比較運算符

3.8 邏輯運算符

3.9 內建函數

3.10 空值處理運算符

3.11 運算符的優先級

4. FreeMarker的常用指令

4.1 if指令

4.2 switch , case , default , break指令

4.3 list, break指令

4.4 include指令

4.5 import指令

4.6 noparse指令

4.7 escape , noescape指令

4.8 assign指令

4.9 setting指令

4.10 macro , nested , return指令

4.11 t, lt, rt 指令

4.12 指令總結

5. 高級方法

5.1 自定義方法

5.2 自定義 Transforms

推薦閱讀更多精彩內容

三个男躁一个女,国精产品一区一手机的秘密,麦子交换系列最经典十句话,欧美 国产 综合 欧美 视频

FreeMarker使用

目錄

前言

1. FTL指令規則

2. 插值規則

2.1 通用插值

2.2 數字格式化插值

3. 表達式

3.1 直接指定值

3.2 輸出變量值

3.3 字符串操作

3.4 集合連接運算符

3.5 Map連接運算符

3.6 算術運算符

3.7 比較運算符

3.8 邏輯運算符

3.9 內建函數

3.10 空值處理運算符

3.11 運算符的優先級

4. FreeMarker的常用指令

4.1 if指令

4.2 switch , case , default , break指令

4.3 list, break指令

4.4 include指令

4.5 import指令

4.6 noparse指令

4.7 escape , noescape指令

4.8 assign指令

4.9 setting指令

4.10 macro , nested , return指令

4.11 t, lt, rt 指令

4.12 指令總結

5. 高級方法

5.1 自定義方法

5.2 自定義 Transforms

推薦閱讀更多精彩內容

三个男躁一个女,国精产品一区一手机的秘密,麦子交换系列最经典十句话,欧美国产综合欧美视频