有關(guān)freemarks參考方面知識

《有關(guān)freemarks參考方面知識》由會員分享，可在線閱讀，更多相關(guān)《有關(guān)freemarks參考方面知識（36頁珍藏版）》請在裝配圖網(wǎng)上搜索。

1、有關(guān)freemarks參考方面知識 Freemarker的內(nèi)置函數(shù)及用法關(guān)鍵詞(Keyword)：Freemarker,Freemarker內(nèi)置函數(shù)在我們應(yīng)用Freemarker過程中，經(jīng)常會操作例如字符串，數(shù)字，集合等，卻不清楚Freemrker有沒有類似于Java一樣有相關(guān)的類及方法。在本文當(dāng)中，我將向大家詳細(xì)的介紹Freemarke的內(nèi)置函數(shù)及用法，以便能幫助大家更熟練的應(yīng)用Freemarker完成項目開發(fā)一、Sequence的內(nèi)置函數(shù)要sequence?first 返回sequence的第一個值。sequence?last 返回sequence的最后一個值。sequence?rever

2、se 將sequence的現(xiàn)有順序反轉(zhuǎn)，即倒序排序sequence?size 返回sequence的大小sequence?sort 將sequence中的對象轉(zhuǎn)化為字符串后順序排序sequence?sort_by(value) 按sequence中對象的屬性value進行排序注意：Sequence不能為null。以上方法在我的另一篇博客Freemarker中如何遍歷List有詳細(xì)的應(yīng)用，感興趣的朋友可以參考。二、Hash的內(nèi)置函數(shù)通hash?keys 返回hash里的所有key,返回結(jié)果為sequencehash?values 返回hash里的所有value,返回結(jié)果為sequence例如：#

3、assign user=“name”:“hailang”, “sex”:“man”#assign keys=user?keys#list keys as key$key=$userkey/#list三、操作字符串函數(shù)substring（start,end）str?substring(0)(結(jié)果為str$str?substring(1)(結(jié)果為tr$str?substring(2)(結(jié)果為r$str?substring(3)(結(jié)果為$str?substring(0,0)(結(jié)果為$str?substring(0,1)(結(jié)果為s$str?substring(0,2)(結(jié)果為st$str?substr

