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.0 --?表达式?表达式是FreeMarker模板的核心功能,表达式放置在插值语法${}之中时,表明需要输出表达式的值;表达式语法也可与FreeMarker 标