FTL入门

一、概念

FreeMarker 是一款 模板引擎： 即一种基于模板和要改变的数据， 并用来生成输出文本(HTML网页，电子邮件，配置文件，源代码等)的通用工具。 它不是面向最终用户的，而是一个Java类库，是一款程序员可以嵌入他们所开发产品的组件。

模板编写为FreeMarker Template Language (FTL)。它是简单的，专用的语言， 不是 像PHP那样成熟的编程语言。 那就意味着要准备数据在真实编程语言中来显示，比如数据库查询和业务运算， 之后模板显示已经准备好的数据。在模板中，你可以专注于如何展现数据， 而在模板之外可以专注于要展示什么数据。

这种方式通常被称为 MVC (模型 视图 控制器) 模式，对于动态网页来说，是一种特别流行的模式。 它帮助从开发人员(Java 程序员)中分离出网页设计师(HTML设计师)。设计师无需面对模板中的复杂逻辑， 在没有程序员来修改或重新编译代码时，也可以修改页面的样式。

而FreeMarker最初的设计，是被用来在MVC模式的Web开发框架中生成HTML页面的，它没有被绑定到 Servlet或HTML或任意Web相关的东西上。它也可以用于非Web应用环境中。

FreeMarker 是免费的， 基于Apache许可证2.0版本发布。

二、基本语法

1.语法概述

1.1. ${…}：

FreeMarker将会输出真实的值来替换大括号内的表达式，这样的表达式被称为interpolation（插值）。

1.2.注释：

注释和HTML的注释也很相似，但是它们使用<#-- and -->来标识。不像HTML注释那样，FTL注释不会出现在输出中（不出现在访问者的页面中），因为FreeMarker会跳过它们。

1.3.FTL标签（FreeMarker模板的语言标签）：

FTL标签和HTML标签有一些相似之处，但是它们是FreeMarker的指令，是不会在输出中打印的。这些标签的名字以#开头。（用户自定义的FTL标签则需要使用@来代替#）

2.指令详解

2.1.if else

<#if condition>
…
<#elseif condition2>
…
<#elseif condition3>
…
<#else>
…
</#if>

if、elseif和else指令可以用来条件判断是否越过模板的一个部分。
condition必须计算成布尔值，否则错误将会中止模板处理。
elseif和else必须出现在if内部（也就是在if的开始标签和结束标签之间）。
if中可以包含任意数量的elseif（包括0个），而结束时else也是可选的。

2.2.list

假设 users 包含[‘Joe’, ‘Kate’, ‘Fred’] 序列：

<#list users as user>
${user}
</#list>

输出：

Joe

Kate

Fred
list指令执行在list开始标签和list结束标签（list中间的部分）之间的代码，对于在序列（或集合）中每个值指定为它的第一个参数。
对于每次迭代，循环变量将会存储当前项的值。循环变量仅仅存在于list标签体内。
而且从循环中调用的宏/函数不会看到它（就像它只是局部变量一样）。
<#list>与<#else>、<#sep>组合是可选的，而且仅从FreeMarker 2.3.23版本开始支持。

2.3.include

将版权信息单独存放在页面文件 copyright_footer.html 中：

Copyright © 2000 Baidu Inc,
All Rights Reserved.

当需要用到这个文件时，可以使用 include 指令来插入：

Blah blah... <#include "/copyright_footer.html">

include可以在模板中插入另外一个FreeMarker模板文件（由路径参数指定)。 被包含模板的输出格式是在include标签出现的位置插入的。被包含的文件和包含它的模板共享变量，就像是被复制粘贴进去的一样。 include指令不能由被包含文件的内容所替代，它只是当FreeMarker每次在模板处理期间到达include指令时处理被包含的文件。 所以对于如果include在list循环之中的例子，可以为每个循环周期内指定不同的文件名。

3.内建函数

内建函数很像子变量（也像Java中的方法），它们并不是数据模型中的东西，是FreeMarker在数值上添加的。
为了清晰子变量是哪部分，使用?（问号）代替，.（点）来访问它们。

常用内建函数的示例：

user?html给出user的HTML转义版本，比如&会由&来代替。
user?upper_case给出user值的大写版本（比如“JOHN DOE”来替代“John Doe”）
animal.name?cap_first给出animal.name的首字母大写版本（比如“Mouse”来替代“mouse”）
user?length给出user值中字符的数量（对于“John Doe”来说就是8）
animals?size给出animals序列中项目的个数
如果在<#list animals as animal>和对应的</#list>标签中：
animal?index给出了在animals中基于0开始的animal的索引值
animal?counter也像index，但是给出的是基于1的索引值
animal?item_parity基于当前计数的奇偶性，给出字符串“odd”或“even”。

一些内建函数需要参数来指定行为，比如：

animal.protected?string(“Y”, “N”)基于animal.protected的布尔值来返回字符串“Y”或“N”。
animal?item_cycle(‘lightRow’,‘darkRow’)是item_parity更为常用的变体形式。
fruits?join(", ")通过连接所有项，将列表转换为字符串，在每个项之间插入参数分隔符（比如“orange,banana”）
user?starts_with(“J”)根据user的首字母是否是“J”返回布尔值true或false。

内建函数应用可以链式操作，比如user?upper_case?html会先转换用户名到大写形式，之后再进行HTML转义，和链式使用.（点）一样。

4.空变量

数据模型中经常会有可选的变量（有时并不存在）。
除了一些人为原因导致失误外，FreeMarker不能引用不存在的变量，除非明确地告诉它当变量不存在时如何处理。

如下两种典型的处理方法：
这部分对程序员而言：一个不存在的变量和一个是null值的变量，对于FreeMarker来说是一样的，所以这里所指的“丢失”包含这两种情况。
不论在哪里引用变量，都可以指定一个默认值来避免变量丢失这种情况，通过在变量名后面跟着一个 !（感叹号）和默认值。

像下面的这个例子，当user不存在于数据模型时，模板将会将user的值表示为字符串 “visitor”。（当 user 存在时，模板就会表现出 ${user} 的值）：

Welcome ${user!"visitor"}!

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

<#if user??>
Welcome ${user}!
</#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)??来看。

可以如下这样来编写代码 (animals.python.price)!0。这种情况就是说animals或python不存在时，表达式的结果是 0。对于??也是同样用来的处理这种逻辑的；将animals.python.price??对比(animals.python.price)??来看。

最后

以上就是发嗲招牌为你收集整理的FTL入门FTL入门的全部内容，希望文章能够帮你解决FTL入门FTL入门所遇到的程序开发问题。

如果觉得靠谱客网站的内容还不错，欢迎将靠谱客网站推荐给程序员好友。