FreeMarker标签.doc
文本预览下载声明
一、FreeMarker模板文件主要有4个部分组成
1、文本，直接输出的部分
2、注释，即#--...--格式不会输出
3、插值（Interpolation）：即${..}或者#{..}格式的部分,将使用数据模型中的部分替代输出
4、FTL指令：FreeMarker指令，和HTML标记类似，名字前加#予以区分，不会输出。
FTL指令规则
FreeMarker有三种FTL标签，这和HTML的标签是完全类似的
开始标签：#directivename parameters
结束标签：/#directivename
空标签： #directivename parameters /
实际上，使用标签时前面的#符号也可能变成@，如果该指令是一个用户指令而不是系统内建指令时，应将#符号改为@符号
插值规则
FreeMarker的插值有如下两种类型
1、通用插值：${expr}
2、数字格式化插值：#{expr}或者#{expr;format}
通用插值，有可以分为四种情况
a、插值结果为字符串值：直接输出表达式结果
b、插值结果为数字值：根据默认格式(#setting 指令设置)将表达式结果转换成文本输出。可以使用内建的字符串函数格式单个插值，例如
#setting number_format = currency /
#assign price = 42 /
${price}
${price?string}
${price?string.number}
${price?string.currency}
${price?string.percent}
c、输出值为日期值：根据默认格式(由 #setting 指令设置)将表达式结果转换成文本输出，可以使用内建的字符串函数格式化单个插值，例如
#assign lastUpdated = 2009-01-07 15:05?datetime(yyyy-MM-dd HH:mm) /
${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))};
${lastUpdated?string.short};
${lastUpdated?string.long};
${lastUpdated?String.full};
d、插值结果为布尔值
#assign foo=true /
${foo?string(是foo,非foo)}
数字格式化插值
数字格式化插值可采用#{expr;format}的形式来格式化数字，其中format可以是：
mX:小数部分最小X位
MX:小数部分最大X位
例如：
#assign x = 2.582 /
#assign y =4 /
#{x;M2};
#{y;M2};
#{x;m1};
#{y;m1};
#{x;m1M2};
#{y:m1M2};
二、表达式
表达式是FreeMarker的核心功能。表达式放置在插值语法（${...}）之中时，表面需要输出表达式的值，表达式语法也可以与FreeMarker标签结合，用于控制输出
1、直接指定值
例如：
a、字符串
${我的名字是\yeek\};
${我的文件保存在d：\\盘};
b、数值
c、布尔值
d、日期型
FreeMarker支持date、time、datetime三种类型，这三种类型的值无法直接指定，通常需要借助字符串的date、time、datetime三个内建函数进行转换才可以
#assign test1 = 2009-01-22?date(yyyy-MM-dd) /;
#assign test2 =16:34:43?time(HH:mm:ss) /
显示全部