FreeMarker:怎麼使用

第一個FreeMarker程式

1. 建立一個普通的java項目：testFreeMarker

2. 引入freemarker.jar包

3. 在項目目錄下建立模板目錄：templates

4. 在templates目錄下，建立a.ftl模板文件，內容如下：

你好啊，${user}，今天你的精神不錯！

5. 建立com.sxt.test.freemarker包，然後建立Test1.java文件，內容如下：

package com.sxt.test.freemarker;
 
import java.io.File;
import java.io.OutputStreamWriter;
import java.io.Writer;
import java.util.HashMap;
import java.util.Map;
 
import freemarker.template.Configuration;
import freemarker.template.DefaultObjectWrapper;
import freemarker.template.Template;
 
public class Test1 {
public static void main(String[] args) throws Exception {
//創建Freemarker配置實例
Configuration cfg = new Configuration();
cfg.setDirectoryForTemplateLoading(new File("templates")); 
//創建數據模型
Map root = new HashMap();
root.put("user", "老高");
//載入模板文件
Template t1 = cfg.getTemplate("a.ftl");
//顯示生成的數據,//將合併後的數據列印到控制台
Writer out = new OutputStreamWriter(System.out); 
t1.process(root, out);
out.flush();
 
//顯示生成的數據,//將合併後的數據直接返回成字元串！
// StringWriter out = new StringWriter();   
// t1.process(root, out);
// out.flush();
// String temp = out.toString();
// System.out.println(temp); }
}

編譯和運行Test1.java文件，控制台列印：

數據類型

一、 直接指定值

直接指定值可以是字元串、數值、布爾值、集合及Map對象。
1. 字元串
直接指定字元串值使用單引號或雙引號限定。字元串中可以使用轉義字元”"。如果字元串內有大量的特殊字元，則可以在引號的前面加上一個字母r，則字元串內的所有字元都將直接輸出。

2. 數值
數值可以直接輸入，不需要引號。FreeMarker不支持科學計數法。

3. 布爾值 
直接使用true或false，不使用引號。

4. 集合
集合用中括弧包括，集合元素之間用逗號分隔。
使用數字範圍也可以表示一個數字集合，如1..5等同於集合[1, 2, 3, 4, 5]；同樣也可以用5..1來表示[5, 4, 3, 2, 1]。

5. Map對象
Map對象使用花括弧包括，Map中的key-value對之間用冒號分隔，多組key-value對之間用逗號分隔。
註意：Map對象的key和value都是表達式，但key必須是字元串。

6. 時間對象

root.put("date1", new Date());

${date1?string("yyyy-MM-dd HH:mm:ss")}

7. JAVABEAN的處理

Freemarker中對於javabean的處理跟EL表達式一致，類型可自動轉化！非常方便！

一、 輸出變數值

FreeMarker的表達式輸出變數時，這些變數可以是頂層變數，也可以是Map對象的變數，還可以是集合中的變數，並可以使用點（.）語法來訪問Java對象的屬性。

1. 頂層變數
所謂頂層變數就是直接放在數據模型中的值。輸出時直接用

${variableName}

即可。

2. 輸出集合元素
可 以根據集合元素的索引來輸出集合元素，索引用中括弧包括。如： 輸出[“1”， “2”， “3”]這個名為number的集合，可以用${number[0]}來輸出第一個數字。FreeMarker還支持用number[1..2]來表示原 集合的子集合[“2”， “3”]。

3. 輸出Map元素
對於JavaBean實例，FreeMarker一樣把它看作屬性為key，屬性值為value的Map對象。
輸出Map對象時，可以使用點語法或中括弧語法，如下麵的幾種寫法的效果是一樣的：
             book.author.name                                                                                                                         
             book.author["name"]                                                                                                                      
             book["author"].name                                                                                                                      
             book["author"]["name"]                                                                                                                   
使用點語法時，變數名字有和頂層變數一樣的限制，但中括弧語法沒有任何限制。