freemarker 模板中定义变量

在模板中能够定义三种类型的变量:

• 简单变量:它能从模板中的不论什么位置来訪问,或者从使用 include 指令引入的模板訪问。

  能够使用 assign 或 macro 指令来创建或替换这些变量。

• 局部变量:它们仅仅能被设置在宏定义体内,并且仅仅在宏内可见。一个局部变量的生存周期仅仅是宏的调用过程。能够使用 local 指令在宏定义体内创建或替换局部变量。
• 循环变量:循环变量是由指令(如 list )自己主动创建的,并且它们仅仅在指令的開始和结束标记内有效。宏的參数是局部变量而不是循环变量。

演示样例:使用 assign 创建和替换变量

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

1
4

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

<#assign x = "plain">
1. ${x} <#-- 这里是普通变量 -->
<@test/>
6. ${x} <#-- 普通变量的值没有被改变 -->
<#list ["loop"] as x>
  7. ${x} <#-- 如今循环变量隐藏了普通变量 -->
  <#assign x = "plain2"> <#-- 替换普通变量, 隐藏在这里不起作用-->
  8. ${x} <#-- 它仍然隐藏普通变量 -->
</#list>
9. ${x} <#-- 普通变量的新值 -->

<#macro test>
  2. ${x} <#-- 这里我们仍然看到的是普通变量 -->
  <#local x = "local">
  3. ${x} <#-- 如今局部变量隐藏了它 -->
  <#list ["loop"] as x>
    4. ${x} <#-- 如今循环变量隐藏了局部变量 -->
  </#list>
  5. ${x} <#-- 如今又能够看到局部变量了 -->
</#macro>

1. plain
 2. plain
 3. local
  4. loop
 5. local
6. plain
 7. loop
 8. loop
9. plain2

注意到循环变量的设置是通过指令调用时创建的(本例中的 <list ...> 标签)。

没有其它的方式去改变循环变量的值(也就是说你不能使用定义指令来改变它的值。

)。

从上面的演示样例来看,虽然也能够使用一个循环变量来隐藏另外一个。



有时会发生一个变量隐藏数据模型中的同名变量,可是如果想訪问数据模型中的变量,就能够使用特殊变量 globals 。比如,如果我们在数据模型中有一个名为 user ,值为”BigJoe”的变量。

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