案例-指令參考描述:本人自己測試寫了一遍,如有錯的地方,懂freemarker的朋友望指點指點!
案例-指令參考
表達式
一、 Assign
1、<#assign name1="北京" name2="上海" name3="廣東"> 調用:${name1}、${name2}、${name3} 2、<#assign name1> 消息模擬.. </#assign> 調用:${name1} 3、<#assign name5 in my命名空間> 消息模擬.. </#assign> 調用:<#import "InstructionReference.ftl" as my命名空間> ${my.name5}
二、attempt, recover
<#attempt> =============>輸出:${my.name5} <#recover> 錯誤recover block </#attempt> attempt block:任意內容的模板塊。這是會被執行的, 但是如果期間發生了錯誤,那么這塊內容的輸出將會回滾,之后 recover block 就會被執行。 recover block: 任意內容的模板塊。 這個僅在 attempt block 執行期間發生錯誤時被執行。你可以在這里打印錯誤信息或其他操。
三、compress
當你使用了對空白、換行的格式(比如HTML或XML) 時壓縮指令對於移除多余的空白 <#assign x = " moo \n\n "> <#compress> 1 2 3 4 5 ${x} test only I said, test only </#compress>
四、flush
<#Flush> 說明:當 FreeMarker 生成輸出時,它通常不會立即發送到最終接收端
(比如web瀏覽器或最終的文件),而是會將內容累積在緩沖區,
發送一個大塊的內容。 緩沖區的精確規則不是由 FreeMarker 決定的
,而是由嵌入的軟件決定的。 將緩沖區中累積的內容發送出去稱為沖洗。
五、function, return
<#function name param1 param2 ... paramN> ... <#return returnValue> ... </#function> 說明: name:方法變量的名稱(不是表達式) param1, param2 等: 局部變量的名稱, 存儲參數的值(不是表達式),在 = 號后面和默認值 (是表達式)是可選的。 paramN,最后一個參數, 可以可選的包含一個尾部省略(...), 這就意味着宏接受可變的參數數量。局部變量 paramN 將是額外參數的序列。 returnValue: 計算方法調用值的表達式。 return 指令可以在 <#function ...> 和 </#function> 之間被用在任意位置和任意次數。 沒有默認值的參數必須在有默認值參數 (paramName=defaultValue) 之前 示例1: <#function avg x y> <#return (x + y) * 6> </#function> ${avg (10, 20)} 示例2: <#function avg nums...> <#local sum = 0> <#list nums as num> <#local sum = sum + num> </#list> <#if nums? size = 5> <#return sum / nums? size> </#if> </#function> ${avg (10, 20, 30, 40, 40)}//參數可任意個
六、global全局變量
1、<#global name1="北京2"> 調用:${name1} 2、<#global name1="北京" name2="上海" name3="廣東"> 調用:${name1}、${name2}、${name3} 3、<#global name4>消息模擬. </#global> 調用:${name4} 說明:一個相同名稱的變量存在的話, 那么會隱藏由 global 指令創建的變量。
七、if, else, elseif
示例1:只有 if 沒有 elseif 和 else <#if x == 1> x is 1 </#if> 示例2:只有 if 沒有 elseif 但是有 else <#if x == 1> x is 1 <#else> x is not 1 </#if> 示例3:有 if 和兩個 elseif 但是沒有 else <#if x == 1> x is 1 <#elseif x == 2> x is 2 <#elseif x == 3> x is 3 </#if> 示例4:有 if 和三個 elseif 還有 else <#if x == 1> x is 1 <#elseif x == 2> x is 2 <#elseif x == 3> x is 3 <#elseif x == 4> x is 4 <#else> x is not 1 nor 2 nor 3 nor 4 </#if> 示例5:嵌套 if 指令 <#if x == 1> x is 1 <#if y == 1> and y is 1 too <#else> but y is not </#if> <#else> x is not 1 <#if y < 0> and y is less than 0 </#if> </#if>
八、import
<#import path as hash> 說明:使用參考assign,創建一個命名空間引入然后被調用。 path模板的路徑。 這是一個算作是字符串的表達式。(換句話說,它不是一個固定的字符串, 它可以是這樣的一些東西,比如,profile.baseDir + "/menu.ftl"。) hash訪問命名空間的哈希表變量不帶引號的名字。不是表達式。 (要引入動態創建的名字) 示例:<#import "/libs/mylib.ftl" as my> <@my.copyright date="1999-2002"/>
九、include
<#include path> 或 <#include path options> path包含文件的路徑;一個算作是字符串的表達式。(用其他話說, 它不用是一個固定的字符串,它也可以是像"/menu.ftl"這樣的東西。) options一個或多個這樣的選項: encoding=encoding, parse=parse parse: 算作是布爾值的表達式(為了向下兼容,也接受一部分字符串值) encoding: 算作是字符串的表達式 ignore_missing: 算作是布爾值的表達式 parse:如果它為 true, 那么被包含的文件將會當作FTL來解析,否則整個文件將被視為簡單文本 (也就是說不會在其中查找 FreeMarker 的結構)。如果你忽略了這個選項, 那么它默認是 true。 encoding:被包含文件從包含它的文件繼承的編碼方式 (實際就是字符集),除非你用這個選項來指定編碼方式。 合法的名字有:ISO-8859-2,UTF-8,Shift_JIS,Big5,EUC-KR,GB2312。 ignore_missing:當為 true,模板引用為空時壓制錯誤,而 <#include ...> 不會輸出任何東西。當為 false 時,如果模板不存在, 那么模板處理就會發生錯誤並停止。如果忽略這個選項,那么它的默認值是 false。 說明:使用它在你的模板中插入另外一個 FreeMarker 模板文件 (由 path 參數指定)。 被包含模板的輸出格式是在 include 標簽出現的位置插入的。 被包含的文件和包含它的模板共享變量,就像是被復制粘貼進去的一樣。 示例: <#include "/common/copyright.ftl"> <#include "/common/navbar.html" parse=false encoding="Shift_JIS">
十、local
<#local name=value> 或 <#local name1=value1 name2=value2 ... nameN=valueN> 或 <#local name> capture this </#local> 說明:name在root中局部對象的名稱。它不是一個表達式。但它可以被寫作是字符串形式, 如果變量名包含保留字符,這是很有用的,比如 <#local "foo-bar" = 1>。 請注意,這個字符串沒有擴展插值(如"${foo}")。 =:賦值操作符,也可以簡寫的賦值操作符之一 (++,+= 等...),和 assign 指令 相似。value 存儲的值,是表達式。 示例:它和 assign 指令 類似,但是它創建或替換局部變量。 這僅僅在宏和方法的內部定義才會有作用。 <#function Str1 nums> <#local sum = "......."> <#return sum + nums> </#function> 調用:${Str1("測試")} 輸出:.......測試
十一、macro, nested, return
<#macro name param1 param2 ... paramN> ... <#nested loopvar1, loopvar2, ..., loopvarN> ... <#return> ... </#macro> 說明: • name: 宏變量的名稱,它不是表達式。和 頂層變量 的語法相同,比如 myMacro 或 my\-macro。 然而,它可以被寫成字符串的形式,如果宏名稱中包含保留字符時,這是很有用的,
比如 <#macro "foo~bar">...。 注意這個字符串沒有擴展插值(如"${foo}")。 • param1, param2,等...: 局部變量 的名稱,存儲參數的值 (不是表達式),在 = 號后面和默認值(是表達式)是可選的。 默認值也可以是另外一個參數,
比如 <#macro section title label=title>。參數名稱和 頂層變量 的語法相同,所以有相同的特性和限制。 • paramN, 最后一個參數,可能會有三個點(...), 這就意味着宏接受可變數量的參數,不匹配其它參數的參數可以作為最后一個參數 (也被稱作籠統參數)。
當宏被命名參數調用, paramN 將會是包含宏的所有未聲明的鍵/值對的哈希表。當宏被位置參數調用,
paramN將是額外參數的序列。 (在宏內部,要查找參數,可以使用 myCatchAllParam?is_sequence。) • loopvar1, loopvar2等...: 可選的,循環變量 的值, 是 nested 指令想為嵌套內容創建的。這些都是表達式。 return 和 nested 指令是可選的,而且可以在 <#macro…> 和 </#macro> 之間被用在任意位置和任意次數
示例1:標准寫法
<#macro test1>
Test text
</#macro>
調用:
<@mtest1/>
示例2:帶參數的宏(參數可多個)
<#macro test2 data>
Test text:${data}
</#macro>
調用:
<@test2 data="Hello"/>
示例3:帶參數、默認參數(可多個)
<#macro test3 data1 data2="2" data3="3">
===>${data1}
===>${data2}
===>${data3}
</#macro>
調用:
<@test3 data1="Hello" data2="Hello"/> <@test3 data1="Hello" />
示例4:集合迭代元素的宏
<#macro list title items>
<p>${title? cap_first}: </p>
<ul>
<#list items as x>
<li>${x? cap_first} </li>
</#list>
</ul>
</#macro>
調用:
<@list items=["mouse", "elephant", "python"] title="標題"/>
Nested
Nested
說明:ested 指令執行自定義指令開始和結束標簽中間的模板片段。 嵌套的片段可以包含模板中任意合法的內容 示例1:標准簡單 <#macro do_twice> 1. <#nested> 2. <#nested> </#macro> 調用:<@do_twice>something</@do_twice> 輸出: 示例2:嵌套內容創建循環變量 <#macro do_thrice> <#nested 1> <#nested 2> <#nested 3> </#macro> 調用:<@do_thrice; x> ${x} Anything. </@do_thrice>
return
說明:可以在任意位置留下一個宏或函數定義。 <#macro test d> This test <#return> Will not be printed${d} </#macro> 調用:<@test d="===>"/>
十二、noparse(不解析ftl)
<#noparse> ... </#noparse> 說明:不會在這個指令體中間尋找FTL標簽, 插值和其他特殊的字符序列,除了noparse的結束標記,避開對noparse內部ftl的解析。 示例1: <#noparse> <#list animals as animal> <tr><td>${animal.name} <td>${animal. price} Euros </#list> </#noparse>
十三、stop
<#stop> 或 <#stop reason> 說明:reason停止對模版解析,並且拋出一個異常,終止原因的信息化消息。是表達式,被算做是字符串,中止模板處理,給出(可選的)錯誤消息。 不要在普通情況下對結束模板處理使用! FreeMarker 模板的調用者會將它視為失敗的模板呈現。
十四、switch, case, default, break
<#switch "2"> <#case "1"> ===>;1 <#break> <#case "2"> ===>; 2 <#break> <#case "3"> ===>; 3 <#break> </#switch> 說明:value, refValue1表達式將會計算成相同類型的標量,break 和 default 是可選的。
十五、t, lt, rt
<#t> <#lt> <#rt> 說明:指示FreeMarker去忽略標記中行的特定的空白的移除發生在解析階段 t (整體削減):忽略本行中首和尾的所有空白。 lt (左側削減):忽略本行中首部所有的空白。 rt (右側削減):忽略本行中尾部所有的空白。