Open Java Project

Keep it simple, Stupid, Less is more

nelson_tu ID:chenyun2000
438639次访问,排名103好友1人,关注者4
chenyun2000的文章
原创 189 篇
翻译 0 篇
转载 10 篇
评论 273 篇
nelson_tu的公告


自从2005年04月05日
(061800)

Dynamic Script Language
DOTNET2_BEGINNER

最近评论
oliver1212:index.jsp和login.jsp别忘了加上<%@ taglib uri="http://struts.apache.org/tags-logic" prefix="logic"%>
mghueh:wow power leveling
mghueh:wow power leveling
mghueh:wow power leveling
wdlfellow:天下闻名还行
文章分类
收藏
相册
2008
AJAX
Ajax.NET(RSS)
AjaxFaces(RSS)
Ajaxian(RSS)
BACKBASE(RSS)
DWR(RSS)
Prototype(RSS)
SAJAX(php/perl/python)(RSS)
AOP&AspectJ
AspectWerkz(RSS)
eBook&Articles
Codehaus Docs(RSS)
CodeZoo(RSS)
FlazX(RSS)
huihoo(灰狐)(RSS)
IBM developerWorks(RSS)
ITPUB论坛(RSS)
java.net articles(RSS)
Onjava.com(RSS)
TheServerSide(RSS)
中国E书网(RSS)
Eclipse
Eclipse Article(RSS)
Eclipse.org(RSS)
Plugins(RSS)
中国Eclipse社区(RSS)
Groovy
Groovy开源项目(RSS)
Just Groovy(RSS)
J2EE Framework
Apache Geronimo(RSS)
Avalon Project(RSS)
Spring(RSS)
Spring 中文论坛(RSS)
Open Project
ActiveMQ(RSS)
QDox(RSS)
Open Source
Apache Project(RSS)
Caucho(RSS)
Codehaus.org(RSS)
dev2dev(RSS)
Exadel(RSS)
JBoss(RSS)
Jetty(RSS)
Sourceforge.net(RSS)
ORM&DAO
Cayenne(RSS)
Hibernate.org(RSS)
Hibernate中文网(RSS)
iBATIS(RSS)
PDF
iText(RSS)
Template Engine
Freemarker(RSS)
Velocity Project(RSS)
Xkins(RSS)
Web MVC Framework
Aurora MVC(RSS)
OpenSymphony(RSS)
Wicket Project(RSS)
其它
上海城市交通(RSS)
西安信息资源网(RSS)
友情blog
Craig's stack trace(RSS)
HongSoft 动力(RSS)
Ken Egervari(RSS)
Open Java Project (BlogJava)(RSS)
一地鸡毛(RSS)
图图日记(RSS)
星月夜(RSS)
邢红瑞的blog(RSS)
存档
软件项目交易
订阅我的博客
XML聚合  FeedSky

原创 FreeMarker设计指南(4) (完)收藏

新一篇: Web MVC的替代方法 | 旧一篇: FreeMarker设计指南(3)

4、杂项

1)用户定义指令

l         宏和变换器变量是两种不同类型的用户定义指令,它们之间的区别是宏是在模板中使用macro指令定义,而变换器是在模板外由程序定义,这里只介绍宏

l         基本用法

Ø         宏是和某个变量关联的模板片断,以便在模板中通过用户定义指令使用该变量,下面是一个例子:

<#macro greet>
  <font size="+2">Hello Joe!</font>
</#macro>  

Ø         作为用户定义指令使用宏变量时,使用@替代FTL标记中的#

<@greet></@greet>

Ø         如果没有体内容,也可以使用:

<@greet/>

l         参数

Ø         macro指令中可以在宏变量之后定义参数,如:

<#macro greet person>
  <font size="+2">Hello ${person}!</font>
</#macro> 

Ø         可以这样使用这个宏变量:

<@greet person="Fred"/> and <@greet person="Batman"/> 

输出结果是:

  <font size="+2">Hello Fred!</font>
 and   <font size="+2">Hello Batman!</font>
   

Ø         宏的参数是FTL表达式,所以下面的代码具有不同的意思:

<@greet person=Fred/>

Ø         这意味着将Fred变量的值传给person参数,该值不仅是字符串,还可以是其它类型,甚至是复杂的表达式

Ø         宏可以有多参数,下面是一个例子:

<#macro greet person color>
  <font size="+2" color="${color}">Hello ${person}!</font>
</#macro> 

Ø         可以这样使用该宏变量:

<@greet person="Fred" color="black"/> 

Ø         其中参数的次序是无关的,因此下面是等价的:

<@greet color="black" person="Fred"/>

