Gavin.lee — Wed, 19 Aug 2009 10:16:00 GMT

1概念
2指��o
if, else, elseif
switch, case, default, break
list, break
include
Import
compress
escape, noescape
assign
global
setting
macro, nested, return
t, lt, rt
3一些常用方法或注意事项
表达式�{换类
数字循环
�Ҏ�Q点取整数
�l�变量默认�?
判断对象是不是null
常用格式化日�?
��d��全局�׃�n变量数据模型
直接调用java对象的方�?
字符串处�?内置�Ҏ��)
在模杉K��对sequences和hashes初始�?
注释标志
sequences内置�Ҏ��
hashes内置�Ҏ��
4 freemarker在web开发中注意事项
web中常用的几个对象
view中值的搜烦��序
在模杉K��ftl里��用标�{?
如何初始化共享变�?
与webwork整合配置
5高��Ҏ��
自定义方�?
自定�?Transforms

1概念
最常用�?个概�?br /> sequence 序列�Q�对应java里的list、数�l�等非键值对的集�?br /> hash 键值对的集�?br /> namespace 对一个ftl文�g的引�?利用�q�个名字可以讉K��到该ftl文�g的资�?/p>

2指��o
if, else, elseif
语法
<#if condition>
...
<#elseif condition2>
...
<#elseif condition3>
...
<#else>
...

switch, case, default, break
语法
<#switch value>
<#case refValue1>
    ...
    <#break>
<#case refValue2>
    ...
    <#break>
...
<#case refValueN>
    ...
    <#break>
<#default>
    ...

用例
字符�?br /> <#switch being.size>
<#case "small">
     This will be processed if it is small
     <#break>
<#case "medium">
     This will be processed if it is medium
     <#break>
<#case "large">
     This will be processed if it is large
     <#break>
<#default>
     This will be processed if it is neither

数字
<#switch x>
<#case x = 1>
    1
<#case x = 2>
    2
<#default>
    d

如果x=1 输出 1 2, x=2输出 2, x=3 输出d

list, break
语法
<#list sequence as item>
...
<#if item = "spring"><#break>
...

关键�?br /> item_index:是list当前值的下标
item_has_next:判断list是否�q�有�?/p>

用例
<#assign seq = ["winter", "spring", "summer", "autumn"]>
<#list seq as x>
${x_index + 1}. ${x}<#if x_has_next>,

输出
1. winter,
2. spring,
3. summer,
4. autumn

include
语法
<#include filename>
or
<#include filename options>
options包含两个属�?br /> encoding=”GBK” �~�码格式
parse=true 是否作�ؓftl语法解析,默认是true�Q�false��是以文本方式引�?注意在ftl文�g里布��值都是直接赋值的如parse=true,而不是parse=”true”
用例
/common/copyright.ftl包含内容
Copyright 2001-2002 ${me}

All rights reserved.
模板文�g
<#assign me = "Juila Smith">

Some test

Yeah.

<#include "/common/copyright.ftl" encoding=”GBK”>
输出�l�果

Some test

Yeah.

import
语法
<#import path as hash>
�c�M��于java里的import,它导入文�Ӟ��然后��可以在当前文�g里��用被导入文�g里的宏组�?/p>

用例

假设mylib.ftl里定义了宏copyright那么我们在其他模杉K��面里可以�q�样使用
<#import "/libs/mylib.ftl" as my>

<@my.copyright date="1999-2002"/>

"my"在freemarker里被�U�C��namespace

compress
语法
<#compress>
...

用来压羃�I�白�I�间和空白的�?br /> 用例
<#assign x = " moo \n\n ">
(<#compress>
1 2 3 4 5
${moo}
test only

I said, test only

)
输出
(1 2 3 4 5
moo
test only
I said, test only)

escape, noescape
语法
<#escape identifier as expression>
...
<#noescape>...
...

用例
主要使用在相似的字符串变量输出，比如某一个模块的所有字�W�串输出都必��L��html安全的，�q�个时候就可以使用该表辑ּ�
<#escape x as x?html>
First name: ${firstName}
<#noescape>Last name: ${lastName}
Maiden name: ${maidenName}

相同表达�?
First name: ${firstName?html}
Last name: ${lastName }
Maiden name: ${maidenName?html}
assign
语法
<#assign name=value>
or
<#assign name1=value1 name2=value2 ... nameN=valueN>
or
<#assign same as above... in namespacehash>
or
<#assign name>
capture this

or
<#assign name in namespacehash>
capture this

用例
生成变量,�q�且�l�变量赋�?br /> �l�seasons赋予序列�?br /> <#assign seasons = ["winter", "spring", "summer", "autumn"]>

�l�变量test�?
<#assign test = test + 1>

�l�my namespage 赋予一个变量bgColor,下面可以通过my.bgColor来访问这个变�?br /> <#import "/mylib.ftl" as my>
<#assign bgColor="red" in my>

��一�D�输出的文本作�ؓ变量保存在x�?br /> 下面的阴影部分输出的文本��被赋值给x
<#assign x>
<#list 1..3 as n>
${n} <@myMacro />

Number of words: ${x?word_list?size}
${x}

<#assign x>Hello ${user}! error
<#assign x=” Hello ${user}!”> true

同时也支持中文赋��|��如：
<#assign 语法>
java

${语法}
打印输出:
java
global
语法
<#global name=value>
or
<#global name1=value1 name2=value2 ... nameN=valueN>
or
<#global name>
capture this

全局赋��D��法，利用�q�个语法�l�变量赋��|��那么�q�个变量在所有的namespace中是可见�?如果�q�个变量被当前的assign语法覆盖 �?lt;#global x=2> <#assign x=1> 在当前页面里x=2��被隐藏�Q�或者通过${.global.x}来访�?/p>

setting
语法
<#setting name=value>
用来讄��整个�pȝ��的一个环�?br /> locale
number_format
boolean_format
date_format, time_format, datetime_format
time_zone
classic_compatible
用例
假如当前是匈牙利的设�|�，然后修改成美�?br /> ${1.2}
<#setting locale="en_US">
${1.2}
输出
1,2
1.2
因�ؓ匈牙利是采用“,”作�ؓ十进制的分隔�W�，��国是用“.”

macro, nested, return
语法

<#macro name param1 param2 ... paramN>
...
<#nested loopvar1, loopvar2, ..., loopvarN>
...
<#return>
...

用例
<#macro test foo bar="Bar" baaz=-1>
Test text, and the params: ${foo}, ${bar}, ${baaz}

<@test foo="a" bar="b" baaz=5*5-2/>
<@test foo="a" bar="b"/>
<@test foo="a" baaz=5*5-2/>
<@test foo="a"/>
输出
Test text, and the params: a, b, 23
Test text, and the params: a, b, -1
Test text, and the params: a, Bar, 23
Test text, and the params: a, Bar, -1
定义循环输出的宏
<#macro list title items>

${title?cap_first}:

${x?cap_first}

<@list items=["mouse", "elephant", "python"] title="Animals"/>
输出�l�果

Animals:

Mouse
Elephant
Python

包含body的宏
<#macro repeat count>
<#list 1..count as x>
<#nested x, x/2, x==count>

<@repeat count=4 ; c halfc last>
${c}. ${halfc}<#if last> Last!

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

t, lt, rt
语法
<#t> ��L��左右�I�白和回车换�?/p>

<#lt>��L��左边�I�白和回车换�?/p>

<#rt>��L��双��I�白和回车换�?/p>

<#nt>取消上面的效�?/p>

3一些常用方法或注意事项

表达式�{换类
${expression}计算expression�q�输�?br /> #{ expression }数字计算#{ expression ;format}安格式输出数字format为M和m
M表示��数点后最多的位数,m表示��数点后最��的位数�?{121.2322;m2M2}输出121.23

数字循环
1..5 表示�?�?�Q�原型number..number

�Ҏ�Q点取整数
${123.23?int} 输出123

�l�变量默认�?br /> ${var?default(“hello world
”)?html}如果var is null那么��会被hello world
替代

判断对象是不是null
<#if mouse?exists>
Mouse found
<#else>
也可以直�?{mouse?if_exists})输出布尔�?br />
常用格式化日�?br /> openingTime必须是Date�?详细查看freemarker文档 Reference->build-in referece->build-in for date

${openingTime?date}
${openingTime?date_time}
${openingTime?time}

��d��全局�׃�n变量数据模型
在代码里的实�?br /> cfg = Configuration.getDefaultConfiguration();
cfg.setSharedVariable("global", "you good");
��面实现可以通过global指��o,具体查看指��o里的global部分

直接调用java对象的方�?br /> ${object.methed(args)}

字符串处�?内置�Ҏ��)
html安全输出
“abc

