`
wb284551926
  • 浏览: 551377 次
文章分类
社区版块
存档分类
最新评论

freemarker学习笔记(转载)

阅读更多
在模板中定义的变量有三种类型:
引用
1:plain变量:可以在模板的任何地方访问,包括使用include指令插入的模板,使用assign指令创建和替换。
2:局部变量:在宏定义体中有效,使用local指令创建和替换。
3:循环变量:只能存在于指令的嵌套内容,由指令(如list)自动创建;宏的参数是局部变量,而不是循环变量

局部变量隐藏(而不是覆盖)同名的plain变量;循环变量隐藏同名的局部变量和plain变量
Ftl代码  收藏代码
  1. <#assign x = "plain">    
  2. 1. ${x} <br>  
  3. 宏开始<br>  
  4. <@test/>  
  5. 宏结束<br>  
  6. 6. ${x}  <br>    
  7.     
  8. <#list ["loop"] as x>    
  9.     7. ${x}  <br>  
  10.     <#assign x = "plain2">  <#-- replace the plain var -->    
  11.     8*. ${x}  <br> <#-- it still hides the plain var. -->    
  12. </#list>    
  13.     
  14. 9*. ${x} <br>    
  15.     
  16. <#macro test>    
  17.     2. ${x}  <br>    
  18.     <#local x = "local">    
  19.     3. ${x}  <br>  
  20.   
  21.     <#list ["loop"] as x>    
  22.     4. ${x}  <br>    
  23.     </#list>    
  24.     5. ${x} <br>    
  25. </#macro>     




模板中的变量会隐藏(而不是覆盖)数据模型中同名变量,如果需要访问数据模型中的同名变量,使用特殊变量global,下面的例子假设数据模型中的user的值是Big Joe:
<#assign user = "Joe Hider">
${user}          <#-- prints: Joe Hider -->
${.globals.user} <#-- prints: Big Joe -->


一.输出

1:判断list记录大于2
Ftl代码  收藏代码
  1. <#if (data?size>2)>  
  2.     size 大于 2  
  3. <#else>  
  4.     size 小于 2  
  5. </#if>  


2:插入布尔值:
Ftl代码  收藏代码
  1. <#assign foo=false />  
  2. ${foo?string("yes","no")}  


3:默认值:
Ftl代码  收藏代码
  1. <#--<#assign name="liuwentao" />-->  
  2. ${name?default('xxx')}  

或者
Ftl代码  收藏代码
  1. <#--<#assign name="liuwentao" />-->  
  2. ${name!"xxx"}  


4:if_exists :
Ftl代码  收藏代码
  1. <#assign name="liuwentao" />  
  2. ${name?if_exists }  


5:日期格式:
Ftl代码  收藏代码
  1. ${current?string('yyyy-MM-dd HH:mm:ss E')}  


6:数字格式:
Ftl代码  收藏代码
  1. <#setting number_format="#">  
  2. ${data.num}<br>  
  3. ${data.num?string.number}<br>  
  4. ${data.num?string.currency}<br>  
  5. ${data.num?string.percent}<br>  




二.逻辑判断

1:if .. elseif .. else :
Ftl代码  收藏代码
  1. <#assign name="刘文涛" />  
  2.   
  3. <#if !name??>  
  4.     name这个变量不存在  
  5. <#elseif name="liuwentao">  
  6.     name的名字等于 liuwentao  
  7. <#elseif name="刘文涛">  
  8.     name的名字等于 刘文涛  
  9. <#else>  
  10.     name的名字等于 ${name}  
  11. </#if>  

空值判断可以写成<#if name??>

2:switch .. case .. default .. :
Ftl代码  收藏代码
  1. <#assign name="刘文涛" />  
  2.   
  3. <#switch name>  
  4.     <#case "liuwentao">  
  5.         name的名字等于 liuwentao  
  6.         <#break>  
  7.     <#case "刘文涛">  
  8.         name的名字等于 刘文涛  
  9.         <#break>  
  10.     <#default>  
  11.         name的名字等于 ${name}  
  12. </#switch>  


三.循环

1:list :
Ftl代码  收藏代码
  1. <#assign topics=data.list2 />  
  2.   
  3. <#list topics as topic>  
  4.     ${topic_index}. ${topic.title2} <br>  
  5. </#list>  


四. Macro(宏)

1:基本用法 :
宏是和某个变量关联的模板片断,以便在模板中通过用户定义指令使用该变量

1.1:定义宏
Ftl代码  收藏代码
  1. <#macro greet>  
  2.     <font size="+2">Hello Joe!</font>  
  3. </#macro>  


1.2:调用宏
Ftl代码  收藏代码
  1. <@greet></@greet>  

或者
Ftl代码  收藏代码
  1. <@greet/>  

调用宏时,与使用FreeMarker的其他指令类似, 只是使用@替代FTL标记中的#

2:带参数的宏
宏的参数是局部变量,只能在宏定义中有效

2.1:带一个参数的宏
Ftl代码  收藏代码
  1. <#macro greet person>  
  2.     <font size="+2">Hello ${person}!</font>  
  3. </#macro>  
  4.   
  5. <@greet person="刘文涛"/>  


2.2:带多个参数的宏
Ftl代码  收藏代码
  1. <#macro greet person color>  
  2.     <font size="+2" color="${color}">Hello ${person}!</font>  
  3. </#macro>  
  4.   
  5. <@greet person="刘文涛" color="blue"/>  


2.3: 带参数缺省值的宏
Ftl代码  收藏代码
  1. <#macro greet person color="blue">  
  2.     <font size="+2" color="${color}">Hello ${person}!</font>  
  3. </#macro>  
  4. <@greet person="刘文涛" color="yellow"/>  <br>  
  5. <@greet person="刘文涛"/>   




3:在宏里嵌套内容

3.1:<#nested> 指令
Ftl代码  收藏代码
  1. <#macro table>  
  2. <table border=4 cellspacing=0 cellpadding=4>  
  3.     <tr>  
  4.         <td>第一次使用:<#nested></td>  
  5.     </tr>  
  6.     <tr>  
  7.         <td>第二次使用:<#nested></td>  
  8.     </tr>  
  9. </table>  
  10. </#macro>  
  11.   
  12. <@table>这些内容显示在哪里...</@table>  




3.2:嵌套内容可以是有效的FTL
Ftl代码  收藏代码
  1. <#macro greet person color="blue">  
  2.     <font size="+2" color="${color}">Hello ${person}!</font>  
  3. </#macro>  
  4.   
  5. <#macro table>  
  6. <table border=4 cellspacing=0 cellpadding=4>  
  7.     <tr>  
  8.         <td>第一次使用:<#nested></td>  
  9.     </tr>  
  10.     <tr>  
  11.         <td>第二次使用:<#nested></td>  
  12.     </tr>  
  13. </table>  
  14. </#macro>  
  15.   
  16. <@table><@greet person="刘文涛"/></@table>  




4:循环变量

4.1:基本用法
Ftl代码  收藏代码
  1. <#macro repeat count>  
  2.     <#list 1..count as x>  
  3.         <#nested>  
  4.     </#list>  
  5. </#macro>  
  6.   
  7. <@repeat count=4>  
  8.     freemarker...  
  9. </@repeat>  




4.2:nestted指令也可以有循环变量
Ftl代码  收藏代码
  1. <#macro repeat count>  
  2.      <#nested 23, true>  
  3. </#macro>  
  4.   
  5. <@repeat count=4 ; c, halfc, last>  
  6.     ${c}. ${halfc} <#if last> Last!</#if> <br>  
  7. </@repeat>  




这里count是宏的参数,c, halfc,last则为循环变量

下面的写法是不对的:
Ftl代码  收藏代码
  1. <#macro repeat count>  
  2.      <#nested 23, true>  
  3. </#macro>  
  4.   
  5. <@repeat count=4 ; c, halfc, last>  
  6.     ${count}| ${c}. ${halfc} <#if last> Last!</#if> <br>  
  7. </@repeat>  


因为:宏的参数是局部变量,而不是循环变量


再看一个复杂一点例子:

Ftl代码  收藏代码
  1. <#macro repeat count>  
  2.     <#list 1..count as x>  
  3.         <#nested x, x/2, x==count>  
  4.     </#list>  
  5. </#macro>  
  6.   
  7. <@repeat count=4 ; c, halfc, last>  
  8.     ${c}. ${halfc} <#if last> Last!</#if> <br>  
  9. </@repeat>  


循环变量和宏标记指定的不同不会有问题,如果调用时少指定了循环变量,那么多余的值不可见。调用时多指定了循环变量,多余的循环变量不会被创建:

五.命名空间
通常情况,只使用一个名字空间,称为主名字空间,但为了创建可重用的宏、变换器或其它变量的集合(通常称库),必须使用多名字空间,其目的是防止同名冲突。

1:创建库(假设保存在lib/my_test.ftl中)
Ftl代码  收藏代码
  1. <#macro copyright date>  
  2.    <p>Copyright (C) ${date} Julia Smith. All rights reserved.  
  3.    <br>Email: ${mail}</p>  
  4. </#macro>   
  5. <#assign mail="liuwentao@lib.com">  


2:使用import指令导入库到模板中
Freemarker会为导入的库创建新的名字空间,并可以通过import指令中指定的散列变量访问库中的变量
Ftl代码  收藏代码
  1. <#import "/lib/my_test.ftl" as my>  
  2. <#assign mail="wentao@outer.com">  
  3. <@my.copyright date="1999-2002"/>  
  4. ${my.mail}  
  5. ${mail}  

输出结果:
Ftl代码  收藏代码
  1. <p>Copyright (C) 1999-2002 Julia Smith. All rights reserved.  
  2. <br>Email: liuwentao@lib.com</p>  
  3. liuwentao@lib.com  
  4. wentao@outer.com  

可以看到例子中使用的两个同名变量并没有冲突,因为它们位于不同的名字空间。

3:还可以使用assign指令在导入的名字空间中创建或替代变量
Ftl代码  收藏代码
  1. <#import "/lib/my_test.ftl" as my>  
  2. ${my.mail}  
  3. <#assign mail="wentao@outer.com" in my>  
  4. ${my.mail}  

输出结果:
Ftl代码  收藏代码
  1. liuwentao@lib.com  
  2. wentao@outer.com  

4:数据模型中的变量任何地方都可见,也包括不同的名字空间
下面是修改的库:
Ftl代码  收藏代码
  1. <#macro copyright date>  
  2.    <p>Copyright (C) ${date} ${user}. All rights reserved.</p>  
  3. </#macro>  
  4. <#assign mail = "${user}@acme.com">  

假设数据模型中的user变量的值是liuwentao,则下面的代码:
Ftl代码  收藏代码
  1. <#import "/lib/my_test.ftl" as my>  
  2.   
  3. <@my.copyright date="1999-2002"/>  
  4. ${my.mail}  

输出结果:
Ftl代码  收藏代码
  1. <p>Copyright (C) 1999-2002 liuwentao. All rights reserved.</p>liuwentao@acme.com  


我遇到的问题

1: html 转义
Java代码  收藏代码
  1. <tr>  
  2.     <td>姓名:</td>  
  3.     <td><strong>${item.realName!?html}</strong></td>  
  4. </tr>  



其他

指定变量
Java代码  收藏代码
  1. <#assign categoryId =data.categoryId/>  


调用静态方法
Java代码  收藏代码
  1. <#assign category=statics["com.koolearn.eclass.product.ProductFactory"].getProductCategory(categoryId) />  


Java代码  收藏代码
  1. <#assign util=statics["com.koolearn.security.base.utils.KoolearnStringUtils"] />  
  2. ${util.subStrUnicode(item.content!?html,data.width!20,true)}  


-----------------------------------------------------
1.常用的函数

fm的函数调用语法是变量名后面跟一个问号,再写上方法名,如:${test?upper_case}
如果要调用2个以上的内置方法,则连续写,如:${test?upper_case?html}
引用
html : 将特殊html标记进行转换,如<转换成&lt;
cap_first : 首字母大写
lower_case : 转换成小写
upper_case :转换成大写
trim : 剪掉前后空白
size :得到序列、数组的元素个数
int :获得小数的整数部分
substring (from,  toExclusive):取子串
contains :和java同
ends_with :  以…结尾 吗
starts_with :  以…开头吗
last_index_of :  最后的索引所在位置
length :  字符串长度
matches :是否 匹配 一个正则

replace :  替换
Java代码  收藏代码
  1. ${"this is a car acarus"?replace("car""bulldozer")}----------->  
  2. this is a bulldozer abulldozerus  

2.删除连续多个变量之间的换行符

设想这样一个应用场景,你想生成一个java方法的代码,方法的参数是多个的,你一定不希望它是一行一个参数吧,那你就需要使用<#t>标签了,它的意思是去掉当前行首尾的空白,注意,换行也当成空白,比如下面的例子:
Java代码  收藏代码
  1. 1 <#t>     
  2. 2<#t>     
  3. 3<#lt>     
  4. 4     
  5. 5<#rt>     
  6. 6    

执行后的结果是:
Java代码  收藏代码
  1. 1 23   
  2. 4   
  3. 5 6  

<#t>在行里的位置无所谓,类似还有<#lt><#rt>,意思是去掉左侧和右侧的空白。

3.如何判断变量是否存在或对象的属性是否为null
  用??进行判断,如下:
 
Java代码  收藏代码
  1. <#if user??><h1>Welcome ${user}!</h1></#if>  

  存在或有值则为true
4.如何输出${xxx} 这样的字符串

  jsp el的语法和fm很像,都支持${}这样来输出变量内容,当然jsp本身其实也是一种模板技术,二者本质是一样的,你如果想生成jsp el的代码就会遇到这个问题,不能直接写,否则fm会把它当成fm的东西来解析成它变量了,这时候需要使用<#noparse>标签。
Java代码  收藏代码
  1. <#noparse>${ccc}</#noparse>    

  这样fm就不会把它当成变量来解析而是直接输出 ${ccc} 了


chunk 用法
Java代码  收藏代码
  1. <table width="950" border="0" cellspacing="2" cellpadding="0" align="center" class="mb12">  
  2. <#list bBookList?chunk(5) as row>  
  3.     <tr>  
  4.         <#list row as item>  
  5.             <td align="center">  
  6.                 <#if item.name??>  
  7.                      <#assign name=util.subString(item.name!,item.shortName!,data.width)/>  
  8.                     <a title='${item.name!}' href="${item.urlDetail!}" target="_blank">  
  9.                         <img src="${item.photoS!}" alt="${item.name!}" width="145" height="110" border="0" class="img_border2">  
  10.                     </a>  
  11.                     <table border="0" cellpadding="0" cellspacing="0">  
  12.                         <tr>  
  13.                             <td height="36" align="center">  
  14.                                 <a title='${item.name!}' href="${item.urlDetail!}" target="_blank">  
  15.                                     ${name}  
  16.                                 </a>  
  17.                             </td>  
  18.                         </tr>  
  19.                     </table>  
  20.                 </#if>  
  21.             </td>  
  22.         </#list>  
  23.     </tr>  
  24. </#list>  
  25. </table>  


  
 
原帖地址:http://wentao365.iteye.com/blog/612293
分享到:
评论

相关推荐

    Freemarker学习笔记

    Freemarker学习笔记可以帮助初学者了解,快速掌握Freemarker

    FreeMarker学习笔记

    FreeMarker学习笔记

    Freemarker 学习笔记一 【乱码解决】

    这篇“Freemarker学习笔记一【乱码解决】”将指导我们如何解决这个问题。 首先,我们需要了解乱码的常见原因。在Java Web开发中,乱码通常与以下因素有关: 1. **文件编码**:Freemarker模板文件(.ftl)的编码...

    freemarker学习资料汇总

    本压缩包集合了丰富的Freemarker学习资源,涵盖从基础到进阶的各种知识点,以下是这些文档中可能包含的详细内容: 1. **Freemarker中文手册.pdf**: 这份手册通常会详细介绍Freemarker的基本概念,如模板语言、...

    FreeMarker相关学习文档

    提供的"FreeMarker相关学习文档"可能包括模板语法详解、最佳实践、示例代码等内容,可以帮助初学者快速上手。通过阅读这些资料,你可以深入了解FreeMarker的各个方面,从而更好地利用这个强大的模板引擎。 总结,...

    freemarker学习

    Freemarker的核心思想是将数据模型与模板结合,通过模板来呈现准备好的数据。 在开始使用Freemarker之前,你需要先下载相关的jar包。你可以访问FreeMarker的官方网站...

    FreeMarker学习资料

    ### FreeMarker 学习资料详解 #### 一、FreeMarker 模板文件构成 FreeMarker 是一种用于生成动态文档的工具,它通过结合固定的文本、注释、变量(插值)以及指令(FTL标签)来创建动态内容。具体而言,FreeMarker ...

    freemarker学习资料

    在快速入门中,我们看到FreeMarker的基本工作原理是通过模板中的特定指令,如`${...}`,将动态数据插入到静态模板中。例如,以下模板展示了如何欢迎用户并显示最新产品的信息: ```html &lt;title&gt;Welcome! &lt;h1&gt;...

    FreeMarker 学习手册

    FreeMarker 学习手册 详细介绍FreeMarker模板技术的手册

    freemarker中文学习资料

    这个“freemarker中文学习资料”压缩包提供了详尽的网页版API文档,对于想要深入理解和掌握Freemarker的开发者来说,是一份非常宝贵的资源。 1. **Freemarker基础概念** - **模板语言**:Freemarker使用一种简单的...

    FreeMarker学习资料整理

    6. **学习笔记** - **入门**:从简单的变量输出开始,逐步了解FreeMarker的基本语法。 - **进阶**:掌握控制结构和逻辑,以及如何与Java对象交互。 - **实践**:通过实际项目应用,提升解决实际问题的能力。 - *...

    freemarker笔记

    在本篇笔记中,我们将深入探讨Freemarker的核心概念、语法结构和表达式。 一、核心概念 1. Scalars(标量): - 字符串:用单引号或双引号括起来的文本,例如 'hello' 或 "world"。 - 数字:直接写出数字,例如 ...

    freemarker学习例子

    这个“freemarker学习例子”应该包含了一些基础到进阶的Freemarker用法,帮助初学者快速上手。 在Freemarker中,主要涉及以下几个核心概念: 1. **模板(Templates)**:模板是Freemarker的核心,它是HTML或其他文本...

    FreeMarker学习代码小结

    在本篇文章中,我们将深入探讨FreeMarker的学习要点,包括其基本概念、语法以及实际应用。 一、基本概念 1. 模板(Template):FreeMarker的中心是模板文件,它是一种特殊的文本文件,包含固定文本和变量。变量是由...

Global site tag (gtag.js) - Google Analytics