FreeMarker设计指南(2)

2、数据模型

1)基础

l         在快速入门中介绍了在模板中使用的三种基本对象类型:scalarshashes 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  
     
     

2Scalar变量

l         Scalar变量存储单值,可以是:

Ø         字符串:简单文本,在模板中使用引号(单引号或双引号)括起

Ø         数字:在模板中直接使用数字值

Ø         日期:存储日期/时间相关的数据,可以是日期、时间或日期-时间(Timestamp);通常情况,日期值由程序员加到数据模型中,设计者只需要显示它们

Ø         布尔值:truefalse,通常在<#if …>标记中使用

3hashes 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处理中使用,

 

 

 

3、模板

1)整体结构

l         模板使用FTLFreeMarker模板语言)编写,是下面各部分的一个组合:

Ø         文本:直接输出

Ø         Interpolation:由${},或#{}来限定,计算值替代输出

Ø         FTL标记:FreeMarker指令,和HTML标记类似,名字前加#予以区分,不会输出

Ø         注释:由<#---->限定,不会输出

l         下面是以一个具体模板例子:

<html>[BR]
      
      
<head>[BR]
      
      
  <title>Welcome!</title>[BR]
      
      
</head>[BR]
      
      
<body>[BR]
      
      
  <#-- Greet the user with his/her name -->[BR]
      
      
  <h1>Welcome ${user}!</h1>[BR]
      
      
  <p>We have these animals:[BR]
      
      
  <ul>[BR]
      
      
  <#list animals as being>[BR]
      
      
    <li>${being.name} for ${being.price} Euros[BR]
      
      
  </#list>[BR]
      
      
  </ul>[BR]
      
      
</body>[BR]
      
      
</html>  
      
      

l         [BR]是用于换行的特殊字符序列

l         注意事项:

Ø         FTL区分大小写,所以list是正确的FTL指令,而List不是;${name}${NAME}是不同的

Ø         Interpolation只能在文本中使用

Ø         FTL标记不能位于另一个FTL标记内部,例如:

<#if <#include 'foo'>='bar'>...</if>
      
      

Ø         注释可以位于FTL标记和Interpolation内部,如下面的例子:

<h1>Welcome ${user <#-- The name of user -->}!</h1>[BR]
      
      
<p>We have these animals:[BR]
      
      
<ul>[BR]
      
      
<#list <#-- some comment... --> animals as <#-- again... --> being>[BR]
      
      
...  
      
      

Ø         多余的空白字符会在模板输出时移除

2)指令

l         FreeMarker中,使用FTL标记引用指令

l         有三种FTL标记,这和HTML标记是类似的:

Ø         开始标记:<#directivename parameters>

Ø         结束标记:</#directivename>

Ø         空内容指令标记:<#directivename parameters/>

l         有两种类型的指令:预定义指令和用户定义指令

l         用户定义指令要使用@替换#,如<@mydirective>...</@mydirective>(会在后面讲述)

l         FTL标记不能够交叉,而应该正确的嵌套,如下面的代码是错误的:

<ul>
      
      
<#list animals as being>
      
      
  <li>${being.name} for ${being.price} Euros
      
      
  <#if use = "Big Joe">
      
      
     (except for you)
      
      
</#list>
      
      
</#if> <#-- WRONG! -->
      
      
</ul>  
      
      

l         如果使用不存在的指令,FreeMarker不会使用模板输出,而是产生一个错误消息

l         FreeMarker会忽略FTL标记中的空白字符,如下面的例子:

<#list[BR]
      
      
  animals       as[BR]
      
      
     being[BR]
      
      
>[BR]
      
      
${being.name} for ${being.price} Euros[BR]
      
      
</#list    >  
      
      

l         但是,<</和指令之间不允许有空白字符

<script type=text/javascript charset=utf-8 src="http://static.bshare.cn/b/buttonLite.js#style=-1&uuid=&pophcol=3&lang=zh"></script> <script type=text/javascript charset=utf-8 src="http://static.bshare.cn/b/bshareC0.js"></script>
阅读(751) | 评论(0) | 转发(0) |
给主人留下些什么吧!~~
评论热议
  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值