FreeMarker的常用指令

版权声明:本文为博主原创文章,未经博主允许不得转载 谢谢。 https://blog.csdn.net/Robust_An/article/details/52614614

1 FreeMarker的常用指令  
FreeMarker的FTL指令也是模板的重要组成部分,这些指令可实现对数据模型所包含数据的抚今迭代,分支控制.除此之外,还有一些重要的功能,也是通过FTL指令来实现的.
 
1.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会将>符号当成标签的结束字符,可能导致程序出错,为了避免这种情况,我们应该在凡是出现这些符号的地方都使用括号.  

1.2 switch , case , default , break指令  
这些指令显然是分支指令,作用类似于Java的switch语句,
switch指令的语法结构如下: 
<#switch value>  
  <#case refValue>...
  <#break> 
  <#case refValue>...
  <#break> 
  <#default>... 
</#switch>  

1.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>  

1.5 include指令  include指令的作用类似于JSP的包含指令,
用于包含指定页.include指令的语法格式如下: 
<#include filename [options]>  
在上面的语法格式中,两个参数的解释如下:
filename:该参数指定被包含的模板文件  options:该参数可以省略,指定包含时的选项,包含encoding和parse两个选项,其中encoding指定包含页面时所用的解码集,而parse指定被包含文件是否作为FTL文件来解析,如果省略了parse选项值,则该选项默认是true.

1.6 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}!"> 
上一篇:String变量为什么是不可变的?


下一篇:redis缓存的安装和使用