freemarker的变量可以分为四种,分别是数据模型的变量【root中的变量】,模板中的变量使用【<#assign>定义的变量】,局部变量【在指令中的变量】,循环变量【在循环中的变量】

数据模型的变量【root中的变量】
直接从模型中给模板传值的变量就是数据模型的变量,它把变量的值放在一个map中,在模板中直接可以用。

@Test 

public void test10() { 

 root.put("username","张三"); 

 fu.print("10.ftl",root); 

} 

${username} 

张三



模板中的变量使用【<#assign>定义的变量】
模板中的变量,是使用<#assign定义的变量,如果模板中定义的变量和模型中的变量名称一致,不是覆盖,而是隐藏

<#assign username="李四"> 

<#--此时模板中的变量的名称和模型中的变量名称一致,不是覆盖,而是隐藏--> 

${username} 

李四 

模型中的变量被隐藏后,可以使用.globals可以访问模型中的变量 

<#--使用.globals可以访问模型中的变量--> 

${.globals.username}


张三

局部变量【在指令中的变量】
使用local可以声明局部变量

<#macro test> 

 <#-- 

 此时当调用该指令之后,会将模板中的变量username覆盖为王五 

 所以这种方式存在风险,所以一般不使用这种方式在指令中定义变量 

 --> 

 <#--<#assign username="王五"/>--> 

 <#--使用local可以声明局部变量,所以在marco中非特殊使用局部变量--> 

 <#local username="王五"/> 

 ${username} 

</#macro> 

<@test/> 

${username} 

 王五 

李四



循环变量【在循环中的变量】
在list循环中定义的变量,循环中的变量只在循环中有效,也是一种临时的变量定义方式

<#list 1..3 as username> 

 <#--循环中的变量出了循环就消失--> 

 ${username} 

</#list> 

${username} 

 1 

 2 

 3 

李四



本文链接:FreeMarker四种变量的用法,本文由huangyineng原创,转载请注明出处

assign
assign指令在前面已经使用了多次,它用于为该模板页面创建或替换一个顶层变量,
assign指令的用法有多种,包含创建或替换一个顶层变量,或者创建或替换多个变量等,
它的最简单的语法如下:
<#assign name=value [in namespacehash]>,
这个用法用于指定一个名为name的变量,该变量的值为value,
此外,FreeMarker允许在使用assign指令里增加in子句,
in子句用于将创建的name变量放入namespacehash命名空间中.

assign指令还有如下用法:
<#assign name1=value1 name2=value2 ... nameN=valueN [in namespacehash]>,
这个语法可以同时创建或替换多个顶层变量,此外,还有一种复杂的用法,
如果需要创建或替换的变量值是一个复杂的表达式,
则可以使用如下语法格式:

<#assign name [in namespacehash]>capture this</#assign>,


在这个语法中,是指将assign指令的内容赋值给name变量.如下例子:

<#assign x> 

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

 ${n} 

 </#list> 

 </#assign> 

 ${x}


上面的代码将产生如下输出:
星期一 星期二 星期三 星期四 星期五 星期六 星期天
虽然assign指定了这种复杂变量值的用法,但是我们也不要滥用这种用法,
如下例子:

<#assign x>Hello ${user}!</#assign>,


以上代码改为如下写法更合适:

<#assign x="Hello ${user}!"> 


===============================================================



解释:global、assign、local(macro参数)、list(由list创建的循环变量如:<#list a as x>)关系
global 全局变量,在所有命名空间可见
assign 当前命名空间可见
local(macro参数) 局部变量,当前宏内可见

循环变量(<#list a as x>) 当前循环可见
他们之间的关系 循环变量会隐藏局部变量(local创建的或macro参数)
局部变量(local创建的或macro参数)会隐藏assign(创建的变量)
assign(创建的变量)会隐藏global