基本介紹
- 中文名：福瑞馬克
- 外文名：FreeMarker
- 類別：模板引擎
- 特點：通用性高，模板語言強大
- 最新版本：FreeMarker 2.3.23
發展歷史,工作原理,基本語法,指令,內建函式,空變數,性能特點,評價,
發展歷史
LOGO1999年末，FreeMarker的第一個版本出現在SourceForge網站上，它最初是由Benjamin Geer和Mike Bayer編寫，他們定義了FreeMarker最基本的語法。FreeMarker 1獲得了LGPL（寬通用公共許可證）的許可，其著作權歸屬於Benjamin Geer。此外，Nicholas Cull、Holger Arendt等人對該項目也做出了主要貢獻。
在2002年初，Jonathan Revusky用JavaCC重寫了FreeMarker的核心代碼（語法和編譯），雖然對FreeMarker 1儘量做到向後兼容，但幾乎是完全重寫了。Attila Szegedi對FreeMarker 2也有重要影響，除了重構和最佳化一些核心的API（應用程式編程接口），Attila還作為主要編寫者實現了FreeMarker對日期、時間的支持，寫出的freemarker.ext*包完成對javabean、Jython和XML的映射，以及HTTP servlet、JSP和Ant的集成。Dániel Dékány主要負責文檔以及項目的維護（截至2011年，Dániel Dékány仍是該項目的主要維護者）。
2002年3月18日，FreeMarker的第一個發布候選版2.0 RC1發布，又經過了2個候選版的BUG修復之後，正式版的Free Marker2.0於2002年4月18日發布。2002年10月17日，FreeMarker 2.1 發布，該版本並不能與2.0版本兼容，所以使用者如果不是新建工程的話，需要重新審視已有的代碼和模版。
2004年6月15日，FreeMarker 2.3 發布，此版本對2.2系列進行了質量上的改進，以及引入了大量的新功能。最主要的改進點在於可以定義函式（方法）模版，插入字元串變數，支持宏參數和更為智慧型的默認對象包裝。但2.3並不支持2.2.x的向後兼容，所以僅供新項目使用。
2005年1月4日的2.3.1版本到10月10日2.3.4版本主要是編寫和維護一些新特性，以及BUG錯誤修復。2006年3月11日發布的2.3.5版本，因為發現嚴重錯誤而被撤回，在後續的2.3.6版本中修復。2.3.7時出了一個測試版本用於BUG修正和FreemarkerServlet的改進，其正式版中新增substring用於處理空的或缺失的變數。
2006年7月9日發布2.3.8版本，提高了對JSP 2.0的兼容性。
模板引擎的執行流程
模板引擎的執行流程2007年1月23日發布2.3.9版本，包含了對JDK 1.5枚舉和通過BeansWrapper公共類欄位的支持。
2007年4月20的2.3.10版本到2009年12月10日的2.3.16版本都是一些小性能改進和BUG修復。
2011年5月17日，FreeMarker 2.3.17 發布，該版本主要進行了安全性的修復並擴充了一些內建函式。
2011年5月22日，FreeMarker 2.3.18 發布，修復jar包相關的bug。
2012年2月29日，FreeMarker 2.3.19 發布，該版本修復了兩個重要的bug，另外新增對JSON字元串進行處理的方法json_string等小改動。
2013年6月27日，FreeMarker 2.3.20 發布，主要對於使用IDE工具的修改。
2014年10月12日，FreeMarker 2.3.21 發布，對Java版本的最低要求從1.2變為1.4。由於舊的BSD風格許可不被OSI所承認，且Visigoth Software Society停滯不前，其許可變更為Apache 2.0版，所有者轉為Attila Szegedi、Daniel Dekany和Jonathan Revusky（FreeMarker 2的主要開發者）。
2015年3月1日，FreeMarker 2.3.22 發布，在FTL模板和Java方面做了一些更改。
2015年7月1日，FreeMarker經過投票進入了Apache Incubator，其項目授予給Apache軟體基金會。
2015年7月5日，FreeMarker 2.3.23 發布，在FTL模板和Java上做了大量修改。尤其增加了list中items和else的字指令，使常見遍歷任務更簡單。
2015年9月2日，FreeMarker的主代碼庫從GitHub導入到Apache軟體基金會的基礎設施中發展。
2018年3月21日，FreeMarker在Apache Incubator中升級為頂級項目。
工作原理
假設在一個套用系統中需要一個HTML頁面如下：
<html> <head> <title>Welcome!</title> </head> <body> <h1>Welcome Big Joe!</h1> <p>Our latest product: <a href="products/greenmouse.html">green mouse</a>! </body></html>
頁面中的用戶名（即上面的“Big Joe”）是登錄這個網頁的訪問者的名字， 並且最新產品的數據應該來自於資料庫才能隨時更新。所以，不能直接在HTML頁面中輸入“Big Joe”、“greenmouse”及連結， 不能使用靜態HTML代碼。可以使用要求輸出的模板來解決，模板和靜態頁面是相同的，只是它會包含一些FreeMarker將它們變成動態內容的指令：
<html> <head> <title>Welcome!</title> </head> <body> <h1>Welcome ${user}!</h1> <p>Our latest product: <a href="${latestProduct.url}">${latestProduct.name}</a>! </body></html>模板檔案存放在Web伺服器上，當有人來訪問這個頁面，FreeMarker就會介入執行，然後動態轉換模板，用最新的數據內容替換模板中${...}的部分，之後將結果傳送到訪問者的Web瀏覽器中。訪問者的Web瀏覽器就會接收到例如第一個HTML示例那樣的內容（也就是沒有FreeMarker指令的HTML代碼），訪問者也不會察覺到伺服器端使用的FreeMarker。（存儲在Web伺服器端的模板檔案是不會被修改的；替換也僅僅出現在Web伺服器的回響中。）
為模板準備的數據整體被稱作為數據模型。數據模型是樹形結構（就像硬碟上的資料夾和檔案)，在視覺效果上， 數據模型可以是（這只是一個形象化顯示，數據模型不是文本格式，它來自於Java對象）：
(root) | +- user = "Big Joe" | +- latestProduct | +- url = "products/greenmouse.html" | +- name = "green mouse"
早期版本中，可以從數據模型中選取這些值，使用user和latestProduct.name表達式即可。類比於硬碟的樹形結構，數據模型就像一個檔案系統，“(root)”和latestProduct就對應著目錄（資料夾），而user、url和name就是這些目錄中的檔案。
總體上，模板和數據模型是FreeMarker來生成輸出所必須的組成部分：模板 + 數據模型 = 輸出。
基本語法
- ${...}：FreeMarker將會輸出真實的值來替換大括弧內的表達式，這樣的表達式被稱為interpolation（插值）。
- FTL標籤（FreeMarker模板的語言標籤）：FTL標籤和HTML標籤有一些相似之處，但是它們是FreeMarker的指令，是不會在輸出中列印的。這些標籤的名字以#開頭。（用戶自定義的FTL標籤則需要使用@來代替#）
指令
<#if condition> ...<#elseif condition2> ...<#elseif condition3> ...<#else> ...</#if>
if、elseif和else指令可以用來條件判斷是否越過模板的一個部分。condition必須計算成布爾值，否則錯誤將會中止模板處理。elseif和else必須出現在if內部（也就是在if的開始標籤和結束標籤之間）。if中可以包含任意數量的elseif（包括0個），而結束時else也是可選的。
假設 users 包含['Joe', 'Kate', 'Fred'] 序列：<#list users as user> <p>${user}</#list>輸出： <p>Joe <p>Kate <p>Fredlist指令執行在list開始標籤和list結束標籤（list中間的部分）之間的代碼，對於在序列（或集合）中每個值指定為它的第一個參數。對於每次疊代，循環變數將會存儲當前項的值。循環變數僅僅存在於list標籤體內。而且從循環中調用的宏/函式不會看到它（就像它只是局部變數一樣）。<#list>與<#else>、<#sep>組合是可選的，而且僅從FreeMarker 2.3.23版本開始支持。
將版權資訊單獨存放在頁面檔案 copyright_footer.html 中：<hr><i> Copyright (c) 2000 <a href="http://www.baidu.com">Baidu Inc</a>, <br> All Rights Reserved.</i>當需要用到這個檔案時，可以使用 include 指令來插入：<html> <head> <title>Test page</title> </head> <body> <h1>Test page</h1> <p>Blah blah... <#include "/copyright_footer.html"> </body></html>
include可以在模板中插入另外一個FreeMarker模板檔案（由路徑參數指定)。被包含模板的輸出格式是在include標籤出現的位置插入的。被包含的檔案和包含它的模板共享變數，就像是被複製貼上進去的一樣。include指令不能由被包含檔案的內容所替代，它只是當FreeMarker每次在模板處理期間到達include指令時處理被包含的檔案。所以對於如果include在list循環之中的例子，可以為每個循環周期內指定不同的檔案名稱。
內建函式
內建函式很像子變數（也像Java中的方法），它們並不是數據模型中的東西，是FreeMarker在數值上添加的。為了清晰子變數是哪部分，使用?（問號）代替，.（點）來訪問它們。常用內建函式的示例：
常用處理
常用處理- user?html給出user的HTML轉義版本，比如&會由&來代替。
- user?upper_case給出user值的大寫版本（比如“JOHN DOE”來替代“John Doe”）
- animal.name?cap_first給出animal.name的首字母大寫版本（比如“Mouse”來替代“mouse”）
- user?length給出user值中字元的數量（對於“John Doe”來說就是8）
- animals?size給出animals序列中項目的個數
- 如果在<#list animals as animal>和對應的</#list>標籤中：
- animal?index給出了在animals中基於0開始的animal的索引值
- animal?counter也像index，但是給出的是基於1的索引值
- animal?item_parity基於當前計數的奇偶性，給出字元串“odd”或“even”。在給不同行著色時非常有用，比如在<td class="${animal?item_parity}Row">中。
一些內建函式需要參數來指定行為，比如：
- animal.protected?string("Y", "N")基於animal.protected的布爾值來返回字元串“Y”或“N”。
- animal?item_cycle('lightRow','darkRow')是item_parity更為常用的變體形式。
- fruits?join(", ")通過連線所有項，將列錶轉換為字元串，在每個項之間插入參數分隔設定（比如“orange,banana”）
- user?starts_with("J")根據user的首字母是否是“J”返回布爾值true或false。
內建函式套用可以鏈式操作，比如user?upper_case?html會先轉換用戶名到大寫形式，之後再進行HTML轉義，和鏈式使用.（點）一樣。
空變數
數據模型中經常會有可選的變數（有時並不存在）。除了一些人為原因導致失誤外，FreeMarker不能引用不存在的變數，除非明確地告訴它當變數不存在時如何處理，如下兩種典型的處理方法：
這部分對程式設計師而言：一個不存在的變數和一個是null值的變數，對於FreeMarker來說是一樣的，所以這裡所指的“丟失”包含這兩種情況。
不論在哪裡引用變數，都可以指定一個默認值來避免變數丟失這種情況，通過在變數名後面跟著一個 !（感嘆號）和默認值。像下面的這個例子，當user不存在於數據模型時，模板將會將user的值表示為字元串 “visitor”。（當 user 存在時，模板就會表現出 ${user} 的值）：
<h1>Welcome ${user!"visitor"}!</h1>也可以在變數名後面通過放置??來詢問一個變數是否存在。將它和if指令合併，那么如果user變數不存在的話將會忽略整個問候的代碼段：
<#if user??> <h1>Welcome ${user}!</h1></#if>關於多級訪問的變數，比如 animals.python.price，書寫代碼：animals.python.price!0若且唯若animals.python永遠存在，而僅僅最後一個子變數price可能不存在時是正確的（這種情況下假設價格是0）。如果 animals或python不存在，那么模板處理過程將會以“未定義的變數”錯誤而停止。為了防止這種情況的發生， 可以如下這樣來編寫代碼 (animals.python.price)!0。這種情況就是說animals或python不存在時，表達式的結果是 0。對於??也是同樣用來的處理這種邏輯的；將animals.python.price??對比(animals.python.price)??來看。
性能特點
模板並沒有包含程式邏輯來查找當前的訪問者是誰，或者去查詢資料庫獲取最新的產品。顯示的數據是在FreeMarker之外準備的，通常是一些“真正的”程式語言（比如Java）所編寫的代碼。模板作者無需知道這些值是如何計算出的。事實上，這些值的計算方式可以完全被修改，而模板可以保持不變，而且頁面的樣式也可以完全被修改而無需改動模板。當模板作者（設計師）和程式設計師不是同一人時，顯示邏輯和業務邏輯相分離的做法是非常有用的，即便模板作者和程式設計師是一個人，這么來做也會幫助管理應用程式的複雜性。保證模板專注於顯示問題（視覺設計，布局和格式化）是高效使用模板引擎的關鍵。
1. 通用性
能夠生成各種文本：HTML、XML、RTF、Java原始碼等等。
易於嵌入到產品中：輕量級；不需要Servlet環境。
外掛程式式模板載入器：可以從任何源載入模板，如本地檔案、資料庫等等。
可以按所需生成文本：保存到本地檔案；作為Email傳送；從Web應用程式傳送它返回給Web瀏覽器。
MyEclipse工具下的編輯界面
能夠生成各種文本：HTML、XML、RTF、Java原始碼等等。
易於嵌入到產品中：輕量級；不需要Servlet環境。
外掛程式式模板載入器：可以從任何源載入模板，如本地檔案、資料庫等等。
可以按所需生成文本：保存到本地檔案；作為Email傳送；從Web應用程式傳送它返回給Web瀏覽器。
MyEclipse工具下的編輯界面2. 模板語言
所有常用的指令：include、if/elseif/else、循環結構。
在模板中創建和改變變數。
幾乎在任何地方都可以使用複雜表達式來指定值。
命名的宏，可以具有位置參數和嵌套內容。
名字空間有助於建立和維護可重用的宏庫，或者將一個大工程分成模組，而不必擔心名字衝突。
輸出轉換塊：在嵌套模板片段生成輸出時，轉換HTML轉義、壓縮、語法高亮等等；可以定義自己的轉換。
所有常用的指令：include、if/elseif/else、循環結構。
在模板中創建和改變變數。
幾乎在任何地方都可以使用複雜表達式來指定值。
命名的宏，可以具有位置參數和嵌套內容。
名字空間有助於建立和維護可重用的宏庫，或者將一個大工程分成模組，而不必擔心名字衝突。
輸出轉換塊：在嵌套模板片段生成輸出時，轉換HTML轉義、壓縮、語法高亮等等；可以定義自己的轉換。
3. 通用數據模型
FreeMarker不是直接反射到Java對象，Java對象通過外掛程式式對象封裝，以變數方式在模板中顯示。
可以使用抽象（接口）方式表示對象（JavaBean、XML文檔、SQL查詢結果集等等），告訴模板開發者使用。方法，使其不受技術細節的打擾。
FreeMarker不是直接反射到Java對象，Java對象通過外掛程式式對象封裝，以變數方式在模板中顯示。
可以使用抽象（接口）方式表示對象（JavaBean、XML文檔、SQL查詢結果集等等），告訴模板開發者使用。方法，使其不受技術細節的打擾。
4. 為Web準備
在模板語言中內建處理典型Web相關任務（如HTML轉義）的結構。
能夠集成到Model2 Web套用框架中作為JSP的替代。
支持JSP標記庫。
為MVC模式設計：分離可視化設計和應用程式邏輯；分離頁面設計員和程式設計師。
xml配置
在模板語言中內建處理典型Web相關任務（如HTML轉義）的結構。
能夠集成到Model2 Web套用框架中作為JSP的替代。
支持JSP標記庫。
為MVC模式設計：分離可視化設計和應用程式邏輯；分離頁面設計員和程式設計師。
xml配置