FreeMarker设计指南(2)

最新推荐文章于 2020-11-21 06:53:48 发布

我行我速

最新推荐文章于 2020-11-21 06:53:48 发布

阅读量304

点赞数

分类专栏： Java

本文链接：https://blog.csdn.net/king201210/article/details/10445237

版权

Java 专栏收录该内容

54 篇文章 0 订阅

订阅专栏

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

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处理中使用，

3、模板

（1）整体结构

l 模板使用FTL（FreeMarker模板语言）编写，是下面各部分的一个组合：

Ø 文本：直接输出

Ø 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 但是，<、</和指令之间不允许有空白字符

阅读(751) | 评论(0) | 转发(0) |

上一篇：FreeMarker设计指南(1)

下一篇：FreeMarker设计指南(3)

FreeMarker设计指南(2)

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