FreeMarker設計指南(2)

2、資料模型

（1）基礎

在快速入門中介紹了在模板中使用的三種基本物件型別：scalars、hashes 和sequences，其實還可以有其它更多的能力：

Ø scalars：儲存單值

Ø hashes：充當其它物件的容器，每個都關聯一個唯一的查詢名字

Ø sequences：充當其它物件的容器，按次序訪問

Ø 方法：透過傳遞的引數進行計算，以新物件返回結果

Ø 使用者自定義FTL標記：宏和變換器

通常每個變數只具有上述的一種能力，但一個變數可以具有多個上述能力，如下面的例子：

(root) | +- mouse = "Yerri" | +- age = 12 | +- color = "brown"> mouse既是scalars又是hashes，將上面的資料模型合併到下面的模板：

${mouse}

Yerri12brown （2）Scalar變數

Scalar變數儲存單值，可以是：

Ø 字串：簡單文字，在模板中使用引號（單引號或雙引號）括起

Ø 數字：在模板中直接使用數字值

Ø 日期：儲存日期/時間相關的資料，可以是日期、時間或日期-時間（Timestamp）；通常情況，日期值由程式設計師加到資料模型中，設計者只需要顯示它們

Ø 布林值：true或false，通常在標記中使用

（3）hashes 、sequences和集合

有些變數不包含任何可顯示的內容，而是作為容器包含其它變數，者有兩種型別：

Ø hashes：具有一個唯一的查詢名字和它包含的每個變數相關聯

Ø sequences：使用數字和它包含的每個變數相關聯，索引值從0開始

集合變數通常類似sequences，除非無法訪問它的大小和不能使用索引來獲得它的子變數；集合可以看作只能由指令使用的受限sequences

（4）方法

方法變數通常是基於給出的引數計算值

下面的例子假設程式設計師已經將方法變數avg放到資料模型中，用來計算數字平均值：

The average of 3 and 5 is: ${avg(3, 5)}The average of 6 and 10 and 20 is: ${avg(6, 10, 20)}The average of the price of python and elephant is: ${avg(animals.python.price, animals.elephant.price)}（5）宏和變換器

宏和變換器變數是使用者自定義指令（自定義FTL標記），會在後面講述這些高階特性

（6）節點

節點變數表示為樹型結構中的一個節點，通常在XML處理中使用，會在後面的專門章節中講述

[@more@]