FreeMarker的常用指令1

来源：互联网发布：面向对象程序设计java 编辑：程序博客网时间：2024/06/11 01:54

FreeMarker的FTL指令也是模板的重要组成部分,这些指令可实现对数据模型所包含数据的抚今迭代,分支控制.除此之外,还有一些重要的功能,也是通过FTL指令来实现的。

1. if指令

这是一个典型的分支控制指令,该指令的作用完全类似于Java语言中的if,if指令的语法格式如下:

<#if condition>...

<#elseif condition>...

<#else> ...

</#if>

例子如下:

<#assign age=23>

<#if (age>60)>老年人

<#elseif (age>40)>中年人

<#elseif (age>20)>青年人

<#else> 少年人

</#if>

输出结果是:青年人

上面的代码中的逻辑表达式用括号括起来主要是因为里面有>符号,由于FreeMarker会将>符号当成标签的结束字符,可能导致程序出错,为了避免这种情况,我们应该在凡是出现这些符号的地方都使用括号.

<#if animals.python.price < animals.elephant.price>

Pythons are cheaper than elephants today.

<#else>

Pythons are not cheaper than elephants today.

</#if>

2、 switch , case , default , break指令

这些指令显然是分支指令,作用类似于Java的switch语句,switch指令的语法结构如下:

<#switch value>

<#case refValue>...<#break>

<#default>...

</#switch>

3、 list, break指令

list指令是一个迭代输出指令,用于迭代输出数据模型中的集合,list指令的语法格式如下:

<#list sequence as item>

...

</#list>

上面的语法格式中,sequence就是一个集合对象,也可以是一个表达式,但该表达式将返回一个集合对象,而item是一个任意的名字,就是被迭代输出的集合元素.此外,迭代集合对象时,还包含两个特殊的循环变量:

item_index:当前变量的索引值

item_has_next:是否存在下一个对象

也可以使用<#break>指令跳出迭代

例子如下:

<#list ["星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期天"] as x>

${x_index + 1}.${x}<#if x_has_next>,</if>

<#if x="星期四"><#break></#if>

</#list>

<p>We have these animals:

<tr><th>Name<th>Price

<#list animals as being>

<tr><td>${being.name}<td>${being.price} Euros

</#list>

</table>

输出为：

<p>We have these animals:

<tr><th>Name<th>Price

<tr><td>mouse<td>50 Euros

<tr><td>elephant<td>5000 Euros

<tr><td>python<td>4999 Euros

</table>

4、include指令

include指令的作用类似于JSP的包含指令,用于包含指定页.include指令的语法格式如下:

<#include filename [options]>

在上面的语法格式中,两个参数的解释如下:

filename:该参数指定被包含的模板文件

options:该参数可以省略,指定包含时的选项,包含encoding和parse两个选项,其中encoding指定包含页面时所用的解码集,而parse指定被包含文件是否作为FTL文件来解析,如果省略了parse选项值,则该选项默认是true.

<html>

<head>

</head>

<body>

<p>Blah blah...

<#include "/copyright_footer.html">

</body>

</html>

5、 import指令

该指令用于导入FreeMarker模板中的所有变量,并将该变量放置在指定的Map对象中,import指令的语法格式如下:

<#import "/lib/common.ftl" as com>

上面的代码将导入/lib/common.ftl模板文件中的所有变量,将这些变量放置在一个名为com的Map对象中.

创建库

? 下面是一个创建库的例子（假设保存在lib/my_test.ftl中）：

<#macro copyright date>

<br>Email: ${mail}</p>

</#macro>

<#assign mail = "jsmith@acme.com">

? 使用import指令导入库到模板中，Freemarker会为导入的库创建新的名字空间，并可以通过import指令中指定的散列变量访问库中的变量：

<#import "/lib/my_test.ftl" as my>

<#assign mail="fred@acme.com">

<@my.copyrightdate="1999-2002"/>

${my.mail}

${mail}

输出结果：

<br>Email: jsmith@acme.com</p>

jsmith@acme.com

fred@acme.com

可以看到例子中使用的两个同名变量并没有冲突，因为它们位于不同的名字空间

l 可以使用assign指令在导入的名字空间中创建或替代变量，下面是一个例子：

<#import "/lib/my_test.ftl" as my>

${my.mail}

<#assign mail="jsmith@other.com" in my>

${my.mail}

l 输出结果：

jsmith@acme.com

jsmith@other.com

l 数据模型中的变量任何地方都可见，也包括不同的名字空间，下面是修改的库：

<#macro copyright date>

</#macro>

<#assign mail = "${user}@acme.com">

l 假设数据模型中的user变量的值是Fred，则下面的代码：

<#import "/lib/my_test.ftl" as my>

${my.mail}

l 输出结果：

Fred@acme.com