FreeMarker手册.docx

FreeMarker教程 第一篇 FreeMarker模板 模板文件 FreeMarker的模板文件并不比HTML页面复杂多少,FreeMarker模板文件主要由如下4个部分组成:? 文本:直接输出的部分? 注释:#-- ... --格式部分,不会输出? 插值:即${...}或#{...}格式的部分,将使用数据模型中的部分替代输出? FTL指令:FreeMarker指定,和HTML标记类似,名字前加#予以区分,不会输出? 下面是一个FreeMarker模板的例子,包含了以上所说的4个部分? html? head? titleWelcome!/title? /head? body? #-- 注释部分 --? #-- 下面使用插值 --? h1Welcome ${user} !/h1? pWe have these animals:? u1? #-- 使用FTL指令 --? #list animals as being? ?? li${} for ${being.price} Euros? #list? u1? /body? /html 第二篇 FreeMarker规则 FTL指令规则? 在FreeMarker中,使用FTL标签来使用指令,FreeMarker有3种FTL标签,这和HTML标签是完全类似的.? 开始标签:#directivename parameter? 结束标签:/#directivename? 空标签:#directivename parameter/? 实际上,使用标签时前面的符号#也可能变成@,如果该指令是一个用户指令而不是系统内建指令时,应将#符号改成@符号.? 使用FTL标签时, 应该有正确的嵌套,而不是交叉使用,这和XML标签的用法完全一样.如果全用不存在的指令,FreeMarker不会使用模板输出,而是产生一个错误消息.FreeMarker会忽略FTL标签中的空白字符.值得注意的是 , / 和指令之间不允许有空白字符.? 插值规则? FreeMarker的插值有如下两种类型:1,通用插值${expr};2,数字格式化插值:#{expr}或#{expr;format}? 通用插值? 对于通用插值,又可以分为以下4种情况:? 插值结果为字符串值:直接输出表达式结果? 插值结果为数字值:根据默认格式(由#setting指令设置)将表达式结果转换成文本输出.可以使用内建的字符串函数格式化单个插值,如下面的例子:? #settion number_format=currency/? #assign answer=42/? ${answer}? ${answer?string} #-- the same as ${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-dd HH:mm:ss zzzz)}? ${lastUpdated?string(EEE, MMM d, yy)}? ${lastUpdated?string(EEEE, MMMM dd, yyyy, hh:mm:ss a (zzz))}? 输出结果是:? 2008-04-08 08:08:08 Pacific Daylight Time? Tue, Apr 8, 03? Tuesday, April 08, 2003, 08:08:08 PM (PDT)? 插值结果为布尔值:根据默认格式(由#setting指令设置)将表达式结果转换成文本输出.可以使用内建的字符串函数格式化单个插值,如下面的例子:? #assign foo=true/? ${foo?string(yes, no)}? 输出结果是:? yes 数字格式化插值? 数字格式化插值可采用#{expr;format}形式来格式化数字,其中format可以是:? mX:小数部分最小X位? MX:小数部分最大X位? 如下面的例子:? #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