一、FreeMarker 模版开发指南第一章入门

所有资料来自南磊翻译的官方文档，我弄简单了，适合自己以后拿出来翻看。

章节内容如下：
　　简介
　　模板+数据模型=输出
　　数据模型一览
　　模板一览

一、模板 + 数据模型 = 输出

输出结果：

 1 <html> 
 2 <head> 
 3   <title>Welcome!</title> 
 4 </head> 
 5 <body> 
 6   <h1>Welcome Big Joe!</h1> 
 7   <p>Our latest product: 
 8   <a href="products/greenmouse.html">green mouse</a>! 
 9 </body> 
10 </html>

模版：

 1 <html> 
 2 <head> 
 3   <title>Welcome!</title> 
 4 </head> 
 5 <body> 
 6   <h1>Welcome ${user}!</h1> 
 7   <p>Our latest product: 
 8   <a href="${latestProduct.url}">${latestProduct.name}</a>! 
 9 </body> 
10 </html>

数据模型

(root) 
  | 
  +- user = "Big Joe" 
  | 
  +- latestProduct 
      | 
      +- url = "products/greenmouse.html" 
      | 
      +- name = "green mouse"

看上去是不是和servlet里面把数据装到 request和session里差不多，然后JSP里用表达式语言、脚本语言、或者标签来输出。

二、数据模型。

sequences序列是一种非常重要的变量，它们和哈希表变量相似，但是它们不存储所包含变量的名称，而是按顺序存储子变量。这样，就可以使用数字索引来访问这些子变量。在这种数据模型中，animal和whatnot.fruits就是序列。

(root) 
  | 
  +- animals 
  |   | 
  |   +- (1st) 
  |   |   | 
  |   |   +- name = "mouse" 
  |   |   | 
  |   |   +- size = "small" 
  |   |   | 
  |   |   +- price = 50 
  |   | 
  |   +- (2nd) 
  |   |   | 
  |   |   +- name = "elephant" 
  |   |   | 
  |   |   +- size = "large" 
  |   |   | 
  |   |   +- price = 5000 
  |   | 
  |   +- (3rd) 
  |       | 
  |       +- name = "python" 
  |       | 
  |       +- size = "medium" 
  |       | 
  |       +- price = 4999 
  | 
  +- whatnot 
      | 
      +- fruits 
          | 
          +- (1st) = "orange" 
          | 
          +- (2nd) = "banana"

hash哈希表。哈希表通过可查找的名称（例如：”animal”, ”mouse”, ”price”）来访问存储的其他变量（如子变量）。

scalars标量，仅存储单值的变量（size，price，text和because）。

如果要在模板中使用子变量，那应该从根root 开始指定它的路径，每级之间用点来分隔。要访问price和mouse的话，应该从根开始，先是animals，然后是mouse，最后是price，所以应该这样写：animals.mouse.price。当放置${…}这种特定代码在表达式前后时，我们就告诉FreeMarker在那个位置上要来输出对应的文本。

(root) 
  | 
  +- animals 
  |   | 
  |   +- mouse 
  |   |   |    
  |   |   +- size = "small" 
  |   |   |    
  |   |   +- price = 50 
  |   | 
  |   +- elephant 
  |   |   |    
  |   |   +- size = "large" 
  |   |   |    
  |   |   +- price = 5000 
  |   | 
  |   +- python 
  |       |    
  |       +- size = "medium" 
  |       |    
  |       +- price = 4999 
  | 
  +- test = "It is a test" 
  | 
  +- whatnot 
      | 
      +- because = "don't know"

标量类型：字符串，数字，日期/时间，布尔值。

总结：
数据模型可以被看做是树状结构。
标量存储单一的值，这种类型的值可以是字符串，数字，日期/时间或者是布尔值。
哈希表是存储变量和与其相关且有唯一标识名称变量的容器。
序列是存储有序变量的容器。存储的变量可以通过数字索引来检索，索引通常从零开始。

三、模版

a、简介

　　${…}：FreeMarker 将会输出真实的值来替换花括号内的表达式，这样被称为interpolations 插值。

　　FTL tags标签（FreeMarker 模板的语言标签）：FTL标签和HTML标签有一点相似，但是它们是FreeMarker 的指令而且是不会直接输出出来的东西。这些标签的使用一般以符号#开头。（用户自定义的FTL标签使用@符号来代替#，以后讨论）

　　Comments注释：FreeMarker的注释和HTML的注释相似，但是它用<#--和-->来分隔。任何介于这两个分隔符（包含分隔符本身）之间内容会被FreeMarker 忽略，就不会输出出来了。

