<#list> 

第二篇FreeMarker规则

1.FTL指令规则 

在FreeMarker中,使用FTL标签来使用指令,FreeMarker有3种FTL标签,这和HTML标签是完全类似的. 

●开始标签:

<#directivenameparameter> 

●结束标签:

●空标签:

<#directivenameparameter/> 

实际上,使用标签时前面的符号#也可能变成@,如果该指令是一个用户指令而不是系统内建指令时,应将#符号改成@符号. 

使用FTL标签时,应该有正确的嵌套,而不是交叉使用,这和XML标签的用法完全一样.如果全用不存在的指令,FreeMarker不会使用模板输出,而是产生一个错误消息.FreeMarker会忽略FTL标签中的空白字符.值得注意的是<,/>和指令之间不允许有空白字符. 

2.插值规则 

FreeMarker的插值有如下两种类型:

1,通用插值${expr};2,数字格式化插值:

#{expr}或#{expr;format} 

2.1.通用插值 

对于通用插值,又可以分为以下4种情况:

●插值结果为字符串值:

直接输出表达式结果 

●插值结果为数字值:

根据默认格式（由#setting指令设置）将表达式结果转换成文本输出.可以使用内建的字符串函数格式化单个插值,如下面的例子:

<#settionnumber_format="currency"/> 

<#assignanswer=42/> 

${answer} 

${answer?

string}<#--thesameas${answer}--> 

${answer?

string.number} 

${answer?

string.currency} 

${answer?

string.percent} 

${answer} 

输出结果是:

$42.00 

$42.00 

42 

$42.00 

4,200% 

●插值结果为日期值:

根据默认格式（由#setting指令设置）将表达式结果转换成文本输出.可以使用内建的字符串函数格式化单个插值,如下面的例子:

