freemarker之模板开发(其它之在模板中定义变量)

----------

模板可以使用在数据模型中定义的变量。在数据模型之外,模板本身也可以定义变量来使用。这些临时变量可以适应FTL指令来创建和替换。要注意每一次模板执行时都维护它自己的这些变量的私有设置,这些变量是在页面用以呈现信息的。变量的初始值是空,当模板执行结束这些变量便被销毁了。

你可以访问一个在模板里定义的变量,就像是访问数据模型根上的变量一样。这个变量比定义在数据模型中的同名参数有更高的优先级。那就是说,如果你恰巧定义了一个名为"foo"的变量,而在数据模型中也有一个名为"foo"的变量,那么模板中的变量就会将数据模型根上的变量隐藏(而不是覆盖!)。

在模板中可以定义三种类型的变量:

1.简单变量:它能从模板中的任何位置来访问,或者从使用include指令引入的模板访问。可以使用assign或macro指令来创建或替换这些变量。

2.局部变量:它们只能被设置在宏定义体内,而且只在宏内可见。一个局部变量的生存周期只是宏的调用过程。可以使用local指令在宏定义体内创建或替换局部变量。

3.循环变量:循环变量是由指令(如:list)自动创建的,而且它们只在指令的开始和结束标记内有效。宏的参数是局部变量而不是循环变量。

示例,使用assign创建和替换变量

<#assign x=1> <#-- 创建变量x -->
${x}
<#assign x = x+3> <#-- 替换变量x -->
${x}

注意:局部变量也会隐藏(不是覆盖)同名的简单变量。循环变量也会隐藏(不是覆盖)同名的局部变量和简单变量。

 

例: 

<#assign x="plain">
${x}	<#-- 这里是普通变量 -->
<#list ['loop'] as x>
	${x}	<#-- 现在循环变量隐藏了普通变量 -->
	<#assign x = "plain2">	<#--替换普通变量,隐藏在这里不起作用 -->
	${x}	<#--它仍然隐藏普通变量 -->
</#list>
${x}		<#-- 普通变量的新值 -->
<#macro test>
	${x}	<#-- 这里我们仍然看到的是普通变量 -->
	<#local x = "local">
	${x}	<#-- 现在局部变量隐藏了它 -->
	<#list ["loop"] as x>
		${x}	<#-- 现在循环变量隐藏了局部变量 -->
	</#list>
	${x}	<#-- 现在又可以看到局部变量了 -->
</#macro>

 

注意:内部循环变量可以隐藏外部循环变量。

如例:

<#list["loop 1"] as x>
	${x}
	<#list ["loop 2"] as x>
		${x}
		<#list ["loop 3"] as x>
			${x}
		</#list>
	</#list>
</#list>

 

有时会发生一个变量隐藏数据模型中的同名变量,但是如果想访问数据模型中的变量,就可以使用特殊变量globals。如例,假设我们在数据模型中有一个名为user,值为"Big Joe"的变量。

<#assign user = "Joe Hider">
${user}		<#-- 打印:Joe Hider -->
${.globals.user}	<#-- 打印:Big Joe -->