sdfsf”?html
�q�回安全的html输出,替换掉html代码

xml安全输出
var?xml

substring的用�?br /> <#assign user=”hello jeen”>
${user[0]}${user[4]}
${user[1..4]}
输出 :
ho
ello

�c�M��String.split的用�?br /> “abc;def;ghi”?split(“;”)�q�回sequence
��字�W�串按空��D�{化成sequence,然后取sequence的长�?br /> var?word_list 效果�?var?split(“ ”)
var?word_list?size

取得字符串长�?br /> var?length

大写输出字符
var?upper_case

��写输出字符
var?lower_case

首字�W�大�?br /> var?cap_first

首字�W�小�?br /> var?uncap_first

��L��字符串前后空�?br /> var?trim

每个单词的首字符大写
var?capitalize

�c�M��String.indexof:
“babcdabcd”?index_of(“abc”) �q�回1
“babcdabcd”?index_of(“abc”,2) �q�回5

�c�M��String.lastIndexOf
last_index_of和String.lastIndexOf�c�M��,同上

下面两个可能在代码生成的时候��用（在引号前�?#8221;\”�Q?br /> j_string: 在字�W�串引号前加”\”
<#assign beanName = 'The "foo" bean.'>
String BEAN_NAME = "${beanName?j_string}";
打印输出:
String BEAN_NAME = "The \"foo\" bean.";
js_string:

<#assign user = "Big Joe's \"right hand\".">

打印输出
alert("Welcome Big Joe\'s \"right hand\"!");

替换字符�?replace
${s?replace('ba’, 'XY’ )}
${s?replace('ba’, 'XY’ , '规则参数’)}��s里的所有的ba替换成xy 规则参数包含: i r m s c f 具体含义如下:
· i: 大小写不区分.
· f: 只替换第一个出现被替换字符串的字符�?br /> · r: XY是正则表辑ּ�
· m: Multi-line mode for regular expressions. In multi-line mode the expressions ^ and $ match just after or just before, respectively, a line terminator or the end of the string. By default these expressions only match at the beginning and the end of the entire string.
· s: Enables dotall mode for regular expressions (same as Perl singe-line mode). In dotall mode, the expression . matches any character, including a line terminator. By default this expression does not match line terminators.
· c: Permits whitespace and comments in regular expressions.

在模杉K��对sequences和hashes初始�?br /> sequences

1. [“you”,”me”,”he”]
2. 1..100
3. [ {“Akey”:”Avalue”},{“Akey1”:”Avalue1”},
{“Bkey”:”Bvalue”},{“Bkey1”:”Bvalue1”},
]

hashes {“you”:”a”,”me”:”b”,”he”:”c”}

注释标志
<#--
�q�里是注�?br /> -->
旧版本的freemarker采用的是<#comment> 注释 �Ҏ��

sequences内置�Ҏ��
sequence?first
�q�回sequence的第一个�?前提条�gsequence不能是null
sequence?last
�q�回sequence最后一个�?br /> sequence?reverse
反�{sequence的�?br /> sequence?size
�q�回sequence的大��?br /> sequence?sort
对sequence按里面的对象toString()的结果进行排�?br /> sequence?sort_by(value)
对sequence 按里面的对象的属性value�q�行排序
�? sequence里面攑օ�的是10 个user对象�Q�user对象里面包含name,age�{�属�?br /> sequence?sort_by(name) 表示所有的user按user.name�q�行排序
hashes内置�Ҏ��
hash?keys
�q�回hash里的所有keys, �q�回�l�果�c�d��sequence
hash?values
�q�回hash里的所有value, �q�回�l�果�c�d��sequence

4 freemarker在web开发中注意事项
freemarker与webwork整合
web中常用的几个对象
Freemarker的ftl文�g中直接��用内部对�?
${Request ["a"]}
${RequestParameters["a"]}
${Session ["a"]}
${Application ["a"]}
${JspTaglibs ["a"]}

与webwork整合之后通过配置的servlet 已经把request,session�{�对象置入了数据模型�?br /> 在view中存在下面的对象
我们可以在ftl�?{req}来打印req对象
· req - the current HttpServletRequest
· res - the current HttpServletResponse
· stack - the current OgnlValueStack
· ognl - the OgnlTool instance
· webwork - an instance of FreemarkerWebWorkUtil
· action - the current WebWork action
· exception - optional the Exception instance, if the view is a JSP exception or Servlet exception view
view中值的搜烦��序
${name}��会以下面的��序查找name�?br /> · freemarker variables
· value stack
· request attributes
· session attributes
· servlet context attributes
在模杉K��ftl里��用标�{?br /> 注意�Q�如果标�{��属性值是数字�Q�那么必��采用nubmer=123方式�l�属性赋�?br /> JSP��面
<%@page contentType="text/html;charset=ISO-8859-2" language="java"%>
<%@taglib uri="/WEB-INF/struts-html.tld" prefix="html"%>
<%@taglib uri="/WEB-INF/struts-bean.tld" prefix="bean"%>

      Keyword:

      Exclude:




模板ftl��面
<#assign html=JspTaglibs["/WEB-INF/struts-html.tld"]>
<#assign bean=JspTaglibs["/WEB-INF/struts-bean.tld"]>

<@bean.message key="welcome.title"/>

    <@html.errors/>
    <@html.form action="/query">
      Keyword: <@html.text property="keyword"/>

      Exclude: <@html.text property="exclude"/>

      <@html.submit value="Send"/>

如何初始化共享变�?br /> 1�Q?初始化全局�׃�n数据模型
freemark在web上��用的时候对�׃�n数据的初始化支持的不�?不能在配�|�初始化的时候实玎ͼ�而必��通过ftl文�g来初始化全局变量。这是不能满主需求的�Q�我们需要在servlet init的时候留��Z��个接口来初始化系�l�的�׃�n数据
具体到和webwork整合,因�ؓ本��nwebwork提供了整合servlet,如果要增加全局�׃�n变量�Q�可以通过修改 com.opensymphony.webwork.views.freemarker.FreemarkerServlet来实�?我们可以在这�?servlet初始化的时候来初始化全局�׃�n变量
与webwork整合配置
配置web.xml

    freemarker
    com.opensymphony.webwork.views.freemarker.FreemarkerServlet

      TemplatePath
/



      NoCache
      true


      ContentType
      text/html


template_update_delay

      0


      default_encoding
      GBK


      number_format
      0.##########

    1

    freemarker
    *.ftl

5高��Ҏ��
自定义方�?br /> ${timer("yyyy-MM-dd H:mm:ss", x)}
${timer("yyyy-MM-dd ", x)}

在模板中除了可以通过对象来调用方法外�Q?{object.methed(args)}�Q�也可以直接调用java实现的方法，java�c�d��d��现接口TemplateMethodModel的方法exec(List args). 下面以把毫秒的时间�{换成按格式输出的旉��Z��?br /> public class LongToDate implements TemplateMethodModel {

public TemplateModel exec(List args) throws TemplateModelException {
SimpleDateFormat mydate = new SimpleDateFormat((String) args.get(0)));
        return mydate.format(new Date(Long.parseLong((String)args.get(1)));
    }
}
��LongToDate对象攑օ�到数据模型中
root.put("timer", new IndexOfMethod());
ftl模板里��?br /> <#assign x = "123112455445">
${timer("yyyy-MM-dd H:mm:ss", x)}
${timer("yyyy-MM-dd ", x)}

输出
2001-10-12 5:21:12
2001-10-12

自定�?Transforms
实现自定义的<@transform>文本或表辑ּ�的功�?允许对中间的最�l�文本进行解析�{�?/p>

例子�Q�实�?lt;@upcase>str ��str转换成STR 的功�?/p>

代码如下�Q?br /> import java.io.*;
import java.util.*;
import freemarker.template.TemplateTransformModel;

class UpperCaseTransform implements TemplateTransformModel {

    public Writer getWriter(Writer out, Map args) {
        return new UpperCaseWriter(out);
    }

    private class UpperCaseWriter extends Writer {

        private Writer out;

        UpperCaseWriter (Writer out) {
            this.out = out;
        }

        public void write(char[] cbuf, int off, int len)
                throws IOException {
            out.write(new String(cbuf, off, len).toUpperCase());
        }

        public void flush() throws IOException {
            out.flush();
        }

        public void close() {
        }
    }
}
然后��此对象put到数据模型中
root.put("upcase", new UpperCaseTransform());

在view(ftl)��面中可以如下方式��?/p>

<@upcase>
hello world

打印输出:
HELLO WORLD

Gavin.lee 2009-08-19 18:16 发表评论

FreeMarker 中常见的 StringIndexOutOfBoundsException

Gavin.lee — Thu, 09 Jul 2009 05:10:00 GMT

关于�q�个问题�Q�跟undefined差不多常见。原因就是数据源为空字符�Q�而非�I�）�?br />

500 Servlet Exception

java.lang.StringIndexOutOfBoundsException: String index out of range: 1
	at java.lang.String.substring(String.java:1935)
	at yixun.wap.filter.ReplaceTextStream.replaceContent(ReplaceTextFilter.java:32)
	at yixun.wap.filter.ReplaceTextFilter.doFilter(ReplaceTextFilter.java:81)
	at com.caucho.server.dispatch.FilterFilterChain.doFilter(FilterFilterChain.java:73)
	at com.caucho.server.webapp.WebAppFilterChain.doFilter(WebAppFilterChain.java:167)
	at com.caucho.server.dispatch.ServletInvocation.service(ServletInvocation.java:226)
	at com.caucho.server.http.HttpRequest.handleRequest(HttpRequest.java:263)
	at com.caucho.server.port.TcpConnection.run(TcpConnection.java:477)
	at com.caucho.util.ThreadPool$Item.runTasks(ThreadPool.java:591)
	at com.caucho.util.ThreadPool$Item.run(ThreadPool.java:513)
	at java.lang.Thread.run(Thread.java:619)

Gavin.lee 2009-07-09 13:10 发表评论

Gavin.lee — Thu, 09 Jul 2009 04:57:00 GMT

要��用FreeMarker�Q�话不多��_��肯定先要�l�MyEclipse装上FreeMarker的编辑插�Ӟ��q�样代码才能高亮昄��啊�?br />

打开菜单��?Help -> Software updates -> Find and install....

选择单选项 "Search for new features to install".
点击 Add Update Site..., 输入 "FreeMarker" 作�ؓ名字以及 "http://www.freemarker.org/eclipse/update" 作�ؓ更新的地址
选中复选框 "FreeMarker" 点击下一步或完成按钮�Ҏ��提示完成插�g的安�?

要想使用FreeMarker开发了�Q�那�q�需要网上下载freemarker.jar�?/p>

Gavin.lee 2009-07-09 12:57 发表评论

FreeMarker 中最常见�?undefined

Gavin.lee — Thu, 09 Jul 2009 01:50:00 GMT

500 Servlet Exception

freemarker.core.InvalidReferenceException: Expression s.expect is undefined
on line 7, column 11 in news/prize/open/ssc.ftl.
	at freemarker.core.TemplateObject.assertNonNull(TemplateObject.java:124)
	at freemarker.core.Expression.getStringValue(Expression.java:118)
	at freemarker.core.Expression.getStringValue(Expression.java:93)
	at freemarker.core.DollarVariable.accept(DollarVariable.java:76)
	at freemarker.core.Environment.visit(Environment.java:209)
	at freemarker.core.MixedContent.accept(MixedContent.java:92)
	at freemarker.core.Environment.visit(Environment.java:209)
	at freemarker.core.IteratorBlock$Context.runLoop(IteratorBlock.java:179)
	at freemarker.core.Environment.visit(Environment.java:416)
	at freemarker.core.IteratorBlock.accept(IteratorBlock.java:102)
	at freemarker.core.Environment.visit(Environment.java:209)
	at freemarker.core.MixedContent.accept(MixedContent.java:92)
	at freemarker.core.Environment.visit(Environment.java:209)
	at freemarker.core.Environment.visit(Environment.java:394)
	at freemarker.core.BodyInstruction.accept(BodyInstruction.java:93)
	at freemarker.core.Environment.visit(Environment.java:209)
	at freemarker.core.MixedContent.accept(MixedContent.java:92)
	at freemarker.core.Environment.visit(Environment.java:209)
	at freemarker.core.Environment.visit(Environment.java:298)
	at freemarker.core.CompressedBlock.accept(CompressedBlock.java:73)
	at freemarker.core.Environment.visit(Environment.java:209)
	at freemarker.core.MixedContent.accept(MixedContent.java:92)
	at freemarker.core.Environment.visit(Environment.java:209)
	at freemarker.core.EscapeBlock.accept(EscapeBlock.java:84)
	at freemarker.core.Environment.visit(Environment.java:209)
	at freemarker.core.Macro$Context.runMacro(Macro.java:168)
	at freemarker.core.Environment.visit(Environment.java:602)
	at freemarker.core.UnifiedCall.accept(UnifiedCall.java:106)
	at freemarker.core.Environment.visit(Environment.java:209)
	at freemarker.core.MixedContent.accept(MixedContent.java:92)
	at freemarker.core.Environment.visit(Environment.java:209)
	at freemarker.core.Environment.process(Environment.java:189)
	at freemarker.template.Template.process(Template.java:237)
	at yixun.wap.freemarker.FreemarkerDo.doMark(FreemarkerDo.java:47)
	at _jsp._page._news._prize._open._ssc__jsp._jspService(page/news/prize/open/ssc.jsp:41)
	at com.caucho.jsp.JavaPage.service(JavaPage.java:61)
	at com.caucho.jsp.Page.pageservice(Page.java:586)
	at com.caucho.server.dispatch.PageFilterChain.doFilter(PageFilterChain.java:190)
	at yixun.wap.filter.ReplaceTextFilter.doFilter(ReplaceTextFilter.java:77)
	at com.caucho.server.dispatch.FilterFilterChain.doFilter(FilterFilterChain.java:73)
	at com.caucho.server.webapp.WebAppFilterChain.doFilter(WebAppFilterChain.java:167)
	at com.caucho.server.dispatch.ServletInvocation.service(ServletInvocation.java:226)
	at com.caucho.server.http.HttpRequest.handleRequest(HttpRequest.java:263)
	at com.caucho.server.port.TcpConnection.run(TcpConnection.java:477)
	at com.caucho.util.ThreadPool$Item.runTasks(ThreadPool.java:591)
	at com.caucho.util.ThreadPool$Item.run(ThreadPool.java:513)
	at java.lang.Thread.run(Thread.java:619)


注：
�׃��freemarker强烈不支持null�Q�所以这个问题呢�Q�多半就是JSP�Q�或抛数据源的地方）数据没有正确的传�q�来。究其原因，不在ftl模板�?
MyEclipse控制台输出：一看知道哪个页面，哪行错了�Q�so easy…�? O(∩_�?O~
[09:44:50.546] Compiling _jsp/_page/_news/_prize/_open/_ssc__jsp.java
[ERROR] 
Expression s.expect is undefined on line 7, column 11 in news/prize/open/ssc.ftl.
The problematic instruction:
----------
==> ${s.expect} [on line 7, column 9 in news/prize/open/ssc.ftl]
 in user-directive f.page [on line 3, column 1 in news/prize/open/ssc.ftl]
----------

Java backtrace for programmers:
----------
freemarker.core.InvalidReferenceException: Expression s.expect is undefined on line 7, column 11 in news/prize/open/ssc.ftl.
 at freemarker.core.TemplateObject.assertNonNull(TemplateObject.java:124)
 at freemarker.core.Expression.getStringValue(Expression.java:118)
…�?br />…�?/pre>


Gavin.lee 2009-07-09 09:50 发表评论

Gavin.lee — Fri, 26 Jun 2009 07:59:00 GMT

http://freemarker.org/docs/index.html 官方手册

FreeMarker的模板文件�ƈ不比HTML��面复杂多少,FreeMarker模板文�g主要由如�?个部分组�?
1,文本:直接输出的部�?br /> 2,注释:<#-- ... -->格式部分,不会输出
3,插�?�?{...}�?{...}格式的部�?��用数据模型中的部分替代输�?br /> 4,FTL指��o:FreeMarker指定,和HTML标记�c�M��,名字前加#予以区分,不会输出

下面是一个FreeMarker模板的例�?包含了以上所说的4个部�?br />

Welcome!

<#-- 注释部分 -->

<#-- 下面使用插�?-->

Welcome ${user} !

We have these animals:

<#-- 使用FTL指��o -->
<#list animals as being>

${being.name} for ${being.price} Euros

<#list>

1, FTL指��o规则

在FreeMarker�?使用FTL标签来��用指�?FreeMarker�?�U�FTL标签,�q�和HTML标签是完全类似的.
1,开始标�{?<#directivename parameter>
2,�l�束标签:
3,�I�标�{?<#directivename parameter/>

实际�?使用标签时前面的�W�号#也可能变成@,如果该指令是一个用��h��令而不是系�l�内建指令时,应将#�W�号�Ҏ��@�W�号.
使用FTL标签�?应该有正��的嵌套,而不是交叉��?�q�和XML标签的用法完全一�?如果全用不存在的指��o,FreeMarker不会使用模板输出,而是产生一个错误消�?FreeMarker会忽略FTL标签中的�I�白字符.值得注意的是< , /> 和指令之间不允许有空白字�W?

2, 插��D��?/span>

FreeMarker的插值有如下两种�c�d��:1,通用插�?{expr};2,数字格式化插�?#{expr}�?{expr;format}

2.1 通用插�?/span>

对于通用插�?又可以分��Z��?�U�情�?
1,插值结果�ؓ字符串�?直接输出表达式结�?br /> 2,插值结果�ؓ数字�?�Ҏ��默认格式(�?setting指��o讄��)��表辑ּ��l�果转换成文本输�?可以使用内徏的字�W�串函数格式化单个插�?如下面的例子:
<#settion number_format="currency"/>
<#assign answer=42/>
${answer}
${answer?string} <#-- the same as ${answer} -->
${answer?string.number}
${answer?string.currency}
${answer?string.percent}
${answer}
输出�l�果�?
$42.00
$42.00
42
$42.00
4,200%
3,插值结果�ؓ日期�?�Ҏ��默认格式(�?setting指��o讄��)��表辑ּ��l�果转换成文本输�?可以使用内徏的字�W�串函数格式化单个插�?如下面的例子:
${lastUpdated?string("yyyy-MM-dd HH:mm:ss zzzz")}
${lastUpdated?string("EEE, MMM d, ''yy")}
${lastUpdated?string("EEEE, MMMM dd, yyyy, hh:mm:ss a '('zzz')'")}
输出�l�果�?
2008-04-08 08:08:08 Pacific Daylight Time
Tue, Apr 8, '03
Tuesday, April 08, 2003, 08:08:08 PM (PDT)
4,插值结果�ؓ布尔�?�Ҏ��默认格式(�?setting指��o讄��)��表辑ּ��l�果转换成文本输�?可以使用内徏的字�W�串函数格式化单个插�?如下面的例子:
<#assign foo=true/>
${foo?string("yes", "no")}
输出�l�果�?
yes

2.2 数字格式化插�?/span>

数字格式化插值可采用#{expr;format}形式来格式化数字,其中format可以�?
mX:��数部分最��X�?br /> MX:��数部分最大X�?br /> 如下面的例子:
<#assign x=2.582/>
<#assign y=4/>
#{x; M2} <#-- 输出2.58 -->
#{y; M2} <#-- 输出4 -->
#{x; m2} <#-- 输出2.6 -->
#{y; m2} <#-- 输出4.0 -->
#{x; m1M2} <#-- 输出2.58 -->
#{x; m1M2} <#-- 输出4.0 -->

3, 表达�?/span>

表达式是FreeMarker模板的核心功�?表达式放�|�在插��D��?{}之中�?表明需要输��辑ּ�的�?表达式语法也可与FreeMarker标签�l�合,用于控制输出.实际上FreeMarker的表辑ּ�功能非常强大,它不仅支持直接指定�?输出变量�?也支持字�W�串格式化输出和集合讉K��{�功�?

3.1 直接指定�?/span>

使用直接指定��D��法让FreeMarker直接输出插��g��的�?而不是输出变量�?直接指定值可以是字符�?数�?布尔�?集合和MAP对象.

1,字符�?br /> 直接指定字符串��g��用单引号或双引号限定,如果字符串��g��包含�Ҏ��字符需要�{�?看下面的例子:
${"我的文�g保存在C:\\�?}
${'我名字是\"annlee\"'}
输出�l�果�?
我的文�g保存在C:\�?br /> 我名字是"annlee"

FreeMarker支持如下转义字符:
\";双引�?u0022)
\';单引�?u0027)
\\;反斜�?u005C)
\n;换行(u000A)
\r;回�R(u000D)
\t;Tab(u0009)
\b;退格键(u0008)
\f;Form feed(u000C)
\l;<
\g;>
\a;&
\{;{
\xCode;直接通过4位的16�q�制数来指定Unicode�?输出该unicode码对应的字符.

如果某段文本中包含大量的�Ҏ��W�号,FreeMarker提供了另一�U�特�D�格�?可以在指定字�W�串内容的引号前增加r标记,在r标记后的文�g��会直接输出.看如下代�?
${r"${foo}"}
${r"C:\foo\bar"}
输出�l�果�?
${foo}
C:\foo\bar

2,数�?br /> 表达式中的数值直接输�?不需要引�?��数点��?."分隔,不能使用分组","�W�号.FreeMarker目前�q�不支持�U�学计数�?所�?1E3"是错误的.在FreeMarker表达式中使用数值需要注意以下几�?
1,数��g��能省略小数点前面�?,所�?.5"是错误的写法
2,数�? , +8 , 8.00都是相同�?/p>

3,布尔�?br /> 直接使用true和false,不��用引�?

4,集合
集合以方括号包括,各集合元素之间以英文逗号","分隔,看如下的例子:
<#list ["星期一", "星期�?, "星期�?, "星期�?, "星期�?, "星期�?, "星期�?] as x>
${x}

输出�l�果�?
星期一
星期�?br /> 星期�?br /> 星期�?br /> 星期�?br /> 星期�?br /> 星期�?/p>

除此之外,集合元素也可以是表达�?例子如下:
[2 + 2, [1, 2, 3, 4], "whatnot"]

�q�可以��用数字范围定义数字集�?�?..5�{�同于[2, 3, 4, 5],但是更有效率.注意,使用数字范围来定义集合时无需使用�Ҏ��?数字范围也支持反递增的数字范�?�?..2

5,Map对象
Map对象使用花括号包�?Map中的key-value对之间以英文冒号":"分隔,多组key-value对之间以英文逗号","分隔.下面是一个例�?
{"语文":78, "数学":80}
Map对象的key和value都是表达�?但是key必须是字�W�串

3.2 输出变量�?/span>

FreeMarker的表辑ּ�输出变量�?�q�些变量可以是顶层变�?也可以是Map对象中的变量,�q�可以是集合中的变量,�q�可以��用点(.)语法来访问Java对象的属�?下面分别讨论�q�些情况

1,��层变量
所谓顶层变量就是直接放在数据模型中的�?例如有如下数据模�?
Map root = new HashMap(); //创徏数据模型
root.put("name","annlee"); //name是一个顶层变�?/p>

对于��层变量,直接使用${variableName}来输出变量�?变量名只能是字母,数字,下划�U?$,@�?的组�?且不能以数字开头号.��Z��输出上面的name的�?可以使用如下语法:
${name}

2,输出集合元素
如果需要输出集合元�?则可以根据集合元素的索引来输出集合元�?集合元素的烦引以�Ҏ��h��?假设有烦�?
["星期一","星期�?,"星期�?,"星期�?,"星期�?,"星期�?,"星期�?].该烦引名为week,如果需要输出星期三,则可以��用如下语�?
${week[2]} //输出�W�三个集合元�?/p>

此外,FreeMarker�q�支持返回集合的子集�?如果需要返回集合的子集�?则可以��用如下语�?
week[3..5] //�q�回week集合的子集合,子集合中的元素是week集合中的�W?-6个元�?/p>

3,输出Map元素
�q�里的Map对象可以是直接HashMap的实�?甚至包括JavaBean实例,对于JavaBean实例而言,我们一样可以把其当成属性�ؓkey,属性��gؓvalue的Map实例.��Z��输出Map元素的�?可以使用点语法或�Ҏ��可��?假如有下面的数据模型:
Map root = new HashMap();
Book book = new Book();
Author author = new Author();
author.setName("annlee");
author.setAddress("gz");
book.setName("struts2");
book.setAuthor(author);
root.put("info","struts");
root.put("book", book);

��Z��讉K��数据模型中名为struts2的书的作者的名字,可以使用如下语法:
book.author.name //全部使用点语�?br /> book["author"].name
book.author["name"] //混合使用点语法和�Ҏ��可��?br /> book["author"]["name"] //全部使用�Ҏ��可��?/p>

使用点语法时,变量名字有顶层变量一��L��限制,但方括号语法没有该限�?因�ؓ名字可以是�Q意表辑ּ�的结�?

3.3, 字符串操�?/span>

FreeMarker的表辑ּ�对字�W�串操作非常灉|��,可以��字�W�串帔R��和变量连接�v�?也可以返回字�W�串的子串等.

字符串连接有两种语法:
1,使用${..}�?{..}在字�W�串帔R��部分插入表达式的�?从而完成字�W�串�q�接.
2,直接使用�q�接�q�算�W?来连接字�W�串

例如有如下数据模�?
Map root = new HashMap(); root.put("user","annlee");
下面��user变量和常量连接�v�?
${"hello, ${user}!"} //使用�W�一�U�语法来�q�接
${"hello, " + user + "!"} //使用+��h��q�接
上面的输出字�W�串都是hello,annlee!,可以看出�q�两�U�语法的效果完全一�?

值得注意的是,${..}只能用于文本部分,不能用于表达�?下面的代码是错误�?
<#if ${isBig}>Wow!
<#if "${isBig}">Wow!
应该写成:<#if isBig>Wow!

截取子串可以�Ҏ��字符串的索引来进�?截取子串时如果只指定了一个烦引�?则用于取得字�W�串中指定烦引所对应的字�W?如果指定两个索引�?则返回两个烦引中间的字符串子�?假如有如下数据模�?
Map root = new HashMap(); root.put("book","struts2,freemarker");
可以通过如下语法来截取子�?
${book[0]}${book[4]} //�l�果是su
${book[1..4]} //�l�果是tru

3.4 集合�q�接�q�算�W?/span>

�q�里所说的集合�q�算�W�是��两个集合连接成一个新的集�?�q�接集合的运��符�?,看如下的例子:
<#list ["星期一","星期�?,"星期�?] + ["星期�?,"星期�?,"星期�?,"星期�?] as x>
${x}

输出�l�果�?星期一星期�? 星期�?星期�?星期�?星期�?星期�?/p>

3.5 Map�q�接�q�算�W?/span>

Map对象的连接运��符也是��两个Map对象�q�接成一个新的Map对象,Map对象的连接运��符�?,如果两个Map对象��h��相同的key,则右边的值替代左边的�?看如下的例子:
<#assign scores = {"语文":86,"数学":78} + {"数学":87,"Java":93}>
语文成�W�?{scores.语文}
数学成�W�?{scores.数学}
Java成�W�?{scores.Java}
输出�l�果�?
语文成�W�?6
数学成�W�?7
Java成�W�?3

3.6 ��术�q�算�W?/span>

FreeMarker表达式中完全支持��术�q�算,FreeMarker支持的算术运��符包括:+, - , * , / , % 看如下的代码:
<#assign x=5>
${ x * x - 100 }
${ x /2 }
${ 12 %10 }
输出�l�果�?
-75 2.5 2

在表辑ּ�中��用算术运��符时要注意以下几点:
1,�q�算�W�两边的�q�算数字必须是数�?br /> 2,使用+�q�算�W�时,如果一�Ҏ��数字,一�Ҏ��字符�?��׃��自动��数字�{换�ؓ字符串再�q�接,�?${3 + "5"},�l�果�?35

使用内徏的int函数可对数值取�?�?
<#assign x=5>
${ (x/2)?int }
${ 1.1?int }
${ 1.999?int }
${ -1.1?int }
${ -1.999?int }
�l�果�?2 1 1 -1 -1

3.7 比较�q�算�W?/span>

表达式中支持的比较运��符有如下几�?
1,=或�?=:判断两个值是否相�{?
2,!=:判断两个值是否不�{?
3,>或者gt:判断左边值是否大于右边�?br /> 4,>=或者gte:判断左边值是否大于等于右边�?br /> 5,<或者lt:判断左边值是否小于右边�?br /> 6,<=或者lte:判断左边值是否小于等于右边�?/p>

注意:=�?=可以用于字符�?数值和日期来比较是否相�{?�?�?=两边必须是相同类型的�?否则会��生错�?而且FreeMarker是精��比�?"x","x ","X"是不�{�的.其它的运行符可以作用于数字和日期,但不能作用于字符�?大部分的时�?使用gt�{�字母运��符代替>会有更好的效�?因�ؓFreeMarker会把>解释成FTL标签的结束字�W?当然,也可以��用括��h��避免�q�种情况,�?<#if (x>y)>

3.8 逻辑�q�算�W?/span>

逻辑�q�算�W�有如下几个:
逻辑�?&&
逻辑�?||
逻辑�?!
逻辑�q�算�W�只能作用于布尔�?否则��生错�?/p>

3.9 内徏函数

FreeMarker�q�提供了一些内建函数来转换输出,可以在�Q何变量后紧跟?,?后紧跟内建函�?��可以通过内徏函数来轮换输出变�?下面是常用的内徏的字�W�串函数:
html:对字�W�串�q�行HTML�~�码
cap_first:使字�W�串�W�一个字母大�?br /> lower_case:��字�W�串转换成小�?br /> upper_case:��字�W�串转换成大�?br /> trim:��L��字符串前后的�I�白字符

下面是集合的常用内徏函数
size:获取序列中元素的个数

下面是数字值的常用内徏函数
int:取得数字的整数部�?�l�果带符�?/p>

例如:
<#assign test="Tom & Jerry">
${test?html}
${test?upper_case?html}
�l�果�?Tom & Jerry TOM & JERRY

3.10 �I�值处理运��符

FreeMarker对空值的处理非常严格,FreeMarker的变量必��L��?没有被赋值的变量��׃��抛出异常,因�ؓFreeMarker未赋值的变量强制出错可以杜绝很多潜在的错�?如缺失潜在的变量命名,或者其他变量错�?�q�里所说的�I��?实际上也包括那些�q�不存在的变�?对于一个Java的null��D��言,我们认�ؓ�q�个变量是存在的,只是它的��gؓnull,但对于FreeMarker模板而言,它无法理解null�?null值和不存在的变量完全相同.

��Z��处理�~�失变量,FreeMarker提供了两个运��符:
!:指定�~�失变量的默认�?br /> ??:判断某个变量是否存在

其中,!�q�算�W�的用法有如下两�U?
variable!或variable!defaultValue,�W�一�U�用法不�l�缺��q��变量指定默认�?表明默认值是�I�字�W�串,长度�?的集�?或者长度�ؓ0的Map对象.

使用!指定默认值时,�q�不要求默认值的�c�d��和变量类型相�?使用??�q�算�W�非常简�?它��L��q�回一个布��?用法�?variable??,如果该变量存�?�q�回true,否则�q�回false

3.11 �q�算�W�的优先�U?/span>

FreeMarker中的�q�算�W�优先��如下(由高��C��排列):
1,一元运��符:!
2,内徏函数:?
3,乘除�?*, / , %
4,加减�?- , +
5,比较:> , < , >= , <= (lt , lte , gt , gte)
6,相等:== , = , !=
7,逻辑�?&&
8,逻辑�?||
9,数字范围:..

实际�?我们在开发过�E�中应该使用括号来严格区�?�q�样的可��L��好,出错��?/p>

4 FreeMarker的常用指�?/span>

FreeMarker的FTL指��o也是模板的重要组成部�?�q�些指��o可实现对数据模型所包含数据的抚今�P�?分支控制.除此之外,�q�有一些重要的功能,也是通过FTL指��o来实现的.

4.1 if指��o

�q�是一个典型的分支控制指��o,该指令的作用完全�c�M��于Java语言中的if,if指��o的语法格式如�?
<#if condition>...
<#elseif condition>...
<#elseif condition>...
<#else> ...

例子如下:
<#assign age=23>
<#if (age>60)>老年�?br /> <#elseif (age>40)>中年�?br /> <#elseif (age>20)>青年�?br /> <#else> ��年�?br />
输出�l�果�?青年�?br /> 上面的代码中的逻辑表达式用括号括�v来主要是因�ؓ里面�?gt;�W�号,�׃��FreeMarker会将>�W�号当成标签的结束字�W?可能��D��E�序出错,��Z��避免�q�种情况,我们应该在凡是出现这些符��L��地方都��用括�?

4.2 switch , case , default , break指��o

�q�些指��o昄��是分支指�?作用�c�M��于Java的switch语句,switch指��o的语法结构如�?
<#switch value>
<#case refValue>...<#break>
<#case refValue>...<#break>
<#default>...

4.3 list, break指��o

list指��o是一个�P代输出指�?用于�q�代输出数据模型中的集合,list指��o的语法格式如�?
<#list sequence as item>
...

上面的语法格式中,sequence��是一个集合对�?也可以是一个表辑ּ�,但该表达式将�q�回一个集合对�?而item是一个�Q意的名字,��是被�P代输出的集合元素.此外,�q�代集合对象�?�q�包含两个特�D�的循环变量:
item_index:当前变量的烦引�?br /> item_has_next:是否存在下一个对�?br /> 也可以��?lt;#break>指��o跛_��q�代

例子如下:
<#list ["星期一", "星期�?, "星期�?, "星期�?, "星期�?, "星期�?, "星期�?] as x>
${x_index + 1}.${x}<#if x_has_next>,
<#if x="星期�?><#break>

4.4 include指��o

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

4.5 import指��o

该指令用于导入FreeMarker模板中的所有变�?�q�将该变量放�|�在指定的Map对象�?import指��o的语法格式如�?
<#import "/lib/common.ftl" as com>
上面的代码将导入/lib/common.ftl模板文�g中的所有变�?交将�q�些变量攄��在一个名为com的Map对象�?

4.6 noparse指��o

noparse指��o指定FreeMarker不处理该指定里包含的内容,该指令的语法格式如下:
<#noparse>...

看如下的例子:
<#noparse>
<#list books as book>

${book.name}

作�?${book.author}

输出如下:
<#list books as book>

${book.name}

作�?${book.author}

4.7 escape , noescape指��o

escape指��o��D��body区的插值都会被自动加上escape表达�?但不会媄响字�W�串内的插�?只会影响到body内出现的插�?使用escape指��o的语法格式如�?
<#escape identifier as expression>...
<#noescape>...

看如下的代码:
<#escape x as x?html>
First name:${firstName}
Last name:${lastName}
Maiden name:${maidenName}

上面的代码等同于:
First name:${firstName?html}
Last name:${lastName?html}
Maiden name:${maidenName?html}

escape指��o在解析模板时起作用而不是在�q�行时�v作用,除此之外,escape指��o也嵌套��?子escape�l�承父escape的规�?如下例子:
<#escape x as x?html>
Customer Name:${customerName}
Items to ship;
<#escape x as itemCodeToNameMap[x]>
   ${itemCode1}
   ${itemCode2}
   ${itemCode3}
   ${itemCode4}

上面的代码类��g��:
Customer Name:${customerName?html}
Items to ship;
${itemCodeToNameMap[itemCode1]?html}
${itemCodeToNameMap[itemCode2]?html}
${itemCodeToNameMap[itemCode3]?html}
${itemCodeToNameMap[itemCode4]?html}

对于攑֜�escape指��o中所有的插��D��言,�q�此插值将被自动加上escape表达�?如果需要指定escape指��o中某些插值无需��d��escape表达�?则应该��用noescape指��o,攑֜�noescape指��o中的插值将不会��d��escape表达�?

4.8 assign指��o

assign指��o在前面已�l��用了多次,它用于�ؓ该模杉K��面创建或替换一个顶层变�?assign指��o的用法有多种,包含创徏或替换一个顶层变�?或者创建或替换多个变量�{?它的最��单的语法如下:<#assign name=value [in namespacehash]>,�q�个用法用于指定一个名为name的变�?该变量的��gؓvalue,此外,FreeMarker允许在��用assign指��o里增加in子句,in子句用于��创建的name变量攑օ�namespacehash命名�I�间�?

assign指��o�q�有如下用法:<#assign name1=value1 name2=value2 ... nameN=valueN [in namespacehash]>,�q�个语法可以同时创徏或替换多个顶层变�?此外,�q�有一�U�复杂的用法,如果需要创建或替换的变量值是一个复杂的表达�?则可以��用如下语法格�?<#assign name [in namespacehash]>capture this,在这个语法中,是指��assign指��o的内容赋值给name变量.如下例子:
<#assign x>
<#list ["星期一", "星期�?, "星期�?, "星期�?, "星期�?, "星期�?, "星期�?] as n>
${n}

${x}
上面的代码将产生如下输出:星期一星期�?星期�?星期�?星期�?星期�?星期�?/p>

虽然assign指定了这�U�复杂变量值的用法,但是我们也不要滥用这�U�用�?如下例子:<#assign x>Hello ${user}!,以上代码改�ؓ如下写法更合�?<#assign x="Hello ${user}!">

4.9 setting指��o

该指令用于设�|�FreeMarker的运行环�?该指令的语法格式如下:<#setting name=value>,在这个格式中,name的取��D��围包含如下几�?
locale:该选项指定该模板所用的国家/语言选项
number_format:指定格式化输出数字的格式
boolean_format:指定两个布尔值的语法格式,默认值是true,false
date_format,time_format,datetime_format:指定格式化输出日期的格式
time_zone:讄��格式化输出日期时所使用的时�?/p>

4.10 macro , nested , return指��o

macro可以用于实现自定义指�?通过使用自定义指�?可以��一�D�|��板片�D�定义成一个用��h��?使用macro指��o的语法格式如�?
<#macro name param1 param2 ... paramN>
...
<#nested loopvar1, loopvar2, ..., loopvarN>
...
<#return>
...

在上面的格式片段�?包含了如下几个部�?
name:name属性指定的是该自定义指令的名字,使用自定义指令时可以传入多个参数
paramX:该属性就是指定��用自定义指��o时报参数,使用该自定义指��o�?必须��些参��C��入�?br /> nested指��o:nested标签输出使用自定义指令时的中间部�?br /> nested指��o中的循环变量:�q�此循环变量��由macro定义部分指定,传给使用标签的模�?br /> return指��o:该指令可用于随时�l�束该自定义指��o.

看如下的例子:
<#macro book> //定义一个自定义指��o
j2ee

<@book /> //使用刚才定义的指�?br /> 上面的代码输出结果�ؓ:j2ee

在上面的代码�?可能很难看出自定义标�{��用处,因�ؓ我们定义的book指��o所包含的内定w��常简�?实际�?自定义标�{�֏�包含非常多的内容,从而可以实现更好的代码复用.此外,�q�可以在定义自定义指令时,��定义指��o指定参数,看如下代�?
<#macro book booklist>     //定义一个自定义指��obooklist是参�?br /> <#list booklist as book>
   ${book}

<@book booklist=["spring","j2ee"] />   //使用刚刚定义的指�?br /> 上面的代码�ؓbook指��o传入了一个参数�?上面的代码的输出�l�果�?spring j2ee

不仅如此,�q�可以在自定义指令时使用nested指��o来输��定义指��o的中间部�?看如下例�?
<#macro page title>

FreeMarker�C�Z��面 - ${title?html}

${title?html}

<#nested> //用于引入用户自定义指令的标签�?br />

上面的代码将一个HTML��面模板定义成一个page指��o,则可以在其他��面中如此page指��o:
<#import "/common.ftl" as com> //假设上面的模杉K��面名为common.ftl,导入��面
<@com.page title="book list">

spring

j2ee

</@com.page>

从上面的例子可以看出,使用macro和nested指��o可以非常�Ҏ��地实现页面装饰效�?此外,�q�可以在使用nested指��o�?指定一个或多个循环变量,看如下代�?
<#macro book>
<#nested 1> //使用book指��o时指定了一个��@环变量�?br /> <#nested 2>

<@book ;x> ${x} .图书</@book>
当��用nested指��o传入变量值时,在��用该自定义指令时,��需要��用一个占位符(如book指��o后的;x).上面的代码输出文本如�?
1 .图书 2 .图书

在nested指��o中��用��@环变量时,可以使用多个循环变量,看如下代�?
<#macro repeat count>
<#list 1..count as x>     //使用nested指��o时指定了三个循环变量
   <#nested x, x/2, x==count>

<@repeat count=4 ; c halfc last>
${c}. ${halfc}<#if last> Last!
</@repeat>
上面的输出结果�ؓ:
1. 0.5   2. 1   3. 1.5   4. 2 Last;

return指��o用于�l�束macro指��o,一旦在macro指��o中执行了return指��o,则FreeMarker不会�l�箋处理macro指��o里的内容,看如下代�?
<#macro book>
spring
<#return>
j2ee

<@book />
上面的代码输�?spring,而j2ee位于return指��o之后,不会输出.

Gavin.lee 2009-06-26 15:59 发表评论

亚洲国产成人手机在线观看 ,亚洲欧美日韩综合久久久久,国产成人精品日本亚洲语音

FreeMarker 字符串的截取

巧用Freemarker的自定义�Ҏ��

Some test

Some test

<@bean.message key="welcome.title"/>

FreeMarker 中常见的 StringIndexOutOfBoundsException

500 Servlet Exception

FreeMarker 中最常见�?undefined

500 Servlet Exception

Welcome ${user} !

${title?html}