《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) /