freemarkermacro(宏)的使用
- 格式:doc
- 大小:30.50 KB
- 文档页数:7
FreeMarker概述●FreeMarker是一个模板引擎,一个基于模板生成文本输出的通用工具,使用纯Java编写●FreeMarker被设计用来生成HTML Web页面,特别是基于MVC模式的应用程序●虽然FreeMarker具有一些编程的能力,但通常由Java程序准备要显示的数据,由FreeMarker生成页面,通过模板显示准备的数据(如下图)●FreeMarker不是一个Web应用框架,而适合作为Web应用框架一个组件●FreeMarker与容器无关,因为它并不知道HTTP或Servlet;FreeMarker同样可以应用于非Web应用程序环境●FreeMarker更适合作为Model2框架(如Struts)的视图组件,你也可以在模板中使用JSP标记库●FreeMarker是免费的1、通用目标●能够生成各种文本:HTML、XML、RTF、Java源代码等等●易于嵌入到你的产品中:轻量级;不需要Servlet环境●插件式模板载入器:可以从任何源载入模板,如本地文件、数据库等等●你可以按你所需生成文本:保存到本地文件;作为Email发送;从Web应用程序发送它返回给Web浏览器2、强大的模板语言●所有常用的指令:include、if/elseif/else、循环结构●在模板中创建和改变变量●几乎在任何地方都可以使用复杂表达式来指定值●命名的宏,可以具有位置参数和嵌套内容●名字空间有助于建立和维护可重用的宏库,或者将一个大工程分成模块,而不必担心名字冲突●输出转换块:在嵌套模板片段生成输出时,转换HTML转义、压缩、语法高亮等等;你可以定义自己的转换3、通用数据模型●FreeMarker不是直接反射到Java对象,Java对象通过插件式对象封装,以变量方式在模板中显示●你可以使用抽象(接口)方式表示对象(JavaBean、XML文档、SQL查询结果集等等),告诉模板开发者使用方法,使其不受技术细节的打扰4、为Web准备●在模板语言中内建处理典型Web相关任务(如HTML转义)的结构●能够集成到Model2 Web应用框架中作为JSP的替代●支持JSP标记库●为MVC模式设计:分离可视化设计和应用程序逻辑;分离页面设计员和程序员5、智能的国际化和本地化●字符集智能化(内部使用UNICODE)●数字格式本地化敏感●日期和时间格式本地化敏感●非US字符集可以用作标识(如变量名)●多种不同语言的相同模板6、强大的XML处理能力●<#recurse> 和<#visit>指令(2.3版本)用于递归遍历XML树●在模板中清楚和直觉的访问XML对象模型FreeMarker设计指南(1)1、快速入门(1)模板+ 数据模型= 输出●FreeMarker基于设计者和程序员是具有不同专业技能的不同个体的观念●他们是分工劳动的:设计者专注于表示——创建HTML文件、图片、Web页面的其它可视化方面;程序员创建系统,生成设计页面要显示的数据●经常会遇到的问题是:在Web页面(或其它类型的文档)中显示的信息在设计页面时是无效的,是基于动态数据的●在这里,你可以在HTML(或其它要输出的文本)中加入一些特定指令,FreeMarker会在输出页面给最终用户时,用适当的数据替代这些代码●下面是一个例子:●这个例子是在简单的HTML中加入了一些由${…}包围的特定代码,这些特定代码是FreeMarker的指令,而包含FreeMarker的指令的文件就称为模板(Template)●至于user、latestProduct.url和来自于数据模型(data model)●数据模型由程序员编程来创建,向模板提供变化的信息,这些信息来自于数据库、文件,甚至于在程序中直接生成●模板设计者不关心数据从那儿来,只知道使用已经建立的数据模型●下面是一个可能的数据模型:●数据模型类似于计算机的文件系统,latestProduct可以看作是目录,而user、url和name看作是文件,url和name文件位于latestProduct目录中(这只是一个比喻,实际并不存在)●当FreeMarker将上面的数据模型合并到模板中,就创建了下面的输出:(2)数据模型典型的数据模型是树型结构,可以任意复杂和深层次,如下面的例子:●类似于文件的变量称为scalars,保存单值●scalars保存的值有两种类型:字符串(用引号括起,可以是单引号或双引号)和数字(不要用引号将数字括起,这会作为字符串处理)●对scalars的访问从root开始,各部分用“.”分隔,如animals.mouse.price●另外一种变量是sequences,和hashes类似,只是不使用变量名字,而使用数字索引,如下面的例子:(3)模板●在FreeMarker模板中可以包括下面三种特定部分:➢${…}:称为interpolations,FreeMarker会在输出时用实际值进行替代➢FTL标记(FreeMarker模板语言标记):类似于HTML标记,为了与HTML 标记区分,用#开始(有些以@开始,在后面叙述)➢注释:包含在<#--和-->(而不是<!--和-->)之间●下面是一些使用指令的例子:➢if指令➢list指令输出为:3、模板(1)整体结构●模板使用FTL(FreeMarker模板语言)编写,是下面各部分的一个组合:➢文本:直接输出➢Interpolation:由${和},或#{和}来限定,计算值替代输出➢FTL标记:FreeMarker指令,和HTML标记类似,名字前加#予以区分,不会输出➢注释:由<#--和-->限定,不会输出●下面是以一个具体模板例子:●注意事项:➢FTL区分大小写,所以list是正确的FTL指令,而List不是;${name}和${NAME}是不同的➢Interpolation只能在文本中使用➢FTL标记不能位于另一个FTL标记内部,例如:(2)指令●在FreeMarker中,使用FTL标记引用指令●有三种FTL标记,这和HTML标记是类似的:➢开始标记:<#directivename parameters>➢结束标记:</#directivename>➢空内容指令标记:<#directivename parameters/>●有两种类型的指令:预定义指令和用户定义指令●用户定义指令要使用@替换#,如<@mydirective>...</@mydirective>(会在后面讲述)●FTL标记不能够交叉,而应该正确的嵌套,如下面的代码是错误的:●FreeMarker会忽略FTL标记中的空白字符,如下面的例子:(3)表达式●直接指定值➢字符串⏹使用单引号或双引号限定⏹如果包含特殊字符需要转义,如下面的例子:输出结果是:转义序列含义\"双引号(u0022)\'单引号(u0027)\\反斜杠(u005C)\n换行(u000A)\r Return (u000D)\t Tab (u0009)\b Backspace (u0008)\f Form feed (u000C)\l<\g>\a&\{{\x Code4位16进制Unicode代码⏹有一类特殊的字符串称为raw字符串,被认为是纯文本,其中的\和{等不具有特殊含义,该类字符串在引号前面加r,下面是一个例子:⏹直接输入,不需要引号⏹精度数字使用“.”分隔,不能使用分组符号⏹目前版本不支持科学计数法,所以“1E3”是错误的⏹不能省略小数点前面的0,所以“.5”是错误的⏹数字8、+8、08和8.00都是相同的➢布尔值⏹true和false,不使用引号➢序列⏹由逗号分隔的子变量列表,由方括号限定,下面是一个例子:输出的结果是:⏹可以使用数字范围定义数字序列,例如2..5等同于[2, 3, 4, 5],但是更有效率,注意数字范围没有方括号⏹可以定义反递增的数字范围,如5..2➢散列(hash)⏹由逗号分隔的键/值列表,由大括号限定,键和值之间用冒号分隔,下面是一个例子:●获取变量➢顶层变量: ${variable},变量名只能是字母、数字、下划线、$、@和#的组合,且不能以数字开头➢从散列中获取数据⏹可以使用点语法或方括号语法,假设有下面的数据模型:下面都是等价的:因为名字是任意表达式的结果➢从序列获得数据:和散列的方括号语法语法一样,只是方括号中的表达式值必须是数字;注意:第一个项目的索引是0➢序列片断:使用[startIndex..endIndex]语法,从序列中获得序列片断(也是序列);startIndex和endIndex是结果为数字的表达式➢特殊变量:FreeMarker内定义变量,使用.variablename语法访问●字符串操作➢Interpolation(或连接操作)⏹可以使用${..}(或#{..})在文本部分插入表达式的值,例如:⏹可以使用+操作符获得同样的结果⏹${..}只能用于文本部分,下面的代码是错误的:应该写成:➢子串⏹例子(假设user的值为“Big Joe”):结果是(注意第一个字符的索引是0):●序列操作➢连接操作:和字符串一样,使用+,下面是一个例子:输出结果是:●散列操作➢连接操作:和字符串一样,使用+,如果具有相同的key,右边的值替代左边的值,例如:输出结果是:●算术运算➢+、-、×、/、%,下面是一个例子:输出结果是(假设x为5):➢操作符两边必须是数字,因此下面的代码是错误的:➢使用+操作符时,如果一边是数字,一边是字符串,就会自动将数字转换为字符串,例如:输出结果是:➢使用内建的int(后面讲述)获得整数部分,例如:输出结果是(假设x为5):●比较操作符➢使用=(或==,完全相等)测试两个值是否相等,使用!=测试两个值是否不相等➢=和!=两边必须是相同类型的值,否则会产生错误,例如<#if 1 = "1">会引起错误➢Freemarker是精确比较,所以对"x"、"x "和"X"是不相等的➢对数字和日期可以使用<、<=、>和>=,但不能用于字符串➢由于Freemarker会将>解释成FTL标记的结束字符,所以对于>和>=可以使用括号来避免这种情况,例如<#if (x > y)>➢另一种替代的方法是,使用lt、lte、gt和gte来替代<、<=、>和>=●逻辑操作符➢&&(and)、||(or)、!(not),只能用于布尔值,否则会产生错误➢例子:●内建函数➢内建函数的用法类似访问散列的子变量,只是使用“?”替代“.”,下面列出常用的一些函数➢字符串使用的:⏹html:对字符串进行HTML编码⏹cap_first:使字符串第一个字母大写⏹lower_case:将字符串转换成小写⏹upper_case:将字符串转换成大写⏹trim:去掉字符串前后的空白字符➢序列使用的:⏹size:获得序列中元素的数目➢数字使用的:⏹int:取得数字的整数部分(如-1.9?int的结果是-1)➢例子(假设test保存字符串"Tom & Jerry"):输出结果是:●操作符优先顺序操作符组操作符后缀[subvarName] [subStringRange]. (methodParams)一元+expr、-expr、!内建?乘法*、/ 、%加法+、-关系<、>、<=、>=(lt、lte、gt、gte)相等==(=)、!=逻辑and &&逻辑or ||数字范围..(4)Interpolation●Interpolation有两种类型:➢通用Interpolation:${expr}➢数字Interpolation:#{expr}或#{expr; format}●注意:Interpolation只能用于文本部分●通用Interpolation➢插入字符串值:直接输出表达式结果➢插入数字值:根据缺省格式(由#setting指令设置)将表达式结果转换成文本输出;可以使用内建函数string格式化单个Interpolation,下面是一个例子:输出结果是:➢插入日期值:根据缺省格式(由#setting指令设置)将表达式结果转换成文本输出;可以使用内建函数string格式化单个Interpolation,下面是一个使用格式模式的例子:输出的结果类似下面的格式:➢插入布尔值:根据缺省格式(由#setting指令设置)将表达式结果转换成文本输出;可以使用内建函数string格式化单个Interpolation,下面是一个例子:输出结果是:●数字Interpolation的#{expr; format}形式可以用来格式化数字,format可以是:➢mX:小数部分最小X位➢MX:小数部分最大X位➢例子:4、杂项(1)用户定义指令●宏和变换器变量是两种不同类型的用户定义指令,它们之间的区别是宏是在模板中使用macro指令定义,而变换器是在模板外由程序定义,这里只介绍宏●基本用法➢宏是和某个变量关联的模板片断,以便在模板中通过用户定义指令使用该变量,下面是一个例子:➢作为用户定义指令使用宏变量时,使用@替代FTL标记中的#➢如果没有体内容,也可以使用:●参数➢在macro指令中可以在宏变量之后定义参数,如:➢可以这样使用这个宏变量:输出结果是:➢宏的参数是FTL表达式,所以下面的代码具有不同的意思:➢这意味着将Fred变量的值传给person参数,该值不仅是字符串,还可以是其它类型,甚至是复杂的表达式➢宏可以有多参数,下面是一个例子:➢可以这样使用该宏变量:➢其中参数的次序是无关的,因此下面是等价的:➢只能使用在macro指令中定义的参数,并且对所有参数赋值,所以下面的代码是错误的:➢可以在定义参数时指定缺省值,如:➢这样<@greet person="Fred"/>就正确了➢宏的参数是局部变量,只能在宏定义中有效●嵌套内容➢用户定义指令可以有嵌套内容,使用<#nested>指令执行指令开始和结束标记之间的模板片断➢例子:这样使用该宏变量:输出结果:➢<#nested>指令可以被多次调用,例如:输出结果:➢嵌套内容可以是有效的FTL,下面是一个有些复杂的例子:输出结果:➢宏定义中的局部变量对嵌套内容是不可见的,例如:输出结果:➢●在宏定义中使用循环变量➢用户定义指令可以有循环变量,通常用于重复嵌套内容,基本用法是:作为nested指令的参数传递循环变量的实际值,而在调用用户定义指令时,在<@…>开始标记的参数后面指定循环变量的名字➢例子:输出结果:➢指定的循环变量的数目和用户定义指令开始标记指定的不同不会有问题⏹调用时少指定循环变量,则多指定的值不可见⏹调用时多指定循环变量,多余的循环变量不会被创建(2)在模板中定义变量●在模板中定义的变量有三种类型:➢plain变量:可以在模板的任何地方访问,包括使用include指令插入的模板,使用assign指令创建和替换➢局部变量:在宏定义体中有效,使用local指令创建和替换➢循环变量:只能存在于指令的嵌套内容,由指令(如list)自动创建;宏的参数是局部变量,而不是循环变量●局部变量隐藏(而不是覆盖)同名的plain变量;循环变量隐藏同名的局部变量和plain变量,下面是一个例子:输出结果:●内部循环变量隐藏同名的外部循环变量,如:输出结果:中的同名变量,使用特殊变量global,下面的例子假设数据模型中的user的值是Big Joe:(3)名字空间●通常情况,只使用一个名字空间,称为主名字空间●为了创建可重用的宏、变换器或其它变量的集合(通常称库),必须使用多名字空间,其目的是防止同名冲突●创建库➢下面是一个创建库的例子(假设保存在lib/my_test.ftl中):间,并可以通过import指令中指定的散列变量访问库中的变量:输出结果:可以看到例子中使用的两个同名变量并没有冲突,因为它们位于不同的名字空间●可以使用assign指令在导入的名字空间中创建或替代变量,下面是一个例子:●输出结果:●数据模型中的变量任何地方都可见,也包括不同的名字空间,下面是修改的库:Freemarker - 几个比较实用的例子- -用Freemarker做模本语言有一段时间了,列出几个和JSP或者Velocity相比起来比较方便的用途,目的是引诱更多的人跳上Freemarker这个贼船,1. String内置的JavaScript转换: js_string用途:用于JavaScript转义,转换',",换行等特殊字符模板:<script>alert("${errorMessage?js_string}");</script>输出:<script>alert("Readonly\'s pet name is \"Cross Bone\"");</script>2.内置的默认值处理:default用途: 用于处理默认值模本:User: ${?default("Anonymous")}<td>${()?default(" ")}</td >输出:User: Anonymous<td> </td>注,可以对整个对象树加上(),再用内置处理器这种方便的做法,偶也是最近刚学会的,以前一直用很傻的方法做.....3. Sequence内置的计数器: xxx_index用途:显示序号模板:<#list employees as e>${e_index}. ${}</#list>输出:1. Readonly2. Robbin4. Sequence内置的分段器: chunk用途:某些比较BT的排版需求模板:<#assign seq = ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j']><#list seq?chunk(4) as row><ul><li><#list row as cell>${cell} </#list></li></ul></#list><#list seq?chunk(4, '-') as row><tr><td><#list row as cell>${cell} </#list></td></tr></#list>输出:<ul><li>a</li> <li>b</li> <li>c</li> <li>d</li> </ul><ul><li>e</li> <li>f</li> <li>g</li> <li>h</li> </ul><ul><li>i</li> <li>j</li> </ul><tr><td>a</td><td>b</td> <td>c</td> <td>d</td> </tr><tr><td>e</td> <td>f</td> <td>g</td> <td>h</td> </tr><tr><td>i</td> <td>j</td> <td>-</td> <td>-</td> </tr>语法FreeMarker的模板文件并不比HTML页面复杂多少,FreeMarker模板文件主要由如下4个部分组成:1. 文本:直接输出的部分2. 注释:<#-- ... -->格式部分,不会输出3. 插值:即${...}或#{...}格式的部分,将使用数据模型中的部分替代输出4. FTL指令:FreeMarker指定,和HTML标记类似,名字前加#予以区分,不会输出1.FTL指令规则在FreeMarker中,使用FTL标签来使用指令,FreeMarker有3种FTL标签,这和HTML标签是完全类似的.1.开始标签:<#directivename parameter>2.结束标签:</#directivename>3.空标签:<#directivename parameter/>实际上,使用标签时前面的符号#也可能变成@,如果该指令是一个用户指令而不是系统内建指令时,应将#符号改成@符号.使用FTL标签时, 应该有正确的嵌套,而不是交叉使用,这和XML标签的用法完全一样.如果全用不存在的指令,FreeMarker不会使用模板输出,而是产生一个错误消息.FreeMarker会忽略FTL标签中的空白字符.值得注意的是< , /> 和指令之间不允许有空白字符.2.插值规则FreeMarker的插值有如下两种类型:1,通用插值${expr};2,数字格式化插值:#{expr}或#{expr;format}2.1 通用插值对于通用插值,又可以分为以下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")}输出结果是:yes2.2 数字格式化插值数字格式化插值可采用#{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 -->3.表达式表达式是FreeMarker模板的核心功能,表达式放置在插值语法${}之中时,表明需要输出表达式的值;表达式语法也可与FreeMarker 标签结合,用于控制输出.实际上FreeMarker的表达式功能非常强大,它不仅支持直接指定值,输出变量值,也支持字符串格式化输出和集合访问等功能.3.1 直接指定值使用直接指定值语法让FreeMarker直接输出插值中的值,而不是输出变量值.直接指定值可以是字符串,数值,布尔值,集合和MAP对象.1. 字符串直接指定字符串值使用单引号或双引号限定,如果字符串值中包含特殊字符需要转义,看下面的例子:${"我的文件保存在C:\\盘"}${'我名字是\"annlee\"'}输出结果是:我的文件保存在C:\盘我名字是"annlee"FreeMarker支持如下转义字符:\";双引号(u0022)\';单引号(u0027)\\;反斜杠(u005C)\n;换行(u000A)\r;回车(u000D)\t;Tab(u0009)\b;退格键(u0008)\f;Form feed(u000C)\l;<\g;>\a;&\{;{\xCode;直接通过4位的16进制数来指定Unicode码,输出该unicode码对应的字符.如果某段文本中包含大量的特殊符号,FreeMarker提供了另一种特殊格式:可以在指定字符串内容的引号前增加r标记,在r标记后的文件将会直接输出.看如下代码:${r"${foo}"}${r"C:\foo\bar"}输出结果是:${foo}C:\foo\bar2. 数值表达式中的数值直接输出,不需要引号.小数点使用"."分隔,不能使用分组","符号.FreeMarker目前还不支持科学计数法,所以"1E3"是错误的.在FreeMarker表达式中使用数值需要注意以下几点:a)数值不能省略小数点前面的0,所以".5"是错误的写法b)数值8 , +8 , 8.00都是相同的3. 布尔值直接使用true和false,不使用引号.4. 集合集合以方括号包括,各集合元素之间以英文逗号","分隔,看如下的例子:<#list ["星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期天"] as x>${x}</#list>输出结果是:星期一星期二星期三星期四星期五星期六星期天除此之外,集合元素也可以是表达式,例子如下:[2 + 2, [1, 2, 3, 4], "whatnot"]还可以使用数字范围定义数字集合,如2..5等同于[2, 3, 4, 5],但是更有效率.注意,使用数字范围来定义集合时无需使用方括号,数字范围也支持反递增的数字范围,如5..25,Map对象Map对象使用花括号包括,Map中的key-value对之间以英文冒号":"分隔,多组key-value 对之间以英文逗号","分隔.下面是一个例子:{"语文":78, "数学":80}Map对象的key和value都是表达式,但是key必须是字符串3.2 输出变量值FreeMarker的表达式输出变量时,这些变量可以是顶层变量,也可以是Map对象中的变量,还可以是集合中的变量,并可以使用点(.)语法来访问Java对象的属性.下面分别讨论这些情况1. 顶层变量所谓顶层变量就是直接放在数据模型中的值,例如有如下数据模型:Map root = new HashMap(); //创建数据模型root.put("name","annlee"); //name是一个顶层变量对于顶层变量,直接使用${variableName}来输出变量值,变量名只能是字母,数字,下划线,$,@和#的组合,且不能以数字开头号.为了输出上面的name的值,可以使用如下语法: ${name}2. 输出集合元素如果需要输出集合元素,则可以根据集合元素的索引来输出集合元素,集合元素的索引以方括号指定.假设有索引:["星期一","星期二","星期三","星期四","星期五","星期六","星期天"].该索引名为week,如果需要输出星期三,则可以使用如下语法:${week[2]} //输出第三个集合元素此外,FreeMarker还支持返回集合的子集合,如果需要返回集合的子集合,则可以使用如下语法:week[3..5] //返回week集合的子集合,子集合中的元素是week集合中的第4-6个元素3. 输出Map元素这里的Map对象可以是直接HashMap的实例,甚至包括JavaBean实例,对于JavaBean实例而言,我们一样可以把其当成属性为key,属性值为value的Map实例.为了输出Map元素的值,可以使用点语法或方括号语法.假如有下面的数据模型:Map root = new HashMap();Book book = new Book();Author author = new Author();author.setName("annlee");author.setAddress("gz");book.setName("struts2");book.setAuthor(author);root.put("info","struts");root.put("book", book);为了访问数据模型中名为struts2的书的作者的名字,可以使用如下语法: //全部使用点语法book["author"].namebook.author["name"] //混合使用点语法和方括号语法book["author"]["name"] //全部使用方括号语法使用点语法时,变量名字有顶层变量一样的限制,但方括号语法没有该限制,因为名字可以是任意表达式的结果.3.3字符串操作FreeMarker的表达式对字符串操作非常灵活,可以将字符串常量和变量连接起来,也可以返回字符串的子串等.字符串连接有两种语法:1. 使用${..}或#{..}在字符串常量部分插入表达式的值,从而完成字符串连接.2. 直接使用连接运算符+来连接字符串例如有如下数据模型:Map root = new HashMap(); root.put("user","annlee");下面将user变量和常量连接起来:${"hello, ${user}!"} //使用第一种语法来连接${"hello, " + user + "!"} //使用+号来连接上面的输出字符串都是hello,annlee!,可以看出这两种语法的效果完全一样.值得注意的是,${..}只能用于文本部分,不能用于表达式,下面的代码是错误的:<#if ${isBig}>Wow!</#if><#if "${isBig}">Wow!</#if>应该写成:<#if isBig>Wow!</#if>截取子串可以根据字符串的索引来进行,截取子串时如果只指定了一个索引值,则用于取得字符串中指定索引所对应的字符;如果指定两个索引值,则返回两个索引中间的字符串子串.假如有如下数据模型:Map root = new HashMap(); root.put("book","struts2,freemarker");可以通过如下语法来截取子串:${book[0]}${book[4]} //结果是su。
freemarker模板中定义变量在模板中能够定义三种类型的变量:简单变量:它能从模板中的不论什么位置来訪问,或者从使⽤ include 指令引⼊的模板訪问。
能够使⽤ assign 或 macro 指令来创建或替换这些变量。
局部变量:它们仅仅能被设置在宏定义体内,并且仅仅在宏内可见。
⼀个局部变量的⽣存周期仅仅是宏的调⽤过程。
能够使⽤ local 指令在宏定义体内创建或替换局部变量。
循环变量:循环变量是由指令(如 list )⾃⼰主动创建的,并且它们仅仅在指令的開始和结束标记内有效。
宏的參数是局部变量⽽不是循环变量。
演⽰样例:使⽤ assign 创建和替换变量<#assign x = 1> <#-- 创建变量 x -->${x}<#assign x = x + 3> <#-- 替换变量 x -->${x}14局部变量也会隐藏(不是覆盖)同名的简单变量。
循环变量也会隐藏(不是覆盖)同名的局部变量和简单变量。
⽐如:<#assign x = "plain">1. ${x} <#-- 这⾥是普通变量 --><@test/>6. ${x} <#-- 普通变量的值没有被改变 --><#list ["loop"] as x>7. ${x} <#-- 如今循环变量隐藏了普通变量 --><#assign x = "plain2"> <#-- 替换普通变量, 隐藏在这⾥不起作⽤-->8. ${x} <#-- 它仍然隐藏普通变量 --></#list>9. ${x} <#-- 普通变量的新值 --><#macro test>2. ${x} <#-- 这⾥我们仍然看到的是普通变量 --><#local x = "local">3. ${x} <#-- 如今局部变量隐藏了它 --><#list ["loop"] as x>4. ${x} <#-- 如今循环变量隐藏了局部变量 --></#list>5. ${x} <#-- 如今⼜能够看到局部变量了 --></#macro>1. plain2. plain3. local4. loop5. local6. plain7. loop8. loop9. plain2注意到循环变量的设置是通过指令调⽤时创建的(本例中的 <list ...> 标签)。
framemaker 语法FreeMarker是一款用Java语言编写的模板引擎,用于生成各种文本,如HTML、XML、Java等。
以下是FreeMarker语法的一些示例:1.变量替换:2.freemarker复制代码<#assign name="John">Hello ${name}!1.控制结构:2.freemarker复制代码<#if name == "John">Hello John!<#else>Hello ${name}!</#if>1.宏定义和调用:2.freemarker复制代码<#macro greet person><font size="+2">Hello ${person}!</font></#macro><@greet person="John"/>1.列表和迭代:2.freemarker复制代码<#list items as item>${item}</#list>1.内置函数:2.freemarker复制代码<#function formatDate date><#return date?string("yyyy-MM-dd HH:mm:ss")></#function>${formatDate(date)}这些只是FreeMarker语法的一些基本示例,FreeMarker还支持更复杂的表达式和控制结构。
By zhxing1、if, else, elseif语法:<#if condition>...<#elseif condition2>...<#elseif condition3>......<#else>...</#if>备注:condition、condition2···必须为boolean 类型,<#elseif ··>、<#else>可有0或多个。
实例:<#if x == 1>x is 1<#elseif x == 2>x is 2<#elseif x == 3>x is 3<#elseif x > 4>x is 4<#else>x is not 1 nor 2 nor 3 nor 4</#if>备注:< 或 > 号必须转义,否则出错。
转义请参考其他文档。
2、switch, case, default, break语法<#switch value><#case refValue1>...<#break><#case refValue2>...<#break>...<#case refValueN>...<#break><#default>...</#switch>备注:该指令官方不推荐使用了,可以用if, else, elseif 指令代替。
3、list, break语法<#list sequence as item>...</#list>备注: sequence 为一个sequence 或者 collection 类型。
item 为循环的变量。
常⽤freemarker使⽤⽂档设置价格格式<#setting number_format = "currency" /><#assign price = 42 />${price}-${price?string}--${price?string.number}---${price?string.currency}----${price?string.percent}-----输出结果:设置价格格式¥42.00- ¥42.00-- 42--- ¥42.00---- 4,200%-----设置⽇期格式<#assign lastUpdated = "2009-01-07 15:05"?datetime("yyyy-MM-dd HH:mm") />${lastUpdated?string("yyyy-MM-dd HH:mm:ss zzzz")};${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};输出结果:2009-01-07 15:05:00 中国标准时间;2009-01-07 15:05:00 中国标准时间;星期三,⼀⽉ 7,09;星期三,⼀⽉ 07,2009,03:05:00 下午 (CST);09-1-7 下午3:05;2009年1⽉7⽇下午03时05分00秒;判断布尔<#assign foo=true />${foo?string("是foo","⾮foo")}输出结果:是foo集合<#assign mynums=[11,12,13,14,15,16,17,18,19]/><#list mynums as mn>${mn}<br></#list>输出结果:(¥是默认格式数字)¥12.00¥13.00¥14.00¥15.00¥16.00¥17.00¥18.00¥19.00拆分序列<#-- 这⾥是将mynums序列中下标从3到6之间的元素拆分出来,组成⼀个新的序列 --> <#assign mynum01=mynums[3..6]/><#list mynum01 as mn01>${mn01}</#list>输出结果:¥14.00¥15.00¥16.00¥17.00字符串的拆分(截取字符串)<br>${"你好,你来了吗今天看书了吗!"[0..8]}<br>你好,你来了吗今天...输出结果:你好,你来了吗今天你好,你来了吗今天...连续序列(即num01为完整集合不是拆分的)从55到58:注意此时若写成[55..58]或者[66..68]则会报错<#assign num01=55..58/><#list num01 as num>${num}</#list><#list 66..68 as num>${num}</#list>哈希表(Map)定义哈希表<#assign maps={"1":"张三","2":"李四"}>${maps["1"]}输出结果:张三<#--以下代码可以将map的key转换为相应的序列--><#assign keys=maps?keys><#list keys as key>${key}---${maps[key]}</#list>输出结果:1---张三2---李四<#assign users={"username":"张三","password":"123"}>${ername}---${users["password"]}输出结果:张三---123字符串操作a、字符串链接字符串连接有两种语法A、使⽤${..}(或#{..})在字符串常量部分插⼊表达式的值,从⽽完成字符串连接B、直接使⽤连接运算符(+)来连接字符串使⽤第⼀种语法来连接字符串${"Hello,${user}!"}第⼆种使⽤连接符号来连接字符串${"Hello,"+user+"!"};值的注意的是,${..}只能⽤于⽂本部分,因此,下⾯的代码是错误的:<#if ${isBig}>Wow!</#if><#if "${isBig}">Wow!</#if>应该写成:<#if isBig>Wow!</#if>集合连接运算符这⾥所说的集合连接运算时将两个集合连接成⼀个新的集合,连接集合的运算符是+,例如<#list ["星期⼀"," 星期⼆","星期三"]+["星期四","星期五"] as x>${x}</#list>Map连接运算符Map对象的连接运算也是将两个Map对象连接成⼀个新的Map对象,Map对象的连接运算符是+。
freemarker用法FreeMarker是一种模板引擎,在Java技术栈中被广泛使用。
它可用于生成动态的web页面,如HTML文件、XML文件、电子邮件呈现等等。
接下来,我们将介绍FreeMarker的用法。
首先,我们需要在Java项目中添加FreeMarker库的依赖项,以便在代码中使用FreeMarker。
然后,需要创建FreeMarker的配置对象,以便配置FreeMarker的一些参数,如模板文件存放位置、编码等。
在创建配置对象后,我们需要创建一个模板文件,并将其存储在指定的目录中。
模板文件是一个普通的文本文件,其中包含静态文本和FreeMarker标记。
在模板文件中,静态文本会直接呈现在生成的页面中,而FreeMarker标记将会被解释和转换成动态的内容。
FreeMarker标记的格式为${expression},其中expression是一个表达式,可以是一个变量、一个函数、一个条件语句等等。
例如,${name}表示输出变量name的值,而${if condition}...${/if}表示条件判断,如果condition成立,则输出其中的内容。
除了上述标记,FreeMarker还提供了很多其他的标记,如循环、宏、包含、导入等等。
使用FreeMarker,我们可以轻松地将Java对象与模板文件结合起来,生成动态的页面。
我们首先需要创建一个数据模型,即一个Java对象,其中包含了我们想要在页面中呈现的数据。
接着,我们需要将数据模型传递给一个模板文件,并执行解析和渲染过程,将数据和模板结合起来生成HTML代码。
最后,将HTML代码输出到客户端。
总结来说,FreeMarker是一种强大的模板引擎,它可以帮助我们生成动态页面和电子邮件。
FreeMarker标记和Java代码的结合,可以使我们更有效地处理和呈现动态内容,从而使我们的网站更加生动和富有可读性。
freemarker菜鸟教程Freemarker菜鸟教程1. 介绍Freemarker是一种模板引擎,用于将数据模型与文本模板合并生成输出内容。
它提供了多种功能,使开发人员能够轻松地生成动态网页、邮件、XML文件等。
2. Freemarker的优点- 简洁易学:Freemarker使用简单的语法和模板指令,易于学习和使用。
即使是没有编程经验的初学者也可以快速上手。
- 强大灵活:Freemarker提供了丰富的模板指令和表达式,可以满足各种动态内容生成的需求。
- 高性能:Freemarker运行速度快,生成的输出内容效率高,非常适合用于大规模的数据处理和生成。
3. Freemarker基本语法- 插值:使用${}来插入变量或表达式的值。
```html<p>欢迎来到Freemarker教程,${username}!</p>```- 条件判断:使用if-else指令进行条件判断。
```html<#if age < 18><p>您是未成年人。
</p><#else><p>您已成年。
</p></#if>```- 循环:使用list指令实现列表的循环遍历。
```html<ul><#list users as user><li>${}</li></#list></ul>```- 宏定义:使用#macro指令定义宏,可以实现代码的重复使用。
```html<#macro hello /><h1>Hello, ${name}!</h1></#macro>```4. Freemarker内置指令- include指令:用于引入其他模板文件。
```html<#include \。
freemarker !用法Freemarker是一种模板引擎,可以在Web应用中轻松地生成HTML,XML,JSON等文件。
它允许我们将数据和静态模板分离,从而使我们的代码更加清晰易读。
在这篇文章中,我们将探讨Freemarker的用法和一些最佳实践。
首先,我们需要了解Freemarker的基本语法。
Freemarker使用尖括号标记“<% %>"来定义内容块。
在这些标记内,我们可以使用变量,表达式,条件和迭代语句等。
例如,以下是一个简单的Freemarker模板:```<html><head><title>Hello, ${name}!</title></head><body><p>Welcome to our website!</p></body></html>```在这个模板中,我们使用了变量“name”。
这个变量可以在Java 代码中设置,并在生成HTML时插入到相应的位置。
为了在Java中使用Freemarker,我们需要引入Freemarker库,并创建一个Configuration对象:```Configuration cfg = newConfiguration(Configuration.VERSION_2_3_30);cfg.setClassForTemplateLoading(Main.class, "/templates"); cfg.setDefaultEncoding("UTF-8");```在这个例子中,我们设置了模板目录,并设置了默认编码为UTF-8。
然后,我们可以使用TemplateLoader从模板文件读取模板:```Template template = cfg.getTemplate("hello.ftl");```接下来,我们需要将我们的数据传递给数据模型。
freemarker使用流程Freemarker是一种模板引擎,它可以将数据和模板结合起来生成最终的输出。
它可以用于Java、.NET、PHP等多种编程语言中,本文将以Java为例介绍Freemarker的使用流程。
1. 下载Freemarker首先需要下载Freemarker的jar包,可以在官网上下载最新版本。
下载完成后将jar包添加到项目的classpath中。
2. 创建模板文件Freemarker使用.ftl作为模板文件的扩展名,创建一个.ftl文件并编写模板代码。
例如:```<html><head><title>${title}</title></head><body><h1>${heading}</h1><ul><#list items as item><li>${item}</li></#list></ul></body></html>```在这个例子中,`${}`是Freemarker的语法,表示要替换成实际的值。
`${title}`、`${heading}`和`${item}`都是变量名,在生成输出时会被替换成相应的值。
3. 创建数据模型数据模型是一个Java对象或Map,它包含了模板所需要的数据。
例如:```Map<String, Object> data = new HashMap<>();data.put("title", "My Website");data.put("heading", "Welcome to my website!");List<String> items = new ArrayList<>();items.add("Item 1");items.add("Item 2");items.add("Item 3");data.put("items", items);```在这个例子中,我们创建了一个Map对象,包含了模板需要的三个变量:`title`、`heading`和`items`。
freemarker 用法Freemarker 是一种模板引擎,广泛用于JavaWeb 开发中。
它提供了一种将数据模型与视图层分离的方式。
在使用Freemarker 进行开发时,我们首先需要了解一些基本的用法和语法规则。
本文将一步一步回答关于Freemarker 的常见问题,并介绍它的基本用法与功能。
一、什么是Freemarker?Freemarker 是一个模板引擎,它能够根据模板以及给定的数据模型生成最终的文本输出。
它使用简单明了的标记语言,允许开发者通过填充数据模型来动态生成页面内容。
二、如何引入Freemarker?要使用Freemarker,我们首先需要引入它的依赖。
通常情况下,我们可以在Maven 项目的pom.xml 文件中添加以下依赖:xml<dependency><groupId>org.freemarker</groupId><artifactId>freemarker</artifactId><version>2.3.27-incubating</version></dependency>三、如何配置Freemarker?在Spring Boot 项目中,我们可以使用`@Configuration` 注解来配置Freemarker。
通过`FreeMarkerConfigurer` 类,我们可以设置Freemarker 的一些参数,例如模板文件所在的路径、编码方式等。
java@Configurationpublic class FreemarkerConfig {@Beanpublic FreeMarkerConfigurer freeMarkerConfigurer() {FreeMarkerConfigurer configurer = new FreeMarkerConfigurer();configurer.setTemplateLoaderPath("classpath:/templates");configurer.setDefaultEncoding("UTF-8");return configurer;}}在上述代码中,我们设置了模板所在的路径为classpath:/templates,这意味着我们的模板文件将在项目resources 目录下的templates 文件夹中。
freemarker常见语法大全格式比较乱一些,适合ctrl+f搜索关键字FreeMarker的插值有如下两种类型:1,通用插值${expr};2,数字格式化插值:#{expr}或#{expr;format}${?if_exists } //用于判断如果存在,就输出这个值${?default(‘xxx’)}//默认值xxx${!"xxx"}//默认值xxx${book.date?string('yyyy-MM-dd')} //日期格式${book?string.number} 20 //三种不同的数字格式${book?string.currency}--<#-- $20.00 -->${book?string.percent}—<#-- 20% --><#assign foo=ture /> //声明变量,插入布尔值进行显示${foo?string("yes","no")} <#-- yes --><等大小比较符号使用需要注意:(xml的原因),可以用于比较数字和日期使用lt、lte、gt和gte来替代<、<=、>和>= 也可以使用括号<#if (x>y)>内置函数: 调用区别于属性的访问,使用?代替.常见的一些内置函数对于字符串html-对字符串进行HTML编码cap_first-使字符串第一个字母大写lower_case-将字符串转换成小写trim-去掉字符串前后的空白字符对于Sequences(序列)size-获得序列中元素的数目对于数字int-取得数字的整数部分(如-1.9?int的结果是-1)对于集合,可以使用数组的方式,使用下标索引进行访问逻辑判断:if................<#if condition>...<#elseif condition2>...<#elseif condition3>......<#else>...Boolean类型的空值判断空值判断可以写成<#if ?? > //注意${}为变量的渲染显示,而<>为定义等操作符的定义switch............<#switch value><#case refValue1>...<#break><#case refValue2>...<#break>...<#case refValueN>...<#break><#default>...</#switch>快速定义int区间的集合<#assign l=0..100/> //注意不需要[]3:循环读取集合: 注意/的使用<#list student as stu>${stu}<br/></#list>与jstl循环类似,也可以访问循环的状态item_index:当前变量的索引值item_has_next:是否存在下一个对象其中item名称为as后的变量名,如stu集合长度判断<#if student?size != 0></#if> 判断=的时候,注意只要一个=符号,而不是==宏/模板初步了解: 使用更像一个闭包closure,可以定义后,在脚本中任意地方引用,并原地起作用<#macro greet><font size="+2">Hello Joe!</font></#macro>使用的方式为:<@greet></@greet> //同xml可以简写成<@greet/>宏的参数定义,类似js,在宏名后带参数进行传递定义<#macro greet person color>${person}</#macro>调用带参数时,注意使用类似XML的属性格式进行传递,不需要关心顺序问题<@greet person="Fred" color="black"/>参数默认值定义,如果没有,就必须要求传递完整的参数列表<#macro greet person color="black"><font size="+2" color="${color}">Hello ${person}!</font></#macro>使用xml的嵌套内容进行传递宏调用,关键标签<#nested><#macro border><table border=4 cellspacing=0 cellpadding=4><tr><td><#nested></tr></td></table></#macro>调用时:<@border>The bordered text</@border><#nested> 标签可以在宏中多次调用,也可以将多个宏组合进行嵌套for循环的精简版:<#list 1..count as x></#list>宏的循环变量,配合嵌套标签进行参数传递,<#macro repeat count><#list 1..count as x><#nested x, x/2, x==count> //这里的三个参数,将会传递到嵌套内容中</#list></#macro><@repeat count=4 ; c, halfc, last>${c}. ${halfc}<#if last> Last!</#if> //这里的内容由macro中的<#nested>进行参数的传递,传递的数量任意,当注意需要宏接受这些</@repeat>上述还需要注意;的使用参数的数量是可变的,并不要求全部都有,但是效果不同在模板中定义变量在模板中定义的变量有三种类型:plain变量:可以在模板的任何地方访问,包括使用include指令插入的模板,使用assign指令创建和替换。
excel中宏的用法在Excel中,宏(Macro)是一种自动化的编程工具,用于记录和执行在Excel中执行的一系列操作,方便用户实现重复性的任务。
宏使用了Visual Basic for Applications(VBA)编程语言。
通过宏,用户可以自定义和执行特定的任务和操作,例如自动化数据输入、计算、格式化、筛选、图表生成、报告生成等。
用户可以使用Excel中的“开发工具”选项卡中的“Visual Basic”编写并编辑宏。
使用宏的主要步骤如下:1.打开Excel,点击“开发工具”选项卡。
2.在“代码”组中,点击“Visual Basic”按钮,打开Visual Basic编辑器。
3.在Visual Basic编辑器中,可以编写、编辑和调试宏代码。
4.在宏代码中,可以使用VBA语言实现所需的任务并添加相应的Excel对象、方法和属性。
例如,使用“Range”对象来选择和操作单元格范围,使用“Cells”对象进行单元格级别的操作,使用“Workbook”和“Worksheet”对象进行工作簿和工作表级别的操作,以及使用其他对象和方法来实现不同的功能。
5.调试和运行宏。
点击“运行”选项卡中的“运行”按钮或按下F5键,以执行所编写的宏代码。
宏还有一些其他的用法与功能,例如宏的录制功能。
通过在录制宏期间执行特定的任务和操作,在录制结束后,Excel会将所执行的操作转换为对应的VBA代码,并将其保存为宏。
这使得用户无需手动编写代码即可快速创建宏。
此外,用户还可以为宏添加特定的触发器,使其在特定的条件下自动执行。
例如,可以为宏添加按钮,点击按钮时即可触发宏的执行;或者通过自定义工具栏、快捷键等方式来触发宏的执行。
总之,Excel中宏是一种非常强大和灵活的工具,凭借其功能和自动化能力,可以大幅提高工作效率,简化重复性任务的操作流程。
Excel中的Macro宏是一种自动化工具,可以记录和执行一系列的操作,以便快速完成重复任务。
以下是Excel中宏的用法:
1. 录制宏:打开Excel,在“开发工具”选项卡上,单击“录制宏”按钮。
在弹出的对话框中,输入宏的名称和描述,选择录制的宏类型,单击“录制”按钮开始录制。
完成录制后,单击“停止”按钮,然后保存宏。
2. 运行宏:打开Excel,在“开发工具”选项卡上,单击“宏”按钮。
在弹出的对话框中,选择要运行的宏,然后单击“运行”按钮。
也可以使用快捷键Alt+F8来打开宏窗口。
3. 编辑宏:打开Excel,在“开发工具”选项卡上,单击“宏”按钮。
在弹出的对话框中,选择要编辑的宏,然后单击“编辑”按钮。
在VBA编辑器中,可以修改宏的代码,然后保存并关闭编辑器。
4. 使用相对单元格:在宏代码中使用相对单元格,可以使宏在不同的工作表和单元格中运行。
例如,使用Range("A1")代替绝对引用$A$1,就可以使宏在不同的单元格中运行。
5. 使用条件语句:在宏代码中使用条件语句,可以根据不同的条件执行不同的操作。
例如,使用If...Then...Else语句,可以根据单元格的值执行不同的操作。
6. 使用循环语句:在宏代码中使用循环语句,可以使宏重复执行相同的操作。
例如,使用For Each语句,可以遍历工作表中的所有单元格。
总之,Excel宏可以大大提高工作效率,减少重复操作,但需要一定的VBA编程知识和技能。
A 概念最常用的 3 个概念sequence 序列,对应java 里的list 、数组等非键值对的集合hash 键值对的集合namespace 对一个ftl 文件的引用, 利用这个名字可以访问到该ftl 文件的资源B 指令if, else, elseif语法Java代码1.<#if condition>2. ...3.<#elseif condition2>4. ...5.<#elseif condition3>6. ...7....8.<#else>9. ...10.</#if>用例Freemarker代码1.<#if x = 1>2. x is 13.</#if>4.<#if x = 1>5. x is 16.<#else>7. x is not 18.</#if>switch, case, default, break语法Freemarker代码1.<#switch value>2. <#case refValue1>3. ...4. <#break>5. <#case refValue2>6. ...7. <#break>8. ...9. <#case refValueN>10. ...11. <#break>12. <#default>13. ...14.</#switch>用例字符串Freemarker代码1.<#switch being.size>2. <#case "small">3. This will be processed if it is small4. <#break>5. <#case "medium">6. This will be processed if it is medium7. <#break>8. <#case "large">9. This will be processed if it is large10. <#break>11. <#default>12. This will be processed if it is neither13.</#switch>数字Freemarker代码1.<#switch x>2. <#case x = 1>3.14. <#case x = 2>5.26. <#default>7. d8.</#switch>如果x=1 输出 1 2, x=2 输出 2, x=3 输出dlist, break语法Freemarker代码1.<#list sequence as item>2....3.<#if item = "spring"><#break></#if>4....5.</#list>关键字item_index:是list当前值的下标item_has_next:判断list是否还有值用例Freemarker代码1.<#assign seq = ["winter", "spring", "summer", "autumn"]>2.<#list seq as x>3. ${x_index + 1}. ${x}<#if x_has_next>,</#if>4.</#list>输出:1.winter,2.spring,3.summer,4.autumninclude语法Freemarker代码1.<#include filename>或则Java代码1.<#include filename options>options包含两个属性encoding="GBK" 编码格式parse=true 是否作为ftl语法解析,默认是true,false就是以文本方式引入.注意在ftl文件里布尔值都是直接赋值的如parse=true,而不是parse="true"用例/common/copyright.ftl 包含内容Ftl代码1.Copyright 2001-2002 ${me}2.3.All rights reserved.模板文件Java代码1.<#assign me = "Juila Smith">2.3.Some test4.5.Yeah6.___________________________________________________________________________7.8.<SPAN><STRONG><SPAN><#include "/common/copyright.ftl" encoding="GBK"></SPAN>9.10.11.12.13.14.</STRONG>15.16.17.18.</SPAN>输出结果:Some testYeah.Copyright 2001-2002 Juila SmithAll rights reserved.ImportFreemarker代码1.<#import path as hash>类似于java里的import,它导入文件,然后就可以在当前文件里使用被导入文件里的宏组件用例假设mylib.ftl 里定义了宏copyright 那么我们在其他模板页面里可以这样使用Freemarker代码1.<#import "/libs/mylib.ftl" as my>2.3.<@my.copyright date="1999-2002"/>4.5.<#-- "my"在freemarker里被称作namespace -->compress语法Freemarker代码1.<#compress>2. ...3.</#compress>用来压缩空白空间和空白的行escape, noescape语法Freemarker代码1.<#escape identifier as expression>2. ...3. <#noescape>...</#noescape>4. ...5.</#escape>用例主要使用在相似的字符串变量输出,比如某一个模块的所有字符串输出都必须是html安全的,这个时候就可以使用该表达式Freemarker代码1.<#escape x as x?html>2. First name: ${firstName}3. <#noescape>Last name: ${lastName}</#noescape>4. Maiden name: ${maidenName}5.</#escape>相同表达式Ftl代码1.First name: ${firstName?html}st name: ${lastName }3.Maiden name: ${maidenName?html}assign语法Freemarker代码1.<#assign name=value>2.3.<#-- 或则 -->4.5.<#assign name1=value1 name2=value2 ... nameN=valueN>6.7.<#-- 或则 -->8.9.<#assign same as above... in namespacehash>10.11.<#-- 或则 -->12.13.<#assign name>14. capture this15.</#assign>16.17.<#-- 或则 -->18.19.<#assign name in namespacehash>20. capture this21.</#assign>用例生成变量,并且给变量赋值给seasons赋予序列值Ftl代码1.<#assign seasons = ["winter", "spring", "summer", "autumn"]>给变量test加1Ftl代码1.<#assign test = test + 1>给my namespage 赋予一个变量bgColor,下面可以通过my.bgColor来访问这个变量Ftl代码1.<#import "/mylib.ftl" as my>2.3.<#assign bgColor="red" in my>将一段输出的文本作为变量保存在x里Ftl代码1.<#assign x>2. <#list 1..3 as n>3. ${n} <@myMacro />4. </#list>5.</#assign>6.7.Number of words: ${x?word_list?size}8.9.${x}10.11.<#assign x>Hello ${user}!</#assign> error12.13.<#assign x=" Hello ${user}!"> true同时也支持中文赋值,如:Ftl代码1.<#assign 语法>2. java3.</#assign>4.5.${语法}打印输出:javaglobal语法Freemarker代码1.<#global name=value>2.3.<#--或则-->4.5.<#global name1=value1 name2=value2 ... nameN=valueN>6.7.<#--或则-->8.9.<#global name>10. capture this11.</#global>全局赋值语法,利用这个语法给变量赋值,那么这个变量在所有的namespace [A1] 中是可见的, 如果这个变量被当前的assign 语法覆盖如<#global x=2> <#assign x=1> 在当前页面里x=2 将被隐藏,或者通过${.global.x} 来访问setting语法Freemarker代码1.<#setting name=value>用来设置整个系统的一个环境localenumber_formatboolean_formatdate_format , time_format , datetime_formattime_zoneclassic_compatible用例假如当前是匈牙利的设置,然后修改成美国Ftl代码1.${1.2}2.3.<#setting locale="en_US">4.5.${1.2}输出1,21.2因为匈牙利是采用", "作为十进制的分隔符,美国是用". " macro, nested, return语法Freemarker代码1.<#macro name param1 param2 ... paramN>2. ...3. <#nested loopvar1, loopvar2, ..., loopvarN>4. ...5. <#return>6. ...7.</#macro>用例Ftl代码1.<#macro test foo bar="Bar"[A2] baaz=-1>2. Test text, and the params: ${foo}, ${bar}, ${baaz}3.</#macro>4.5.<@test foo="a" bar="b" baaz=5*5-2/>6.7.<@test foo="a" bar="b"/>8.9.<@test foo="a" baaz=5*5-2/>10.11.<@test foo="a"/>输出Test text, and the params: a, b, 23Test text, and the params: a, b, -1Test text, and the params: a, Bar, 23Test text, and the params: a, Bar, -1定义循环输出的宏Ftl代码1.<#macro list title items>2.${title?cap_first}:3. <#list items as x>4. *${x?cap_first}5.6. </#list>7.</#macro>8.9.<@list items=["mouse", "elephant", "python"] title="Animals"/>输出结果:Animals:*Mouse*Elephant*Python包含body 的宏Ftl代码1.<#macro repeat count>2. <#list 1..count as x>3. <#nested x, x/2, x==count>4. </#list>5.</#macro>6.7.<@repeat count=4 ; c halfc last>8. ${c}. ${halfc}<#if last> Last!</#if>9.</@repeat>输出1. 0.52. 13. 1.54. 2 Last!t, lt, rt语法Freemarkder代码1.<#t> 去掉左右空白和回车换行2.3.<#lt>去掉左边空白和回车换行4.5.<#rt>去掉右边空白和回车换行6.7.<#nt>取消上面的效果C 一些常用方法或注意事项表达式转换类${expression} 计算expression 并输出#{ expression } 数字计算#{ expression ;format} 安格式输出数字format 为M 和mM 表示小数点后最多的位数,m 表示小数点后最少的位数如#{121.2322;m2M2} 输出121.23数字循环1..5 表示从1 到5 ,原型number..number对浮点取整数${123.23?int} 输出 123给变量默认值${var?default("hello world")?html} 如果var is null 那么将会被hello world 替代判断对象是不是 nullFtl代码1.<#if mouse?exists>2. Mouse found3.<#else>也可以直接${mouse?if_exists})输出布尔形--------------------------------------------(1)解决输出中文乱码问题:freemarker乱码的原因:∙没有使用正确的编码格式读取模版文件,表现为模版中的中文为乱码解决方法:在classpath上放置一个文件freemarker.properties,在里面写上模版文件的编码方式,比如default_encoding=UTF-8locale=zh_CN注意:eclipse中除了xml文件、java文件外,默认的文件格式iso8859-1 ∙数据插入模版时,没有使用正确的编码,表现出模版中的新插入数据为乱码解决方法:在result的配置中,指定charset,s2的FreemarkerResult.java 会将charset传递freemarker<action name="ListPersons" class="ListPersons"><result type="freemarker"><param name="location">/pages/Person/view.ftl</param> <param name="contentType"> text/html;charset=UTF-8</param></result></action>(2)提高freemarker的性能在freemarker.properties中设置:template_update_delay=60000避免每次请求都重新载入模版,即充分利用cached的模版(3)尽量使用freemarker本身的提供的tag,使用S2 tags 的标签会在性能上有所损失(4)freemarker的标签种类:∙${..}:FreeMarker will replace it in the output with the actual value of the thing in the curly brackets. They are called interpolations.∙# ,代表是FTL tags(FreeMarker Template Language tags),hey are instructions to FreeMarker and will not be printed to the output o<#if ...></#if>o<#list totalList as elementObject>...</#list> ∙@ ,代表用户自定义的标签∙<#-- --> 注释标签,注意不是<!-- -->(5)一些特殊的指令:∙r代表原样输出:${r"C:\foo\bar"}∙<#list ["winter", "spring", "summer", "autumn"] as x>${x}</#list> ∙?引出内置指令o String处理指令:▪html:特殊的html字符将会被转义,比如"<",处理后的结果是<▪cap_first 、lower_case 、upper_case▪trim :除去字符串前后的空格o sequences处理指令▪size :返回sequences的大小o numbers处理指令▪int:number的整数部分,(e.g. -1.9?int is -1) (6)对于null,或者miss value,freemarker会报错∙ ?exists:旧版本的用法∙!:default value operator,语法结构为:unsafe_expr!default_expr,比如${mouse!"No mouse."} 当mouse不存在时,返回default value;o(product.color)!"red" 这种方式,能够处理product或者color 为miss value的情况;o而product.color!"red"将只处理color为miss value的情况∙??: Missing value test operator ,测试是否为missing value o unsafe_expr ?? :product.color??将只测试color是否为nullo(unsafe_expr )??:(product.color)??将测试product和color 是否存在nullFtl代码1.<#if mouse??>2. Mouse found3.<#else>4. No mouse found5.</#if>6.Creating mouse...7.<#assign mouse = "Jerry">8.<#if mouse??>9. Mouse found10.11.<#else>12. No mouse found13.</#if>(7)模版值插入方式(interpolation)∙通用方式( Universal interpolations): ${expression }∙对于字符串:只是简单输出∙对于数值,会自动根据local确定格式,称为human audience,否则称为computer audience,可以"?c",比如, <ahref="/shop/details?id=${product.id?c}">Details...</a>,因此这里的id是给浏览器使用的,不需要进行格式化,注意?c只对数值有效∙对于日期,会使用默认的日期格式转换,因此需要事先设置好默认的转换格式,包括date_format , time_format ,atetime_format ∙对于布尔值,不能输出,会报错并停止模版的执行,比如${a = 2} 会出错,但是可以string built-in来进行转换数值处理,具体参考:Built-ins for numbers/docs/ref_builtins_number.html#ref_builtin_s tring_for_number数值处理的例子:<#setting number_format="currency"/><#assign answer=42/>${answer}${answer?string} <#-- the same as ${answer} -->${answer?string.number}${answer?string.currency}${answer?string.percent}除了使用内置的formate,可以使用任何用Java decimal number format syntax 书写的formate,比如<#setting number_format="0.###E0"/><#setting number_format="0"/><#setting number_format="#"/>${1234}${12345?string("0.####E0")}更加方便的格式:<#setting locale="en_US">US people writes: ${12345678?string(",##0.00")}<#setting locale="hu">Hungarian people writes: ${12345678?string(",##0.00")}日期处理,参考Built-ins for dates/docs/ref_builtins_date.html#ref_builtin_str ing_for_date日期处理的例子:∙ ${openingTime?string.short}∙ ${openingTime?string.medium}∙ ${openingTime?string.long}∙ ${openingTime?string.full}∙ ${nextDiscountDay?string.short}∙ ${nextDiscountDay?string.medium}∙ ${nextDiscountDay?string.long}∙ ${nextDiscountDay?string.full}∙ ${lastUpdated?string.short}∙ ${lastUpdated?string.medium}∙ ${lastUpdated?string.long}∙ ${lastUpdated?string.full}注意:由于java语言中的Date类型的不足,freemarker不能根据Date变量判断出变量包含的部分(日期、时间还是全部),在这种情况下,freemarker不能正确显示出${lastUpdated?string.short} 或者 simply ${lastUpdated},因此,可以通过?date, ?time and ?datetime built-ins来帮助freemarker来进行判断,比如${lastUpdated?datetime?string.short}除了使用内置的日期转换格式外,可以自己指定日期的格式,使用的是Java date format syntax,比如:∙ ${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')'")}数值专用方式( Numerical interpolations):#{expression } or#{expression; format},这是数值专用的输出方式,但是最好使用通用方式的string built-in或者number_format 来完成转换,Numerical interpolations方式将会被停用(8)创建自定义模版Ftl代码1.<#macro greet>2. <font size="+2">Hello Joe!</font>3.</#macro><#assign user="zhangsan"/>字符串连接${"Hello ${user}!"} 与 ${"Hello " + user + "!"} 相同结果:Hello zhangsan获取字符${user[0]} ${user[4]}结果:z g序列的连接和访问<#assign nums=["1" , "2"] + ["3" , "4"] />${nums[0]} 结果是 1内置函数html 使用实体引用替换字符串中所有HTML字符,例如,使用& 替换& lower_case 将字符串转化成小写substringindex_of 例如”abcdc"?index_of("bc") 将返回1seq_contains 序列中是否包含指定值 ${nums?seq_contains("1")?string("yes","no")}seq_index_of 第一个出现的索引 ${nums?seq_index_of("1")} 结果0 sort_by 用于散列常用语法EG.一个对象BOOK1.输出${}空值判断:${?if_exists },${?default(‘xxx’)}//默认值xxx${ !"xxx"}//默认值xxx日期格式:${book.date?string('yyyy-MM-dd')}数字格式:${book?string.number}--20${book?string.currency}--<#-- $20.00 -->${book?string.percent}—<#-- 20% -->插入布尔值:<#assign foo=ture />${foo?string("yes","no")} <#-- yes -->2.逻辑判断a:<#if condition>...<#elseif condition2>...<#elseif condition3>......<#else>...其中空值判断可以写成<#if ?? > </#if>b:<#switch value><#case refValue1>...<#break><#case refValue2>...<#break>...<#case refValueN>...<#break><#default>...</#switch>3.循环读取<#list sequence as item>...</#list>空值判断<#if bookList?size = 0></#list>e.g.<#list employees as e>${e_index}. ${}</#list>输出:1. Readonly2. Robbin4.FreeMarker3 宏/模板宏Macro宏是在模板中使用macro指令定义l.1 基本用法宏是和某个变量关联的模板片断,以便在模板中通过用户定义指令使用该变量,下面是一个例子:<#macro greet><font size="+2">Hello Joe!</font></#macro>调用宏时,与使用FreeMarker的其他指令类似,只是使用@替代FTL标记中的#。
freemarker指令语法Freemarker是一个模板引擎,它基于模板和变化的数据来生成文本输出(HTML、电子邮件、配置文件、源代码等)。
Freemarker的指令语法主要用于操作数据模型,控制模板的渲染行为等。
以下是一些Freemarker的主要指令:1、<#assign name = "value">: 用于定义变量。
2、<#if expression>: 用于条件判断。
3、<#list items as item>: 用于遍历列表或数组。
4、<#each item in list>: 与<#list> 功能类似,但允许在每个元素上执行更复杂的操作。
5、<#macro name params>: 用于定义可重用的模板片段。
6、<#include "file">: 用于导入其他模板。
7、<#function name params>: 与<#macro> 功能类似,但定义的是函数,而不是宏。
8、<#capture> 和<#output>:用于捕获和输出模板片段,以进行重复使用。
9、<#switch expression>: 用于多分支选择。
10、<#list relateditems as item, itemIndex>: 这是一个更复杂的列表迭代方式,可以获取当前项的索引。
这些指令都是在Freemarker 的“指令标签”中使用的,其形式通常为<#...>。
在模板中,你可以将这些指令放在任何你想要的地方,除了数据模型中的值内部(也就是说,不能在${...} 内部使用)。
FreeMarker macro(宏)的使用.txt14热情是一种巨大的力量,从心灵内部迸发而出,激励我们发挥出无穷的智慧和活力;热情是一根强大的支柱,无论面临怎样的困境,总能催生我们乐观的斗志和顽强的毅力……没有热情,生命的天空就没的色彩。FreeMarker macro(宏)的使用
有人说用freemarker,但没有用到它的宏(macro),就=没有真正用过freemarker。说的就是宏是freemarker的一大特色。
宏的定义可以查看相关的文档,里面介绍得很清楚,下面来看看它的一个用法(javaeye帖子里有讨论)。
/WEB-INF/template/common/: <#macro html title> ${title}
<#nested/>
然后在里定义: auto_import=/WEB-INF/template/common/ as c
然后其他的ftl文件就可以使用它了 : title="OA"> 你的内容 >
如果不在里定义,可以在每个文件里包含这个ftl: <#import "/WEB-INF/template/common/" as c>
不同的场合有不同的运用。使用得好的话,将会大大节省你的开发时间。
macro, nested, return 语法 <#macro name param1 param2 ... paramN> ... <#nested loopvar1, loopvar2, ..., loopvarN> ... <#return> ... 用例 <#macro test foo bar="Bar" baaz=-1> Test text, and the params: ${foo}, ${bar}, ${baaz} <@test foo="a" bar="b" baaz=5*5-2/> <@test foo="a" bar="b"/> <@test foo="a" baaz=5*5-2/> <@test foo="a"/>
输出 Test text, and the params: a, b, 23 Test text, and the params: a, b, -1 Test text, and the params: a, Bar, 23 Test text, and the params: a, Bar, -1
定义循环输出的宏 <#macro list title items>
${titlecap_first}:
输出结果
Animals:
输出 1. 2. 1 3. 4. 2 Last!
-------------------------------------------------------------------------------- 注意在使用的时候:别忘了双引号。 <#import "/pagelibs/" as book> value="${}" />
宏Macro 宏是在模板中使用macro指令定义
基本用法 宏是和某个变量关联的模板片断,以便在模板中通过用户定义指令使用该变量,下面是一个例子:
<#macro greet> Hello Joe! 调用宏时,与使用FreeMarker的其他指令类似,只是使用@替代FTL标记中的#。
<@greet> <#--<@greet/>--> 在macro指令中可以在宏变量之后定义参数,如:
<#macro greet person> Hello ${person}! 可以这样使用这个宏变量:
<@greet person="Fred"/> 但是下面的代码具有不同的意思: <@greet person=Fred/> 这意味着将Fred变量的值传给person参数,该值不仅是字符串,还可以是其它类型,甚至是复杂的表达式。
宏可以有多参数,下面是一个例子: <#macro greet person color> Hello ${person}! 可以这样使用该宏变量,其中参数的次序是无关的:
<@greet person="Fred" color="black"/> 可以在定义参数时指定缺省值,否则,在调用宏的时候,必须对所有参数赋值:
<#macro greet person color="black"> Hello ${person}! 注意:宏的参数是局部变量,只能在宏定义中有效。
嵌套内容 FreeMarker的宏可以有嵌套内容,<#nested>指令会执行宏调用指令开始和结束标记之间的模板片断,举一个简单的例子:
<#macro border>
<@border>The bordered text 输出结果:
<#macro do_thrice> <#nested> <#nested> <#nested><@do_thrice> Anything. FMPP 输出结果:
嵌套内容可以是有效的FTL,下面是一个有些复杂的例子,我们将上面三个宏组合起来: <@border>
<#macro repeat count> <#local y = "test"> <#list 1..count as x> ${y} ${count}/${x}: <#nested> <@repeat count=3>${ydefault("")} ${xdefault("")} ${countdefault("")} 输出结果:
test 3/1: test 3/2: test 3/3: 在宏定义中使用循环变量 nestted指令也可以有循环变量(循环变量的含义见下节),调用宏的时候在宏指令的参数后面依次列出循环变量的名字,格式如下:
<@ macro_name paramter list; loop variable list[,]> 例如:
<#macro repeat count> <#list 1..count as x> <#nested x, x/2, x==count> <@repeat count=4 ; c, halfc, last> ${c}. ${halfc}<#if last> Last! 这里count是宏的参数,c, halfc,last则为循环变量,输出结果:
1. 2. 1 3. 4. 2 Last! 循环变量和宏标记指定的不同不会有问题,如果调用时少指定了循环变量,那么多余的值不可见。调用时多指定了循环变量,多余的循环变量不会被创建:
<@repeat count=4 ; c, halfc, last> ${c}. ${halfc}<#if last> Last!<@repeat count=4 ; c, halfc> ${c}. ${halfc}<@repeat count=4> Just repeat it... 在模板中定义变量 在模板中定义的变量有三种类型:
plain变量:可以在模板的任何地方访问,包括使用include指令插入的模板,使用assign指令创建和替换。 局部变量:在宏定义体中有效,使用local指令创建和替换。 循环变量:只能存在于指令的嵌套内容,由指令(如list)自动创建;宏的参数是局部变量,而不是循环变量 局部变量隐藏(而不是覆盖)同名的plain变量;循环变量隐藏同名的局部变量和plain变量,下面是一个例子:
<#assign x = "plain">${x} <#-- we see the plain var. here --><@test/>6. ${x} <#-- the value of plain var. was not changed --><#list ["loop"] as x> 7. ${x} <#-- now the loop var. hides the plain var. --> <#assign x = "plain2"> <#-- replace the plain var, hiding does not mater here --> 8. ${x} <#-- it still hides the plain var. -->9. ${x} <#-- the new value of plain var. --><#macro test> 2. ${x} <#-- we still see the plain var. here --> <#local x = "local"> 3. ${x} <#-- now the local var. hides it --> <#list ["loop"] as x> 4. ${x} <#-- now the loop var. hides the local var. --> 5. ${x} <#--