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

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

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

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

输出结果：

 <html>
 <head>
   <title>Welcome!</title>
 </head>
 <body>
   <h1>Welcome Big Joe!</h1>
   <p>Our latest product:
   <a href="products/greenmouse.html">green mouse</a>!
 </body>
 </html>

模版：

 <html>
 <head>
   <title>Welcome!</title>
 </head>
 <body>
   <h1>Welcome ${user}!</h1>
   <p>Our latest product:
   <a href="${latestProduct.url}">${latestProduct.name}</a>!
 </body>
 </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（而不是其他人）问好，就可以这样做：

 <html>
 <head>
   <title>Welcome!</title>
 </head>
 <body>
   <h1>
     Welcome ${user}<#if user == "Big Joe">, our beloved
 leader</#if>!
   </h1>
   <p>Our latest product:
   <a href="${latestProduct.url}">${latestProduct.name}</a>!
 </body>
 </html>

<#if animals.python.price == >
  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

 <hr>
 <i>
 Copyright (c) 2000 <a href="http://www.acmee.com">Acmee
 Inc</a>,
 <br>
 All Rights Reserved.
 </i>

any page which needs copyright_footer.html

 <html>
 <head>
   <title>Test page</title>
 </head>
 <body>
   <h1>Test page</h1>
   <p>Blah blah...
 <#include "/copyright_footer.html">
 </body>
 </html>

output

 <html>
 <head>
   <title>Test page</title>
 </head>
 <body>
   <h1>Test page</h1>
   <p>Blah blah...
 <hr>
 <i>
 Copyright (c) 2000 <a href="http://www.acmee.com">Acmee
 Inc</a>,
 <br>
 All Rights Reserved.
 </i>
 </body>
 </html>

联合使用指令

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

 <p>We have these animals:
 <table border=1>
   <tr><th>Name<th>Price
   <#list animals as being>
   <tr>
     <td>
       <#if being.size == "large"><font size="+1"></#if>
       ${being.name}
       <#if being.size == "large"></font></#if>
     <td>${being.price} Euros
   </#list>
 </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 模版开发指南第二章数值和类型
章节内容如下: 基本内容类型一.基本内容简介什么是数值? 什么是类型? 数据模型是哈希表 a.简介理解数值和类型的概念是理解数据模型的关键所在.然而,数值和类型的概念并不局限于数据模型, ...
Knockout应用开发指南第一章：入门
2011-11-21 14:20 by 汤姆大叔, 20165 阅读, 17 评论, 收藏, 编辑 1 Knockout简介 (Introduction) Knockout是一个轻量级的UI类 ...
三、FreeMarker 模版开发指南第三章模版
章节内容如下: 总体结构指令表达式插值一.总体结构实际上你用程序语言编写的程序就是模板,模板也被称为FTL(代表FreeMarker模板语言).这是为编写模板设计的非常简单的编程语言. ...
Knockout应用开发指南第二章：监控属性(Observables)
原文:Knockout应用开发指南第二章:监控属性(Observables) 关于Knockout的3个重要概念(Observables,DependentObservables,Observabl ...
.NET Core实战项目之CMS 第一章入门篇-开篇及总体规划
作者:依乐祝原文地址:https://www.cnblogs.com/yilezhu/p/9977862.html 写在前面千呼万唤始出来,首先,请允许我长吸一口气!真没想到一份来自28岁老程序员 ...
net core体系-web应用程序-4asp.net core2.0 项目实战（CMS）-第一章入门篇-开篇及总体规划
.NET Core实战项目之CMS 第一章入门篇-开篇及总体规划原文地址:https://www.cnblogs.com/yilezhu/p/9977862.html 写在前面千呼万唤始出来 ...
PADSPCB权威指南-第一章 PADS软件系统（部分）（原创）
PADSPCB权威指南-第一章(部分)豆丁地址:http://www.docin.com/p-707128286.html
Knockout应用开发指南第九章：高级应用举例
原文:Knockout应用开发指南第九章:高级应用举例 1 Contacts editor 这个例子和微软为演示jQuery Data Linking Proposal例子提供的例子一样的提供的 ...
[翻译]现代java开发指南第一部分
现代java开发指南第一部分第一部分:Java已不是你父亲那一代的样子第一部分,第二部分 =================== 与历史上任何其他的语言相比,这里要排除c语言和cobol语言,现 ...

随机推荐

Android 九宫格密码锁进入程序
设置九宫格密码锁进入程序,设置,重置,取消等,安卓巴士地址http://www.apkbus.com/forum.php?mod=viewthread&tid=182620&extra ...
SQL Server常见问题总结
写在前面在QQ群,微信群,论坛中经常帮助使用SQL Server数据库的朋友解决问题,但是有一些最常见最基本的问题,每天都有人问,回答多了也不想再解答了,索性把这些问题整理一下,再有人问到直接发链接 ...
jquery ui autoComplete自动完成
官网:http://jqueryui.com/autocomplete 最简单的形式: var availableTags = [ "ActionScript", "Ap ...
UVA 10041 Vito's Family (中位数)
Problem C: Vito's family Background The world-known gangster Vito Deadstone is moving to New York ...
WinAPI——Windows 消息
消息值注释 WM_NULL $0000 WM_CREATE $0001 WM_DESTROY $0002 WM_MOVE $0003 WM_SIZE $0005 WM_AC ...
POJ2528 线段树的区间操作
首先应该对该[0,10000000]进行离散化即先将点集进行排序,然后从小到大缩小其中的间距,使得最后点数不会超过2*n 然后就是线段树操作只需进行染色,然后最后用nlgn进行一个个查询颜色记录即 ...
chromium的部署工具depot_tools和gclient
depot_tools是个工具包,里面包含gclient.gcl.gn和ninja等工具.其中gclient是代码获取工具,它其实是利用了svn和git.主要涉及的depot_tools文件夹下的文件 ...
String的intern方法的用处
今天第一次翻看Effective java,在其第一个item中讲静态工厂方法的有点的时候说到“它们每次被调用的时候,不要非得创建一个新的对象”并在结尾处提到---"String.inte ...
POJ 2728 Desert King ★(01分数规划介绍 && 应用の最优比率生成树)
[题意]每条路径有一个 cost 和 dist,求图中 sigma(cost) / sigma(dist) 最小的生成树. 标准的最优比率生成树,楼教主当年开场随手1YES然后把别人带错方向的题Orz ...
ZEat
借助微博平台,记录每日饮食情况的Andorid程序. 项目地址:https://github.com/atskyline/ZEat 1.0.0APK下载地址:https://github.com/at ...

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

一、FreeMarker 模版开发指南 第一章 入门的更多相关文章

随机推荐

热门专题

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

一、FreeMarker 模版开发指南第一章入门的更多相关文章