Lola的空间

我们一直在努力....

FreeMarker的常用指令(一)

标签: FreeMarker 常用 指令
Lola用两期来介绍FreeMarker语法之表达式,今天lola也会分两期来介绍FreeMarker的常用指令。FreeMarkerFTL指令也是模板的重要组成部分,这些指令可实现对数据模型所包含数据的抚今迭代,分支控制.除此之外,还有一些重要的功能,也是通过FTL指令来实现的。

1. if指令

这是一个典型的分支控制指令,该指令的作用完全类似于Java语言中的if,if指令的语法格式如下:
<#if condition>...
<#elseif 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>
<#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:
	<table border=1>
	  <tr><th>Name<th>Price
	  <#list animals as being>
	  <tr><td>${being.name}<td>${being.price} Euros
	  </#list>
	</table>  
输出为:
	<p>We have these animals:
	<table border=1>
	  <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>
	  <title>Test page</title>
	</head>
	<body>
	  <h1>Test page</h1>
	  <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对象中.
  1. 创建库
Ø         下面是一个创建库的例子(假设保存在lib/my_test.ftl中):
	<#macro copyright date>
	  <p>Copyright (C) ${date} Julia Smith. All rights reserved.
	  <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}  
输出结果:
	  <p>Copyright (C) 1999-2002 Julia Smith. All rights reserved.
	  <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>
	  <p>Copyright (C) ${date} ${user}. All rights reserved.</p>
	</#macro>
	<#assign mail = "${user}@acme.com">   
l         假设数据模型中的user变量的值是Fred,则下面的代码:
	<#import "/lib/my_test.ftl" as my>
	<@my.copyright date="1999-2002"/>
	${my.mail}   
l         输出结果:
	  <p>Copyright (C) 1999-2002 Fred. All rights reserved.</p>
Fred@acme.com  


Lola介绍的FreeMarker的常用指令(一)是不是很实用啊,下期lola将会介绍更多有关FreeMarker的常用指令。

    评分: 请先登录再投票,同一篇博客一月只能投票一次!
    无人投票

相关博客:


评论


发表评论

最近访客
关注此文的人们还关注