${lastUpdated?

string（"yyyy-MM-ddHH:

mm:

sszzzz"）} 

${lastUpdated?

string（"EEE,MMMd,''yy"）} 

${lastUpdated?

string（"EEEE,MMMMdd,yyyy,hh:

mm:

ssa'（'zzz'）'"）} 

输出结果是:

2008-04-0808:

08:

08PacificDaylightTime 

Tue,Apr8,'03 

Tuesday,April08,2003,08:

08:

08PM（PDT） 

●插值结果为布尔值:

根据默认格式（由#setting指令设置）将表达式结果转换成文本输出.可以使用内建的字符串函数格式化单个插值,如下面的例子:

<#assignfoo=true/> 

${foo?

string（"yes","no"）} 

输出结果是:

yes

2.2.数字格式化插值 

数字格式化插值可采用#{expr;format}形式来格式化数字,其中format可以是:

mX:

小数部分最小X位 

MX:

小数部分最大X位 

如下面的例子:

<#assignx=2.582/> 

<#assigny=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.表达式 

表达式是FreeMarker模板的核心功能,表达式放置在插值语法${}之中时,表明需要输出表达式的值;表达式语法也可与FreeMarker标签结合,用于控制输出.实际上FreeMarker的表达式功能非常强大,它不仅支持直接指定值,输出变量值,也支持字符串格式化输出和集合访问等功能. 

3.1.直接指定值 

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

3.1.1.字符串 

直接指定字符串值使用单引号或双引号限定,如果字符串值中包含特殊字符需要转义,看下面的例子:

${"我的文件保存在C:

\\盘"} 

${'我名字是\"annlee\"'} 

输出结果是:

我的文件保存在C:

\盘 

我名字是"annlee" 

FreeMarker支持如下转义字符:

\";双引号（u0022） 

\';单引号（u0027） 

\\;反斜杠（u005C） 

\n;换行（u000A） 

\r;回车（u000D） 

\t;Tab（u0009） 

\b;退格键（u0008） 

\f;Formfeed（u000C） 

\l;< 

\g;> 

\a;& 

\{;{ 

\xCode;直接通过4位的16进制数来指定Unicode码,输出该unicode码对应的字符. 

如果某段文本中包含大量的特殊符号,FreeMarker提供了另一种特殊格式:

可以在指定字符串内容的引号前增加r标记,在r标记后的文件将会直接输出.看如下代码:

${r"${foo}"} 

${r"C:

\foo\bar"} 

输出结果是:

${foo} 

C:

\foo\bar 

3.1.2.数值 

表达式中的数值直接输出,不需要引号.小数点使用"."分隔,不能使用分组","符号.FreeMarker目前还不支持科学计数法,所以"1E3"是错误的.在FreeMarker表达式中使用数值需要注意以下几点:

●数值不能省略小数点前面的0,所以".5"是错误的写法 

●数值8,+8,8.00都是相同的 

3.1.3.布尔值 

直接使用true和false,不使用引号. 

3.1.4.集合 

集合以方括号包括,各集合元素之间以英文逗号","分隔,看如下的例子:

<#list["星期一","星期二","星期三","星期四","星期五","星期六","星期天"]asx> 

${x} 

输出结果是:

星期一 

星期二 

星期三 

星期四 

星期五 

星期六 

星期天 

除此之外,集合元素也可以是表达式,例子如下:

[2+2,[1,2,3,4],"whatnot"] 

还可以使用数字范围定义数字集合,如2..5等同于[2,3,4,5],但是更有效率.注意,使用数字范围来定义集合时无需使用方括号,数字范围也支持反递增的数字范围,如5..2 

3.1.5.对象 

Map对象使用花括号包括,Map中的key-value对之间以英文冒号":

"分隔,多组key-value对之间以英文逗号","分隔.下面是一个例子:

{"语文":

78,"数学":

80} 

Map对象的key和value都是表达式,但是key必须是字符串 

3.2.输出变量值 

FreeMarker的表达式输出变量时,这些变量可以是顶层变量,也可以是Map对象中的变量,还可以是集合中的变量,并可以使用点（.）语法来访问Java对象的属性.下面分别讨论这些情况 

3.2.1.顶层变量 

所谓顶层变量就是直接放在数据模型中的值,例如有如下数据模型:

Maproot=newHashMap（）;  //创建数据模型 

root.put（"name","annlee"）;  //name是一个顶层变量 

对于顶层变量,直接使用${variableName}来输出变量值,变量名只能是字母,数字,下划线,$,@和#的组合,且不能以数字开头号.为了输出上面的name的值,可以使用如下语法:

${name} 

3.2.2.输出集合元素 

如果需要输出集合元素,则可以根据集合元素的索引来输出集合元素,集合元素的索引以方括号指定.假设有索引:

["星期一","星期二","星期三","星期四","星期五","星期六","星期天"].该索引名为week,如果需要输出星期三,则可以使用如下语法:

${week[2]}  //输出第三个集合元素 

此外,FreeMarker还支持返回集合的子集合,如果需要返回集合的子集合,则可以使用如下语法:

week[3..5]  //返回week集合的子集合,子集合中的元素是week集合中的第4-6个元素 

3.2.3.输出Map元素 

这里的Map对象可以是直接HashMap的实例,甚至包括JavaBean实例,对于JavaBean实例而言,我们一样可以把其当成属性为key,属性值为value的Map实例.为了输出Map元素的值,可以使用点语法或方括号语法.假如有下面的数据模型:

Maproot=newHashMap（）; 

Bookbook=newBook（）; 

Authorauthor=newAuthor（）; 

author.setName（"annlee"）; 

author.setAddress（"gz"）; 

book.setName（"struts2"）; 

book.setAuthor（author）; 

root.put（"info","struts"）; 

root.put（"book",book）; 

为了访问数据模型中名为struts2的书的作者的名字,可以使用如下语法:

book.author.name   //全部使用点语法 

book["author"].name 

book.author["name"]   //混合使用点语法和方括号语法 

book["author"]["name"]  //全部使用方括号语法 

使用点语法时,变量名字有顶层变量一样的限制,但方括号语法没有该限制,因为名字可以是任意表达式的结果. 

3.3.字符串操作 

FreeMarker的表达式对字符串操作非常灵活,可以将字符串常量和变量连接起来,也可以返回字符串的子串等.