4、ing(0,3)(結(jié)果為strcap_first 將字符串中的第一個單詞的首字母變?yōu)榇髮憽?str？cap_first(結(jié)果為Struncap_first將字符串中的第一個單詞的首字母變?yōu)樾憽?Str？cap_first(結(jié)果為strcapitalize將字符串中的所有單詞的首字母變?yōu)榇髮?str？ capitalize(結(jié)果為STRdate,time，datetime將字符串轉(zhuǎn)換為日期例如：#assign date1=”x-10-12”?date(“yyyy-MM-dd”)#assign date2=”9:28:20”?time(“HH:mm:ss”)#assign date3=” x-1

5、0-12 9:28:20”?time(“HH:mm:ss”)$date1(結(jié)果為x-10-12$date2(結(jié)果為9:28:20$date3(結(jié)果為x-10-12 9:28:20注意：如果指定的字符串格式不正確將引發(fā)錯誤。ends_with 判斷某個字符串是否由某個子串結(jié)尾，返回布爾值。$“string”?ends_with(“ing”)?string 返回結(jié)果為true注意：布爾值必須轉(zhuǎn)換為字符串才能輸出html 用于將字符串中的、和“替換為對應(yīng)得quot:ampindex_of（substring,start）在字符串中查找某個子串，返回找到子串的第一個字符的索引，如果沒有找到子串，則返回

6、-1。 Start參數(shù)用于指定從字符串的那個索引處開始搜索，start為數(shù)字值。 如果start大于字符串長度，則start取值等于字符串長度，如果start小于0， 則start取值為0。 $“string”?index_of(“in”) (結(jié)果為3$“string”?index_of(“ab”) (結(jié)果為-1length返回字符串的長度 $“string”?length(結(jié)果為6lower_case將字符串轉(zhuǎn)為小寫$“STRING”?lower_case(結(jié)果為stringupper_case將字符串轉(zhuǎn)為大寫$“string”?upper_case(結(jié)果為STRINGcontains 判斷

7、字符中是否包含某個子串。返回布爾值 $“string”?contains(“ing”)?string (結(jié)果為true注意：布爾值必須轉(zhuǎn)換為字符串才能輸出number將字符串轉(zhuǎn)換為數(shù)字 $“111.11”?number(結(jié)果為111.11replace用于將字符串中的一部分從左到右替換為另外的字符串。$“strabg”?replace(“ab”,”in”) (結(jié)果為string split使用指定的分隔符將一個字符串拆分為一組字符串#list “This|is|split”?split(“|”) as s$s/#list結(jié)果為:This issplittrim 刪除字符串首尾空格 $“ Str

8、ing ”?trim (結(jié)果為String四、操作數(shù)字c 用于將數(shù)字轉(zhuǎn)換為字符串$123?c (結(jié)果為123string用于將數(shù)字轉(zhuǎn)換為字符串Freemarker中預(yù)訂義了三種數(shù)字格式：number,currency（貨幣）和percent(百分比)其中number為默認(rèn)的數(shù)字格式轉(zhuǎn)換例如： #assign tempNum=20$tempNum $tempNum?string.number或$tempNum?string(“number”) (結(jié)果為20$tempNum?string.currency或$tempNum?string(“currency”) (結(jié)果為￥20.00$tempNum

9、?string. percent或$tempNum?string(“percent”) (結(jié)果為2,000%五、操作布爾值string 用于將布爾值轉(zhuǎn)換為字符串輸出true轉(zhuǎn)為“true”，false轉(zhuǎn)換為“false”foo?string(“yes”,”no”)如果布爾值是true,那么返回“yes”,否則返回no通過上面對開發(fā)中常用的Freemarker內(nèi)置函數(shù)及用法的介紹，相信您已經(jīng)對這些函數(shù)的有了一定的了解，希望本文能對您的開發(fā)有所幫助。如果您在閱讀本文的過程中發(fā)現(xiàn)問題，請通過留言的形式給與批評指正，謝謝！提供該xx的機構(gòu)為 百洋軟件研究實驗室 ，更多的博客文章可以到 百洋軟件研究實驗

10、室博客 查看。該xx附件歡迎各位轉(zhuǎn)載，但是在沒有獲得文章作者許可之前，不得對文章內(nèi)容或者版權(quán)信息進行更改，版權(quán)歸百洋軟件研究實驗室所有，僅此聲明。FreeMarker的模板文件并不比HTML頁面復(fù)雜多少,FreeMarker模板文件主要由如下4個部分組成:1,文本:直接輸出的部分2,注釋:#- . -格式部分,不會輸出3,插值:即$.或#.格式的部分,將使用數(shù)據(jù)模型中的部分替代輸出4,FTL指令:FreeMarker指定,和HTML標(biāo)記類似,名字前加#予以區(qū)分,不會輸出下面是一個FreeMarker模板的例子,包含了以上所說的4個部分htmlbrheadbrtitleWelcome!/titl

11、ebr/headbrbodybr#- 注釋部分 -br#- 下面使用插值 -h1Welcome $user !/h1brpWe have these animals:bru1br#- 使用FTL指令 -#list animals as beingbr li$being.name for $being.price Eurosbr#listbru1br/bodybr/html1, FTL指令規(guī)則在FreeMarker中,使用FTL標(biāo)簽來使用指令,FreeMarker有3種FTL標(biāo)簽,這和HTML標(biāo)簽是完全類似的.1,開始標(biāo)簽:#directivename parameter2,結(jié)束標(biāo)簽:/#dir

12、ectivename3,空標(biāo)簽:#directivename parameter/實際上,使用標(biāo)簽時前面的符號#也可能變成,如果該指令是一個用戶指令而不是系統(tǒng)內(nèi)建指令時,應(yīng)將#符號改成符號.使用FTL標(biāo)簽時,應(yīng)該有正確的嵌套,而不是交叉使用,這和XML標(biāo)簽的用法完全一樣.如果全用不存在的指令,FreeMarker不會使用模板輸出,而是產(chǎn)生一個錯誤消息.FreeMarker會忽略FTL標(biāo)簽中的空白字符.值得注意的是 , / 和指令之間不允許有空白字符.2, 插值規(guī)則FreeMarker的插值有如下兩種類型:1,通用插值$expr;2,數(shù)字格式化插值:#expr或#expr;format2.1 通

13、用插值對于通用插值,又可以分為以下4種情況:1,插值結(jié)果為字符串值:直接輸出表達式結(jié)果2,插值結(jié)果為數(shù)字值:根據(jù)默認(rèn)格式(由#setting指令設(shè)置)將表達式結(jié)果轉(zhuǎn)換成文本輸出.可以使用內(nèi)建的字符串函數(shù)格式化單個插值,如下面的例子:#settion number_format=currency/#assign answer=42/$answer$answer?string #- the same as $answer -$answer?string.number$answer?string.currency$answer?string.percent$answer輸出結(jié)果是:$42.00$42

14、.0042$42.004,200%3,插值結(jié)果為日期值:根據(jù)默認(rèn)格式(由#setting指令設(shè)置)將表達式結(jié)果轉(zhuǎn)換成文本輸出.可以使用內(nèi)建的字符串函數(shù)格式化單個插值,如下面的例子:$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)輸出結(jié)果是:x-04-08 08:08:08 Pacific Daylight TimeTue, Apr 8, 03Tuesday, April

15、08, 2003, 08:08:08 PM (PDT)4,插值結(jié)果為布爾值:根據(jù)默認(rèn)格式(由#setting指令設(shè)置)將表達式結(jié)果轉(zhuǎn)換成文本輸出.可以使用內(nèi)建的字符串函數(shù)格式化單個插值,如下面的例子:#assign foo=true/$foo?string(yes, no)輸出結(jié)果是:yes2.2 數(shù)字格式化插值數(shù)字格式化插值可采用#expr;format形式來格式化數(shù)字,其中format可以是:mX:小數(shù)部分最小X位MX:小數(shù)部分最大X位如下面的例子:#assign x=2.582/#assign y=4/#x; M2 #- 輸出2.58 -#y; M2 #- 輸出4 -#x; m2 #-

16、輸出2.6 -#y; m2 #- 輸出4.0 -#x; m1M2 #- 輸出2.58 -#x; m1M2 #- 輸出4.0 -3, 表達式表達式是FreeMarker模板的核心功能,表達式放置在插值語法$之中時,表明需要輸出表達式的值;表達式語法也可與FreeMarker標(biāo)簽結(jié)合,用于控制輸出.實際上FreeMarker的表達式功能非常強大,它不僅支持直接指定值,輸出變量值,也支持字符串格式化輸出和集合訪問等功能.3.1 直接指定值使用直接指定值語法讓FreeMarker直接輸出插值中的值,而不是輸出變量值.直接指定值可以是字符串,數(shù)值,布爾值,集合和MAP對象.1,字符串直接指定字符串值使用

17、單引號或雙引號限定,如果字符串值中包含特殊字符需要轉(zhuǎn)義,看下面的例子:$我的文件保存在C:盤$我名字是annlee輸出結(jié)果是: 我的文件保存在C:盤我名字是annleeFreeMarker支持如下轉(zhuǎn)義字符:;雙引號(u0022);單引號(u0027);反斜杠(u005C)n;換行(u000A)r;回車(u000D)t;Tab(u0009)b;退格鍵(u0008)f;Form feed(u000C)l;g;a;xCode;直接通過4位的16進制數(shù)來指定Unicode碼,輸出該unicode碼對應(yīng)的字符.如果某段文本中包含大量的特殊符號,FreeMarker提供了另一種特殊格式:可以在指定字符串內(nèi)

18、容的引號前增加r標(biāo)記,在r標(biāo)記后的文件將會直接輸出.看如下代碼:$r$foo$rC:foobar輸出結(jié)果是:$fooC:foobar2,數(shù)值表達式中的數(shù)值直接輸出,不需要引號.小數(shù)點使用.分隔,不能使用分組,符號.FreeMarker目前還不支持科學(xué)計數(shù)法,所以1E3是錯誤的.在FreeMarker表達式中使用數(shù)值需要注意以下幾點:1,數(shù)值不能省略小數(shù)點前面的0,所以.5是錯誤的寫法2,數(shù)值8 , +8 , 8.00都是相同的3,布爾值直接使用true和false,不使用引號.4,集合集合以方括號包括,各集合元素之間以英文逗號,分隔,看如下的例子:#list 星期一, 星期二, 星期三, 星期

19、四, 星期五, 星期六, 星期天 as x$x/#list輸出結(jié)果是:星期一星期二星期三星期四星期五星期六星期天除此之外,集合元素也可以是表達式,例子如下:2 + 2, 1, 2, 3, 4, whatnot還可以使用數(shù)字范圍定義數(shù)字集合,如2.5等同于2, 3, 4, 5,但是更有效率.注意,使用數(shù)字范圍來定義集合時無需使用方括號,數(shù)字范圍也支持反遞增的數(shù)字范圍,如5.25,Map對象Map對象使用花括號包括,Map中的key-value對之間以英文冒號:分隔,多組key-value對之間以英文逗號,分隔.下面是一個例子:語文:78, 數(shù)學(xué):80Map對象的key和value都是表達式,但是

20、key必須是字符串3.2 輸出變量值FreeMarker的表達式輸出變量時,這些變量可以是頂層變量,也可以是Map對象中的變量,還可以是集合中的變量,并可以使用點(.)語法來訪問Java對象的屬性.下面分別討論這些情況1,頂層變量所謂頂層變量就是直接放在數(shù)據(jù)模型中的值,例如有如下數(shù)據(jù)模型:Map root = new HashMap; /創(chuàng)建數(shù)據(jù)模型root.put(name,annlee); /name是一個頂層變量對于頂層變量,直接使用$variableName來輸出變量值,變量名只能是字母,數(shù)字,下劃線,$,和#的組合,且不能以數(shù)字開頭號.為了輸出上面的name的值,可以使用如下語法:$

21、name2,輸出集合元素如果需要輸出集合元素,則可以根據(jù)集合元素的索引來輸出集合元素,集合元素的索引以方括號指定.假設(shè)有索引:星期一,星期二,星期三,星期四,星期五,星期六,星期天.該索引名為week,如果需要輸出星期三,則可以使用如下語法:$week2 /輸出第三個集合元素此外,FreeMarker還支持返回集合的子集合,如果需要返回集合的子集合,則可以使用如下語法:week3.5 /返回week集合的子集合,子集合中的元素是week集合中的第4-6個元素3,輸出Map元素這里的Map對象可以是直接HashMap的實例,甚至包括JavaBean實例,對于JavaBean實例而言,我們一樣可以

22、把其當(dāng)成屬性為key,屬性值為value的Map實例.為了輸出Map元素的值,可以使用點語法或方括號語法.假如有下面的數(shù)據(jù)模型: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);為了訪問數(shù)據(jù)模型中名為struts2的書的作者的名字,可以使用如

23、下語法:book.author.name /全部使用點語法bookauthor.namebook.authorname /混合使用點語法和方括號語法bookauthorname /全部使用方括號語法使用點語法時,變量名字有頂層變量一樣的限制,但方括號語法沒有該限制,因為名字可以是任意表達式的結(jié)果.3.3, 字符串操作FreeMarker的表達式對字符串操作非常靈活,可以將字符串常量和變量連接起來,也可以返回字符串的子串等.字符串連接有兩種語法:1,使用$.或#.在字符串常量部分插入表達式的值,從而完成字符串連接.2,直接使用連接運算符+來連接字符串例如有如下數(shù)據(jù)模型:Map root = ne

24、w HashMap; root.put(user,annlee);下面將user變量和常量連接起來:$hello, $user! /使用第一種語法來連接$hello, + user + ! /使用+號來連接上面的輸出字符串都是hello,annlee!,可以看出這兩種語法的效果完全一樣.值得注意的是,$.只能用于文本部分,不能用于表達式,下面的代碼是錯誤的:#if $isBigWow!/#if#if $isBigWow!/#if應(yīng)該寫成:#if isBigWow!/#if截取子串可以根據(jù)字符串的索引來進行,截取子串時如果只指定了一個索引值,則用于取得字符串中指定索引所對應(yīng)的字符;如果指定兩個索

25、引值,則返回兩個索引中間的字符串子串.假如有如下數(shù)據(jù)模型:Map root = new HashMap; root.put(book,struts2,freemarker);可以通過如下語法來截取子串:$book0$book4 /結(jié)果是su$book1.4? /結(jié)果是tru3.4 集合連接運算符這里所說的集合運算符是將兩個集合連接成一個新的集合,連接集合的運算符是+,看如下的例子:#list 星期一,星期二,星期三 + 星期四,星期五,星期六,星期天 as x$x/#list輸出結(jié)果是:星期一 星期二星期三 星期四 星期五 星期六 星期天3.5 Map連接運算符Map對象的連接運算符也是將兩個

26、Map對象連接成一個新的Map對象,Map對象的連接運算符是+,如果兩個Map對象具有相同的key,則右邊的值替代左邊的值.看如下的例子:#assign scores = 語文:86,數(shù)學(xué):78 + 數(shù)學(xué):87,Java:93語文成績是$scores.語文數(shù)學(xué)成績是$scores.數(shù)學(xué)Java成績是$scores.Java輸出結(jié)果是:語文成績是86數(shù)學(xué)成績是87Java成績是933.6 算術(shù)運算符FreeMarker表達式中完全支持算術(shù)運算,FreeMarker支持的算術(shù)運算符包括:+, - , * , / , % 看如下的代碼:#assign x=5$ x * x - 100 $ x /2

27、$ 12 %10 輸出結(jié)果是:-75 2.5 2在表達式中使用算術(shù)運算符時要注意以下幾點:1,運算符兩邊的運算數(shù)字必須是數(shù)字2,使用+運算符時,如果一邊是數(shù)字,一邊是字符串,就會自動將數(shù)字轉(zhuǎn)換為字符串再連接,如:$3 + 5,結(jié)果是:35使用內(nèi)建的int函數(shù)可對數(shù)值取整,如:#assign x=5$ (x/2)?int $ 1.1?int $ 1.999?int $ -1.1?int $ -1.999?int 結(jié)果是:2 1 1 -1 -13.7 比較運算符表達式中支持的比較運算符有如下幾個:1,=或者=:判斷兩個值是否相等.2,!=:判斷兩個值是否不等.3,或者gt:判斷左邊值是否大于右邊值

28、4,=或者gte:判斷左邊值是否大于等于右邊值5,或者lt:判斷左邊值是否小于右邊值6,=或者lte:判斷左邊值是否小于等于右邊值注意:=和!=可以用于字符串,數(shù)值和日期來比較是否相等,但=和!=兩邊必須是相同類型的值,否則會產(chǎn)生錯誤,而且FreeMarker是精確比較,x,x ,X是不等的.其它的運行符可以作用于數(shù)字和日期,但不能作用于字符串,大部分的時候,使用gt等字母運算符代替會有更好的效果,因為FreeMarker會把解釋成FTL標(biāo)簽的結(jié)束字符,當(dāng)然,也可以使用括號來避免這種情況,如:#if (xy)3.8 邏輯運算符邏輯運算符有如下幾個:邏輯與:邏輯或:|邏輯非:!邏輯運算符只能作用

29、于布爾值,否則將產(chǎn)生錯誤3.9 內(nèi)建函數(shù)FreeMarker還提供了一些內(nèi)建函數(shù)來轉(zhuǎn)換輸出,可以在任何變量后緊跟?,?后緊跟內(nèi)建函數(shù),就可以通過內(nèi)建函數(shù)來輪換輸出變量.下面是常用的內(nèi)建的字符串函數(shù):html:對字符串進行HTML編碼cap_first:使字符串第一個字母大寫lower_case:將字符串轉(zhuǎn)換成小寫upper_case:將字符串轉(zhuǎn)換成大寫trim:去掉字符串前后的空白字符下面是集合的常用內(nèi)建函數(shù)size:獲取序列中元素的個數(shù)下面是數(shù)字值的常用內(nèi)建函數(shù)int:取得數(shù)字的整數(shù)部分,結(jié)果帶符號例如:#assign test=Tom Jerry$test?html$test?upper_

30、case?html結(jié)果是:Tom Jerry TOM JERRY3.10 空值處理運算符FreeMarker對空值的處理非常嚴(yán)格,FreeMarker的變量必須有值,沒有被賦值的變量就會拋出異常,因為FreeMarker未賦值的變量強制出錯可以杜絕很多潛在的錯誤,如缺失潛在的變量命名,或者其他變量錯誤.這里所說的空值,實際上也包括那些并不存在的變量,對于一個Java的null值而言,我們認(rèn)為這個變量是存在的,只是它的值為null,但對于FreeMarker模板而言,它無法理解null值,null值和不存在的變量完全相同.為了處理缺失變量,FreeMarker提供了兩個運算符:!:指定缺失變量的

31、默認(rèn)值:判斷某個變量是否存在其中,!運算符的用法有如下兩種:variable!或variable!defaultValue,第一種用法不給缺失的變量指定默認(rèn)值,表明默認(rèn)值是空字符串,長度為0的集合,或者長度為0的Map對象.使用!指定默認(rèn)值時,并不要求默認(rèn)值的類型和變量類型相同.使用運算符非常簡單,它總是返回一個布爾值,用法為:variable,如果該變量存在,返回true,否則返回false3.11 運算符的優(yōu)先級FreeMarker中的運算符優(yōu)先級如下(由高到低排列):1,一元運算符:!2,內(nèi)建函數(shù):?3,乘除法:*, / , %4,加減法:- , +5,比較: , , = , = (lt

32、 , lte , gt , gte)6,相等:= , = , !=7,邏輯與:8,邏輯或:|9,數(shù)字范圍:.實際上,我們在開發(fā)過程中應(yīng)該使用括號來嚴(yán)格區(qū)分,這樣的可讀性好,出錯少4 FreeMarker的常用指令FreeMarker的FTL指令也是模板的重要組成部分,這些指令可實現(xiàn)對數(shù)據(jù)模型所包含數(shù)據(jù)的撫今迭代,分支控制.除此之外,還有一些重要的功能,也是通過FTL指令來實現(xiàn)的.4.1 if指令這是一個典型的分支控制指令,該指令的作用完全類似于Java語言中的if,if指令的語法格式如下:#if condition.#elseif condition.#elseif condition.#el

33、se ./#if例子如下:#assign age=23#if (age60)老年人#elseif (age40)中年人#elseif (age20)青年人#else 少年人/#if輸出結(jié)果是:青年人上面的代碼中的邏輯表達式用括號括起來主要是因為里面有符號,由于FreeMarker會將符號當(dāng)成標(biāo)簽的結(jié)束字符,可能導(dǎo)致程序出錯,為了避免這種情況,我們應(yīng)該在凡是出現(xiàn)這些符號的地方都使用括號.4.2 switch , case , default , break指令這些指令顯然是分支指令,作用類似于Java的switch語句,switch指令的語法結(jié)構(gòu)如下:#switch value#case ref

34、Value.#break#case refValue.#break#default./#switch4.3 list, break指令list指令是一個迭代輸出指令,用于迭代輸出數(shù)據(jù)模型中的集合,list指令的語法格式如下:#list sequence as item./#list上面的語法格式中,sequence就是一個集合對象,也可以是一個表達式,但該表達式將返回一個集合對象,而item是一個任意的名字,就是被迭代輸出的集合元素.此外,迭代集合對象時,還包含兩個特殊的循環(huán)變量:item_index:當(dāng)前變量的索引值item_has_next:是否存在下一個對象也可以使用#break指令跳出

35、迭代例子如下:#list 星期一, 星期二, 星期三, 星期四, 星期五, 星期六, 星期天 as x$x_index + 1.$x#if x_has_next,/if#if x=星期四#break/#if/#list4.4 include指令include指令的作用類似于JSP的包含指令,用于包含指定頁.include指令的語法格式如下:#include filename options在上面的語法格式中,兩個參數(shù)的解釋如下:filename:該參數(shù)指定被包含的模板文件options:該參數(shù)可以省略,指定包含時的選項,包含encoding和parse兩個選項,其中encoding指定包含頁面

36、時所用的解碼集,而parse指定被包含文件是否作為FTL文件來解析,如果省略了parse選項值,則該選項默認(rèn)是true.4.5 import指令該指令用于導(dǎo)入FreeMarker模板中的所有變量,并將該變量放置在指定的Map對象中,import指令的語法格式如下:#import /lib/common.ftl as com上面的代碼將導(dǎo)入/lib/common.ftl模板文件中的所有變量,交將這些變量放置在一個名為com的Map對象中.4.6 noparse指令noparse指令指定FreeMarker不處理該指定里包含的內(nèi)容,該指令的語法格式如下:#noparse./#noparse看如下的

37、例子:#noparse#list books as book trtd$book.nametd作者:$book.author/#list/#noparse輸出如下:#list books as book trtd$book.nametd作者:$book.author/#list4.7 escape , noescape指令escape指令導(dǎo)致body區(qū)的插值都會被自動加上escape表達式,但不會影響字符串內(nèi)的插值,只會影響到body內(nèi)出現(xiàn)的插值,使用escape指令的語法格式如下:#escape identifier as expression.#noescape./#noescape/#e

38、scape看如下的代碼:#escape x as x?htmlFirst name:$firstNameLast name:$lastNameMaiden name:$maidenName/#escape上面的代碼等同于:First name:$firstName?htmlLast name:$lastName?htmlMaiden name:$maidenName?htmlescape指令在解析模板時起作用而不是在運行時起作用,除此之外,escape指令也嵌套使用,子escape繼承父escape的規(guī)則,如下例子:#escape x as x?htmlCustomer Name:$custo

39、merNameItems to ship;#escape x as itemCodeToNameMapx $itemCode1 $itemCode2 $itemCode3 $itemCode4/#escape/#escape上面的代碼類似于:Customer Name:$customerName?htmlItems to ship;$itemCodeToNameMapitemCode1?html$itemCodeToNameMapitemCode2?html$itemCodeToNameMapitemCode3?html$itemCodeToNameMapitemCode4?html對于放在e

40、scape指令中所有的插值而言,這此插值將被自動加上escape表達式,如果需要指定escape指令中某些插值無需添加escape表達式,則應(yīng)該使用noescape指令,放在noescape指令中的插值將不會添加escape表達式.4.8 assign指令assign指令在前面已經(jīng)使用了多次,它用于為該模板頁面創(chuàng)建或替換一個頂層變量,assign指令的用法有多種,包含創(chuàng)建或替換一個頂層變量,或者創(chuàng)建或替換多個變量等,它的最簡單的語法如下:#assign name=value in namespacehash,這個用法用于指定一個名為name的變量,該變量的值為value,此外,FreeMark

41、er允許在使用assign指令里增加in子句,in子句用于將創(chuàng)建的name變量放入namespacehash命名空間中.assign指令還有如下用法:#assign name1=value1 name2=value2 . nameN=valueN in namespacehash,這個語法可以同時創(chuàng)建或替換多個頂層變量,此外,還有一種復(fù)雜的用法,如果需要創(chuàng)建或替換的變量值是一個復(fù)雜的表達式,則可以使用如下語法格式:#assign name in namespacehashcapture this/#assign,在這個語法中,是指將assign指令的內(nèi)容賦值給name變量.如下例子:#assi

42、gn x#list 星期一, 星期二, 星期三, 星期四, 星期五, 星期六, 星期天 as n$n/#list/#assign$x上面的代碼將產(chǎn)生如下輸出:星期一星期二 星期三 星期四 星期五 星期六 星期天雖然assign指定了這種復(fù)雜變量值的用法,但是我們也不要濫用這種用法,如下例子:#assign xHello $user!/#assign,以上代碼改為如下寫法更合適:#assign x=Hello $user!4.9 setting指令該指令用于設(shè)置FreeMarker的運行環(huán)境,該指令的語法格式如下:#setting name=value,在這個格式中,name的取值范圍包含如下幾

43、個:locale:該選項指定該模板所用的國家/語言選項number_format:指定格式化輸出數(shù)字的格式boolean_format:指定兩個布爾值的語法格式,默認(rèn)值是true,falsedate_format,time_format,datetime_format:指定格式化輸出日期的格式time_zone:設(shè)置格式化輸出日期時所使用的時區(qū)4.10 macro , nested , return指令macro可以用于實現(xiàn)自定義指令,通過使用自定義指令,可以將一段模板片段定義成一個用戶指令,使用macro指令的語法格式如下:#macro name param1 param2 . paramN

44、.#nested loopvar1, loopvar2, ., loopvarN.#return./#macro在上面的格式片段中,包含了如下幾個部分:name:name屬性指定的是該自定義指令的名字,使用自定義指令時可以傳入多個參數(shù)paramX:該屬性就是指定使用自定義指令時報參數(shù),使用該自定義指令時,必須為這些參數(shù)傳入值nested指令:nested標(biāo)簽輸出使用自定義指令時的中間部分nested指令中的循環(huán)變量:這此循環(huán)變量將由macro定義部分指定,傳給使用標(biāo)簽的模板return指令:該指令可用于隨時結(jié)束該自定義指令.看如下的例子:#macro book /定義一個自定義指令j2ee/#

45、macrobook / /使用剛才定義的指令上面的代碼輸出結(jié)果為:j2ee在上面的代碼中,可能很難看出自定義標(biāo)簽的用處,因為我們定義的book指令所包含的內(nèi)容非常簡單,實際上,自定義標(biāo)簽可包含非常多的內(nèi)容,從而可以實現(xiàn)更好的代碼復(fù)用.此外,還可以在定義自定義指令時,為自定義指令指定參數(shù),看如下代碼:#macro book booklist? /定義一個自定義指令booklist是參數(shù)#list booklist as book $book/#list/#macrobook booklist=spring,j2ee / /使用剛剛定義的指令上面的代碼為book指令傳入了一個參數(shù)值,上面的代碼的輸

46、出結(jié)果為:spring j2ee不僅如此,還可以在自定義指令時使用nested指令來輸出自定義指令的中間部分,看如下例子:#macro page titlehtmlhead titleFreeMarker示例頁面 - $title?html/title/headbody h1$title?html/h1 #nested /用于引入用戶自定義指令的標(biāo)簽體/body/html/#macro上面的代碼將一個HTML頁面模板定義成一個page指令,則可以在其他頁面中如此page指令:#import /common.ftl as com? /假設(shè)上面的模板頁面名為common.ftl,導(dǎo)入頁面com.p

47、age title=book listu1lispring/lilij2ee/li/ul/com.page從上面的例子可以看出,使用macro和nested指令可以非常容易地實現(xiàn)頁面裝飾效果,此外,還可以在使用nested指令時,指定一個或多個循環(huán)變量,看如下代碼:#macro book#nested 1 /使用book指令時指定了一個循環(huán)變量值#nested 2/#macrobook ;x $x .圖書/book當(dāng)使用nested指令傳入變量值時,在使用該自定義指令時,就需要使用一個占位符(如book指令后的;x).上面的代碼輸出文本如下:1 .圖書 2 .圖書在nested指令中使用循環(huán)變

48、量時,可以使用多個循環(huán)變量,看如下代碼:#macro repeat count#list 1.count as x? /使用nested指令時指定了三個循環(huán)變量 #nested x, x/2, x=count/#list/#macrorepeat count=4 ; c halfc last$c. $halfc#if last Last! /#if/repeat上面的輸出結(jié)果為:1. 0.5 2. 1 3. 1.5 4. 2 Last;return指令用于結(jié)束macro指令,一旦在macro指令中執(zhí)行了return指令,則FreeMarker不會繼續(xù)處理macro指令里的內(nèi)容,看如下代碼:#macro bookspring#returnj2ee/#macrobook /上面的代碼輸出:spring,而j2ee位于return指令之后,不會輸出.Page 1921 June 23 Author: hailang DesignBy:Jackson.wangFreemarker的內(nèi)置函數(shù)及用法 Freemarker的內(nèi)置函數(shù)及用法x年10月12日hailang19INFO-EC-INFO百洋軟件研究實驗室學(xué)習(xí)資料xx Freemarker的內(nèi)置函數(shù)及用法