海浪今天为大家介绍FreeMarker基本语法详解以及模板文件的组成。
页面复杂多少,FreeMarker模板文件主要由如下4个部分组成:
直接输出的部分2. 注释:<#– … –>格式部分,不会输出3. 插值:即${…}或#{…}格式的部分,将使用数据模型中的部分替代输出4. FTL指令:FreeMarker指定,和HTML标记类似,名字前加#予以区分,不会输出
下面是一个FreeMarker模板的例子,包含了以上所说的4个部分<html><br><head><br><title>Welcome!</title><br></head><br><body><br><#– 注释部分 –><br><#– 下面使用插值 –><h1>Welcome ${user} !</h1><br><p>We have these animals:<br><u1><br><#– 使用FTL指令 –><#list animals as being><br> <li>${being.name} for ${being.price} Euros<br><#list><br><u1><br></body><br></html>
在FreeMarker中,使用FTL标签来使用指令,FreeMarker有3种FTL标签,这和HTML标签是完全类似的.1,开始标签:<#directivename parameter>2,结束标签:</#directivename>3,空标签:<#directivename parameter/>
实际上,使用标签时前面的符号#也可能变成@,如果该指令是一个用户指令而不是系统内建指令时,应将#符号改成@符号.使用FTL标签时,应该有正确的嵌套,而不是交叉使用,这和XML标签的用法完全一样.如果全用不存在的指令,FreeMarker不会使用模板输出,而是产生一个错误消息.FreeMarker会忽略FTL标签中的空白字符.值得注意的是< , /> 和指令之间不允许有空白字符.
FreeMarker的插值有如下两种类型:1,通用插值${expr};2,数字格式化插值:#{expr}或#{expr;format}
对于通用插值,又可以分为以下4种情况:1,插值结果为字符串值:直接输出表达式结果2,插值结果为数字值:根据默认格式(由#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.0042$42.004,200%3,插值结果为日期值:根据默认格式(由#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 TimeTue, Apr 8, ’03Tuesday, April 08, 2003, 08:08:08 PM (PDT)4,插值结果为布尔值:根据默认格式(由#setting指令设置)将表达式结果转换成文本输出.可以使用内建的字符串函数格式化单个插值,如下面的例子:<#assign foo=true/>${foo?string(“yes”, “no”)}输出结果是:yes
因为你的喜爱会挡也挡不住地流露出来。
