freemarker中文手册

1、快速入门

（1）模板 + 数据模型 = 输出

 FreeMarker 基于设计者和程序员是具有不同专业技能的不同个体的观念

 他们是分工劳动的：设计者专注于表示——创建 HTML 文件、图片、Web 页面的其它可

视化方面；程序员创建系统，生成设计页面要显示的数据

 经常会遇到的问题是：在 Web 页面（或其它类型的文档）中显示的信息在设计页面时是

无效的，是基于动态数据的

 在这里，你可以在 HTML（或其它要输出的文本）中加入一些特定指令，FreeMarker 会







 !latestProduct.name



"

 这个例子是在简单的 HTML 中加入了一些由${…}包围的特定代码，这些特定代码是

FreeMarker 的指令，而包含 FreeMarker 的指令的文件就称为模板（Template）

 至于 user、latestProduct.url 和 latestProduct.name 来自于数据模型（data model）

 数据模型由程序员编程来创建，向模板提供变化的信息，这些信息来自于数据库、文件 ，

%

&' 

%

&')+!

%

&'+)+



数据模型类似于计算机的文件系统，latestProduct 可以看作是目录，而 user、url 和 name

看作是文件，url 和 name 文件位于 latestProduct 目录中（这只是一个比喻，实际并不存

在）

 当 FreeMarker 将上面的数据模型合并到模板中，就创建了下面的输出：



)+!)+



"

（2）数据模型

 典型的数据模型是树型结构，可以任意复杂和深层次，如下面的例子：

#$

%

&'+

%%

%&'+

%%%

%%&',)

%%%

%%&'-...

%%

%&'+

%%

%&',

%%

&'+34+2

 类似于目录的变量称为 hashes，包含保存下级变量的唯一的查询名字

 类似于文件的变量称为 scalars，保存单值

 scalars 保存的值有两种类型：字符串（用引号括起，可以是单引号或双引号）和数字

（不要用引号将数字括起，这会作为字符串处理）

 对 scalars 的访问从 root 开始，各部分用“.5分隔，如 animals.mouse.price

 另外一种变量是 sequences，和 hashes 类似，只是不使用变量名字，而使用数字索引，

如下面的例子：

#$

%

&'+

%&'#$

%%%

%%&'+

%%%

%%&',

%%%

%%&',)

%%%

%%&'-...

%%

%&'#7$

%%

%&'++

%%

%&',

%%

&'#$+)

%

&'#6+$++

 这种对 scalars 的访问使用索引，如 animals[0].name

（3）模板

 在 FreeMarker 模板中可以包括下面三种特定部分：

 ${…}：称为 interpolations，FreeMarker 会在输出时用实际值进行替代

 FTL 标记（FreeMarker 模板语言标记）：类似于 HTML 标记，为了与 HTML 标记区

分，用#开始（有些以@开始，在后面叙述）

 注释：包含在<#--和-->（而不是<!--和-->）之间

 下面是一些使用指令的例子：

 if 指令

8+!+!+!+!

 +++!

8

 ++++!

+)!++)!;

8

输出为：

9+



: 

-.;

+-...;

+/000;

"