　　其他任何不是FT L 标签，插值或注释的内容将被视为静态文本，这些东西就不会被FreeMarker所解析，会被按照原样输出出来。

　　directives 指令就是所指的FTL 标签。这些指令在HTML的标签（如<table>和</table>）元素（如table元素）中的关系是相同的。（如果现在你还不能区分它们，把“FTL标签”和“指令”看做是同义词即可。）

b、指令示例

if 指令 <#if condition> [ content ] </#if>

使用if 指令可以有条件地跳过模板的一部分，这和程序语言中if 是相似的。假设在第一个示例中，你只想向你的老板Big Joe（而不是其他人）问好，就可以这样做：

 1 <html> 
 2 <head> 
 3   <title>Welcome!</title> 
 4 </head> 
 5 <body> 
 6   <h1> 
 7     Welcome ${user}<#if user == "Big Joe">, our beloved 
 8 leader</#if>! 
 9   </h1> 
10   <p>Our latest product: 
11   <a href="${latestProduct.url}">${latestProduct.name}</a>! 
12 </body> 
13 </html>

<#if animals.python.price == 0> 
  Pythons are free today! 
</#if>

<#if animals.python.price < animals.elephant.price> 
  Pythons are cheaper than elephants today. 
<#else> 
  Pythons are not cheaper than elephants today. 
</#if>

list 指令　　<#list sequence as loopVariable>repeatThis</#list>

<p>And BTW we have these fruits: 
<ul> 
<#list whatnot.fruits as fruit> 
 <li>${fruit} </li>
</#list> 
<ul>

include 指令

使用include指令，我们可以插入其他文件的内容到当前的模板中。

copyright_footer.html

1 <hr> 
2 <i> 
3 Copyright (c) 2000 <a href="http://www.acmee.com">Acmee 
4 Inc</a>, 
5 <br> 
6 All Rights Reserved. 
7 </i>

any page which needs copyright_footer.html

 1 <html> 
 2 <head> 
 3   <title>Test page</title> 
 4 </head> 
 5 <body> 
 6   <h1>Test page</h1> 
 7   <p>Blah blah... 
 8 <#include "/copyright_footer.html"> 
 9 </body> 
10 </html>

output

 1 <html> 
 2 <head> 
 3   <title>Test page</title> 
 4 </head> 
 5 <body> 
 6   <h1>Test page</h1> 
 7   <p>Blah blah... 
 8 <hr> 
 9 <i> 
10 Copyright (c) 2000 <a href="http://www.acmee.com">Acmee 
11 Inc</a>, 
12 <br> 
13 All Rights Reserved. 
14 </i> 
15 </body> 
16 </html>

联合使用指令

在页面也可以多次使用指令，而且指令间可以相互嵌套，正如在HTML元素中嵌套使用标签一样。下面的代码会遍历动物，用大号字体来打印大型动物的名字。

 1 <p>We have these animals: 
 2 <table border=1> 
 3   <tr><th>Name<th>Price 
 4   <#list animals as being> 
 5   <tr> 
 6     <td> 
 7       <#if being.size == "large"><font size="+1"></#if> 
 8       ${being.name} 
 9       <#if being.size == "large"></font></#if> 
10     <td>${being.price} Euros 
11   </#list> 
12 </table>

处理不存在的变量

当user从数据模型中丢失时，模板将会将user’S 的值表现为字符串”Anonymous”。（若 user并没有丢失，那么模板就表现出”Anonymous”不存在一样）：

<h1>Welcome ${user!"Anonymous"}!</h1>

当然也可以通过放置??在变量名后面来询问FreeMarker一个变量是否存在。将它和if指令合并，那么如果user变量不存在的话将会忽略整个问候代码段：

<#if user??><h1>Welcome ${user}!</h1></#if>

关于多级访问的变量，比如animals.python.price，书写代码：animals.python.price!0，仅当animals.python存在而仅仅最后一个子变量price可能不存在（这种情况下我们假设价格是0）。如果animals或者python不存在，那么模板处理将会以“未定义的变量”错误停止。为了防止这种情况的发生，可以这样来书写代码(animals.python.price)!0。这种情况下当animals 或python不存在时表达式的结果仍然是0。对于??也是同样用来的处理这种逻辑的：animals.python.price??对比(animals.python.price)??

一、FreeMarker 模版开发指南 第一章 入门

一、FreeMarker 模版开发指南第一章入门