FreeMarker 設計指南 (二)：資料模型核心類型與方法

資料模型五大能力

模板可存取的變數具備下列一種或多種能力：

多重能力範例

(root)
|- mouse = "Yerri"   (Scalar)
|- mouse.age = 12    (Hash)
|- mouse.color = "brown"

模板：
${mouse}           <!-- Yerri -->
${mouse.age}       <!-- 12 -->
${mouse.color}     <!-- brown -->

Scalar 細分

• 字串：模板中用引號 "text"
• 數字：直接書寫 123, 3.14
• 日期：通常由程式放入模型，模板只負責顯示
• 布林：true/false，常用於 <#if>

Hash、Sequence 與 Collection

• Hash：鍵唯一，如 {name:"A", age:10}
• Sequence：有序、可索引、可取長度，如 ["a","b","c"]
• Collection：類似 Sequence 但無長度與索引，僅能用 <#list> 迭代

Method 範例

假設資料模型放入 avg 方法：

The average of 3 and 5 is: ${avg(3, 5)}
The average of 6,10,20 is: ${avg(6, 10, 20)}
${avg(animals.python.price, animals.elephant.price)}

節點變數

表示樹狀結構節點 (XML 處理常用)，後續專章說明。