五、案例-指令參考-freemarker指令、表達式


案例-指令參考描述:本人自己測試寫了一遍,如有錯的地方,懂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 (右側削減):忽略本行中尾部所有的空白。

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM