FreeMarker设计指南(2)

来源:百度文库 编辑:神马文学网 时间:2024/07/08 19:32:18
扬子江 发表于 2006-3-24 9:41:58
2、数据模型
(1)基础
l         在快速入门中介绍了在模板中使用的三种基本对象类型:scalars、hashes 和sequences,其实还可以有其它更多的能力:
Ø         scalars:存储单值
Ø         hashes:充当其它对象的容器,每个都关联一个唯一的查询名字
Ø         sequences:充当其它对象的容器,按次序访问
Ø         方法:通过传递的参数进行计算,以新对象返回结果
Ø         用户自定义FTL标记:宏和变换器
l         通常每个变量只具有上述的一种能力,但一个变量可以具有多个上述能力,如下面的例子:
(root) | +- mouse = "Yerri"      |      +- age = 12      |      +- color = "brown">
l         mouse既是scalars又是hashes,将上面的数据模型合并到下面的模板:
${mouse}       <#-- use mouse as scalar --> ${mouse.age}   <#-- use mouse as hash --> ${mouse.color} <#-- use mouse as hash -->
l         输出结果是:
Yerri 12 brown
(2)Scalar变量
l         Scalar变量存储单值,可以是:
Ø         字符串:简单文本,在模板中使用引号(单引号或双引号)括起
Ø         数字:在模板中直接使用数字值
Ø         日期:存储日期/时间相关的数据,可以是日期、时间或日期-时间(Timestamp);通常情况,日期值由程序员加到数据模型中,设计者只需要显示它们
Ø         布尔值:true或false,通常在<#if …>标记中使用
(3)hashes 、sequences和集合
l         有些变量不包含任何可显示的内容,而是作为容器包含其它变量,者有两种类型:
Ø         hashes:具有一个唯一的查询名字和它包含的每个变量相关联
Ø         sequences:使用数字和它包含的每个变量相关联,索引值从0开始
l         集合变量通常类似sequences,除非无法访问它的大小和不能使用索引来获得它的子变量;集合可以看作只能由<#list …>指令使用的受限sequences
(4)方法
l         方法变量通常是基于给出的参数计算值
l         下面的例子假设程序员已经将方法变量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)宏和变换器
l         宏和变换器变量是用户自定义指令(自定义FTL标记),会在后面讲述这些高级特性
(6)节点
l         节点变量表示为树型结构中的一个节点,通常在XML处理中使用,会在后面的专门章节中讲述