Ø         只能使用在macro指令中定义的参数,并且对所有参数赋值,所以下面的代码是错误的:

<@greet person="Fred" color="black" background="green"/>
<@greet person="Fred"/>

Ø         可以在定义参数时指定缺省值,如:

<#macro greet person color="black">
  <font size="+2" color="${color}">Hello ${person}!</font>
</#macro>  

Ø         这样<@greet person="Fred"/>就正确了

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

l         嵌套内容

Ø         用户定义指令可以有嵌套内容,使用<#nested>指令执行指令开始和结束标记之间的模板片断

Ø         例子:

<#macro border>
  <table border=4 cellspacing=0 cellpadding=4><tr><td>
    <#nested>
  </tr></td></table>
</#macro>  

这样使用该宏变量:

<@border>The bordered text</@border>

输出结果:

  <table border=4 cellspacing=0 cellpadding=4><tr><td>
    The bordered text
  </tr></td></table>
  

Ø         <#nested>指令可以被多次调用,例如:

<#macro do_thrice>
  <#nested>
  <#nested>
  <#nested>
</#macro>
<@do_thrice>
  Anything.
</@do_thrice>  

输出结果:

  Anything.
  Anything.
  Anything. 

Ø         嵌套内容可以是有效的FTL,下面是一个有些复杂的例子:

<@border>
  <ul>
  <@do_thrice>
    <li><@greet person="Joe"/>
  </@do_thrice>
  </ul>
</@border> 

输出结果:

  <table border=4 cellspacing=0 cellpadding=4><tr><td>
      <ul>
    <li><font size="+2">Hello Joe!</font>
 
    <li><font size="+2">Hello Joe!</font>
 
    <li><font size="+2">Hello Joe!</font>
 
  </ul>
 
  </tr></td></table>  

Ø         宏定义中的局部变量对嵌套内容是不可见的,例如:

<#macro repeat count>
  <#local y = "test">
  <#list 1..count as x>
    ${y} ${count}/${x}: <#nested>
  </#list>
</#macro>
<@repeat count=3>${y?default("?")} ${x?default("?")} ${count?default("?")}</@repeat>

输出结果:

    test 3/1: ? ? ?
    test 3/2: ? ? ?
    test 3/3: ? ? ?

Ø          

l         在宏定义中使用循环变量

Ø         用户定义指令可以有循环变量,通常用于重复嵌套内容,基本用法是:作为nested指令的参数传递循环变量的实际值,而在调用用户定义指令时,在<@…>开始标记的参数后面指定循环变量的名字

Ø         例子:

<#macro repeat count>
  <#list 1..count as x>
    <#nested x, x/2, x==count>
  </#list>
</#macro>
<@repeat count=4 ; c, halfc, last>
  ${c}. ${halfc}<#if last> Last!</#if>
</@repeat>  

输出结果:

  1. 0.5
  2. 1
  3. 1.5
  4. 2 Last!
  

Ø         指定的循环变量的数目和用户定义指令开始标记指定的不同不会有问题

n         调用时少指定循环变量,则多指定的值不可见

n         调用时多指定循环变量,多余的循环变量不会被创建

2)在模板中定义变量

l         在模板中定义的变量有三种类型:

Ø         plain变量:可以在模板的任何地方访问,包括使用include指令插入的模板,使用assign指令创建和替换

Ø         局部变量:在宏定义体中有效,使用local指令创建和替换

Ø         循环变量:只能存在于指令的嵌套内容,由指令(如list)自动创建;宏的参数是局部变量,而不是循环变量

l         局部变量隐藏(而不是覆盖)同名的plain变量;循环变量隐藏同名的局部变量和plain变量,下面是一个例子:

<#assign x = "plain">
1. ${x}  <#-- we see the plain var. here -->
<@test/>
6. ${x}  <#-- the value of plain var. was not changed -->
<#list ["loop"] as x>
    7. ${x}  <#-- now the loop var. hides the plain var. -->
    <#assign x = "plain2"> <#-- replace the plain var, hiding does not mater here -->
    8. ${x}  <#-- it still hides the plain var. -->
</#list>
9. ${x}  <#-- the new value of plain var. -->
 
<#macro test>
  2. ${x}  <#-- we still see the plain var. here -->
  <#local x = "local">
  3. ${x}  <#-- now the local var. hides it -->
  <#list ["loop"] as x>
    4. ${x}  <#-- now the loop var. hides the local var. -->
  </#list>
  5. ${x}  <#-- now we see the local var. again -->
</#macro>  

输出结果:

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

l         内部循环变量隐藏同名的外部循环变量,如:

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

输出结果:

  loop 1
    loop 2
      loop 3
    loop 2
  loop 1