freemarker語法.doc

By zhxing 1、if, else, elseif語法： . . . .備注：condition、condition2必須為boolean 類型，、可有0或多個。實例： x is 1 x is 2 x is 3 x is 4 x is not 1 nor 2 nor 3 nor 4 備注： 號 必須轉(zhuǎn)義，否則出錯。轉(zhuǎn)義請參考其他文檔。2、switch, case, default, break語法 . . . . .備注：該指令官方不推薦使用了，可以用if, else, elseif 指令代替。3、list, break語法 .備注： sequence 為一個sequence 或者 collection 類型。item 為 循環(huán)的變量。該指令中包含有兩個特殊的循環(huán)變量，item_index：該值為當前循環(huán)的值。 item_has_next：該值為一個boolean類型，表明該循環(huán)是否含有下一個（是否為循環(huán)到了最后一個）實例： $x_index + 1. $x, 輸出： 1. winter, 2. spring, 3. summer, 4. autumn 實例： $i 備注：當x 為一個數(shù)值序列時，可以使用該list 列出兩個數(shù)值之間的值。（適合于表格的序號填寫）實例： $x 備注：可以用 來終止該循環(huán)。4、include語法或者備注：path: 為包含一個文件的路徑或者是一個輸出為String 類型的表達式。 options: 一個或多個的參數(shù): encoding=encoding, parse=parse encoding: 包含文件解析的編碼，如GBK、utf-8等parse: 為一個boolean 類型值，true為用ftl解析，false為當作text文件解析 (also accepts a few string values for backward compatibility)實例：/common/copyright.ftl內(nèi)容：Copyright 2001-2002 $meAll rights reserved. 主體內(nèi)容： Some testYeah. 輸出 Some testYeah.Copyright 2001-2002 Juila SmithAll rights reserved. 備注：path 可以包含*任意取值，例如：*/copyright.ftl、commons/*/copyright.ftl等，*表示任意路徑下的。該指令具有國際化，如， 這個指令的搜索文件的順序為footer_en_US.ftl,footer_en.ftl,footer.ftl （本地為英國）。5、import語法：備注：path:模板的路徑名. hash: 在該文件中使用該模板指令的名稱。實例：文件中的使用： 6、noparse語法： .備注：該指令包含的文件將不被解析成ftl，而是直接輸出。實例：Example:- $$being.price Euros 輸出： Example:- $$being.price Euros 7、compress語法： .備注：該指令將會把數(shù)據(jù)模型中的空格或者html格式去掉。實例：( 1 2 3 4 5 $moo test only I said, test only) 輸出：(1 2 3 4 5mootest onlyI said, test only)8、escape, noescape語法： . . . 備注：該指令對$該指令進行了格式化的輸出。備注： Customer Name: $customerName Items to ship: $itemCode1 $itemCode2 $itemCode3 $itemCode4 相當于：Customer Name: $customerName?html Items to ship: $itemCodeToNameMapitemCode1?html $itemCodeToNameMapitemCode2?html $itemCodeToNameMapitemCode3?html $itemCodeToNameMapitemCode4?html9、assign語法：ororor capture thisor capture this備注：該指令可以創(chuàng)建或者替換變量為頁面使用，該變量為最高的層才能被創(chuàng)建或替換，如foo，當foo.bar時將不能被創(chuàng)建或者替換。name：變量的名稱。value：變量的值。namespacehash：import指令中的引用名。實例： 實例： 實例：foo $n Number of words: $x?word_list?size$x 輸出：Number of words: 6 1 foo 2 foo 3 foo10、global語法：oror capture this備注：該指令相似于assign 指令，只是該指令創(chuàng)建的變量可以被所有命名空間使用。實例： $x$.global.x輸出：21備注：如果在當前命名空間中，有同名的變量存在，則global 變量將沒隱藏，如需訪問則：$.global.x 11、local語法：oror capture this備注：該指令類似 assign 指令，但它創(chuàng)建或者替換了本例變量，它只能在macro定義或者function 定義中有效。12、setting語法：備注：該指令的設(shè)置將影響到該指令設(shè)置的地方以下的內(nèi)容有效。它提供的設(shè)值有：local：該值為本地的語言，將影響數(shù)值、時間等的格式。取值例如：en, en_US, en_US_MACnumber_format:用于將數(shù)值轉(zhuǎn)換成String，當沒有明確的格式被指定時。boolean_format:用于將boolean轉(zhuǎn)換成Stringdate_format,time_format,datetime_format:用于將時間轉(zhuǎn)換成Stringtime_zone:用于設(shè)置時區(qū),如GMT, GMT+2, GMT-1:30, CET, PST, America/Los_Angelesurl_escaping_charset:classic_compatible:實例：$1.2$1.2 輸出：1,21.2 13、User-defined directive ()語法：(Note the XML-style / before the ) or if you need loop variables Or the same as the above two but with end-tag .or .Or all above but with positional parameter passing .etc.備注：該指令為調(diào)用用戶自定義的指令，比如macro實例：. $title?cap_first: $x?cap_first 輸出： Animals: Mouse Elephant Python . 實例： $x. Something. This was the last! 14、macro, nested, return語法： . . .備注：該指令保存著模板的部分定義，可以用用戶指令來調(diào)用該指令使用。該指令可以定義在任何地方，不管設(shè)定的地方之前或者之后都能使用。也可以指定默認參數(shù)的默認值。實例： Test text, and the params: $foo, $bar, $baaz 輸出： Test text, and the params: a, b, 23 Test text, and the params: a, b, -1 Test text, and the params: a, Bar, 23 Test text, and the params: a, Bar, -1實例： img src=/context$src?html $attr=$extraattr?html 輸出： 實例： $x Anything. 輸出： 1 Anything. 2 Anything. 3 Anything.實例： Test text Will not be printed. 輸出：Test text15、function, return語法： . .備注：該指令創(chuàng)建了一個方法變量，該指令和macro指令類似，只是return 中必須有返回值。實例： $avg(10, 20) 輸出：15實例： $avg(10, 20)$avg(10, 20, 30, 40)$avg()!N/A 輸出:1525N/A16、flush語法：備注：強制輸出。雖然FreeMarker會自動的flush 但有些時候要強制flash 的時候可以使用該指令。17、stop語法：or備注：當FreeMarker要強制終止的時候，可以使用該指令，reason 為自定義終止的原因。18、ftl語法：備注：該指令是提供一些參數(shù)如果該文件是ftl文件，如果該文件存在則該設(shè)置在文件的最開始的地方。設(shè)置的參數(shù)有：encoding：模板的編碼，取值為：utf-8、GBK等strip_whitespace:是否去掉空格。取值為true、falsestrip_text:是否去掉最高層的文本，取值為true、falsestrict_syntax:是否為嚴格的語法，取值為true、falsens_prefixes:attributes:19、t, lt, rt語法 -在該行中忽略所有的空格 -在該行中忽略左邊的所有空格 -在該行中忽略右邊的所有空格 -不去掉該行的空格實例：- 1 2 3 4 5 6- 輸出：-1 23 4 5 6- 20、attempt, recover語法： attempt block recover block備注：該指令是一個錯誤的捕獲，和java 中的 trycatch 相似。是修復指令，代替出錯的輸出文本。實例：Primary content Optional content: $thisMayFails Ops! The optional content is not available.Primary content continued 輸出：如果thisMayFails 變量不存在Primary content Ops! The optional content is not available.Primary content continued 如果thisMayFails 變量存在Primary content Optional content: 123Primary content continued21、visit, recurse, fallback語法：orororor備注：visit 和recurse 指令是用來遞歸處理樹節(jié)點的。在實際中，很多情況下是用來處理xml。實例：Done. Now Im handling a node that has the name x. Just to show how to access th