freemarker - 基础知识.doc

Freemarker 模板 + 数据模型 = 输出 注释： 包含在#--和--（而不是!--和--）之间。 FTL标记 FTL标记（FreeMarker模板语言标记）：类似于HTML标记，为了与HTML标记区分，用#开始（有些以@开始，在后面叙述）。如下： #if abc=”abc”abc/#if 或者 [#if abc=”abc”]abc[/#if] 注意：一个模板内容只能一种标记，即尖括号（）和中括号（[]）不能同时使用。 ${…} ${…}：称为interpolations，FreeMarker会在输出时用实际值进行替代。 基本常识 FTL区分大小写 所以list是正确的FTL指令，而List不是；${name}和${NAME}是不同的。 FTL标记不能够交叉，而应该正确的嵌套 如下面的代码是错误的： ul #list animals as being ? li${} for ${being.price} Euros ? #if use = Big Joe ???? (except for you) /#list /#if #-- WRONG! -- /ul? 如果使用不存在的指令，FreeMarker不会使用模板输出，而是产生一个错误消息。为了避免这样的错，可使用默认值，有两种方法，如下： ${user?default(123)} ${user!123} 如果要输出bean.createTime时间，并且格式是“yyyy-MM-dd”。 ${bean.beginDate?string(yyyy-MM-dd)}//如果空值的话会报错！ //如何判断如果为空则不输出，如果不为空输出yyyy-MM-dd格式 判断存在与否exists [#list list as teacher] [#if teacher.sex?exists teacher.sex50] 姓名：${} 是老人家br/ [/#if] [/#list] 空内容指令标记：#directivename parameters/ 预定义指令和用户定义指令 预定义指令用#，用户定义指令用@ 预定义指令 if指令 list指令 pWe have these animals: table border=1 ? trthNamethPrice ? #list animals as being ? trtd${}td${being.price} Euros ? /#list /table? 输出为： pWe have these animals: table border=1 ? trthNamethPrice ? trtdmousetd50 Euros ? trtdelephanttd5000 Euros ? trtdpythontd4999 Euros /table? include指令 用户定义指令 用户定义指令要使用@替换#，如@mydirective.../@mydirective。 宏和变换器变量是两种不同类型的用户定义指令，它们之间的区别是宏是在模板中使用指令定义，而变换器是在模板外由程序定义，这里只介绍宏宏是和某个变量关联的模板片断，以便在模板中通过用户定义指令使用该变量，下面是一个例子： ? font size=+2Hello Joe!/font /#macro? 作为用户定义指令使用宏变量时，使用替代标记中的 @greet/@greet 如果没有体内容，也可以使用： 详细请看：专题“用户定义指令：宏” 转义 使用单引号或双引号限定字符串，如果包含特殊字符需要转义则使用反斜杠(\) ${Its \quoted\ and this is a backslash: \\} ? ${It\s quoted and this is a backslash: \\}? 输出结果是： Its quoted and this is a backslash: \ ? Its quoted and this is a backslash: \? 下面是支持的转义序列： 转义序列 含义 \ 双引号(u0022) \ 单引号(u0027) \\ 反斜杠(u005C) \n 换行(u000A) \r Return (u000D) \t Tab (u0009) \b Backspace (u0008) \f Form feed (u000C) \l \g \a \{ { \xCode 4位16进制Unicode代码 有一类特殊的字符串称为raw字符串，被认为是纯文本，其中的\和{等不具有特殊含义，要输出该类字符串需要在引号前面加r，下面是一个例子： ${r${foo}} ${rC:\foo\bar}? 输出的