freemarker 模板开发指南

《freemarker 模板开发指南》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、FreeMarker概述FreeMarker是一个模板引擎，一个基于模板生成文本输出的通用工具，使用纯Java编写FreeMarker被设计用来生成HTMLWeb页面，特别是基于MVC模式的应用程序虽然FreeMarker具有一些编程的能力，但通常由Java程序准备要显示的数据，由FreeMarker生成页面，通过模板显示准备的数据（如下图）FreeMarker不是一个Web应用框架，而适合作为Web应用框架一个组件FreeMarker与容器无关，因为它并不知道HTTP或Servlet；FreeMar

2、ker同样可以应用于非Web应用程序环境FreeMarker更适合作为Model2框架（如Struts）的视图组件，你也可以在模板中使用JSP标记库FreeMarker是免费的FreeMarker特性1、通用目标能够生成各种文本：HTML、XML、RTF、Java源代码等等易于嵌入到你的产品中：轻量级；不需要Servlet环境插件式模板载入器：可以从任何源载入模板，如本地文件、数据库等等你可以按你所需生成文本：保存到本地文件；作为Email发送；从Web应用程序发送它返回给Web浏览器2、强大的模板语

3、言所有常用的指令：include、if/elseif/else、循环结构在模板中创建和改变变量几乎在任何地方都可以使用复杂表达式来指定值命名的宏，可以具有位置参数和嵌套内容名字空间有助于建立和维护可重用的宏库，或者将一个大工程分成模块，而不必担心名字冲突输出转换块：在嵌套模板片段生成输出时，转换HTML转义、压缩、语法高亮等等；你可以定义自己的转换3、通用数据模型FreeMarker不是直接反射到Java对象，Java对象通过插件式对象封装，以变量方式在模板中显示你可以使用抽象（接口）方式表示对象（J

4、avaBean、XML文档、SQL查询结果集等等），告诉模板开发者使用方法，使其不受技术细节的打扰4、为Web准备在模板语言中内建处理典型Web相关任务（如HTML转义）的结构能够集成到Model2Web应用框架中作为JSP的替代支持JSP标记库为MVC模式设计：分离可视化设计和应用程序逻辑；分离页面设计员和程序员5、智能的国际化和本地化字符集智能化（内部使用UNICODE）数字格式本地化敏感日期和时间格式本地化敏感非US字符集可以用作标识（如变量名）多种不同语言的相同模板6、强大的XML处理能力<#

5、recurse>和<#visit>指令（2.3版本）用于递归遍历XML树在模板中清楚和直觉的访问XML对象模型FreeMarkervs.Velocity1、概述Velocity是一个简单而且更加轻量级的工具，但是它没有达到FreeMarker能够做的许多任务，而且它的模板语言不是很强大我们认为对于大多数应用程序，FreeMarker比Velocity工作更简单，因为：Ø使用Velocity，你需要寻找特定工具或各种工作环境来一次次的解决典型的模板创作任务，结果会浪费更多时间Ø工作环境经常意味着在Vel

6、ocity模板中直接使用Java对象的方法，这违反了简单、无编程HTML设计的观念Ø或者将表示任务移到控制器代码中，这违反了MVC模式使用FreeMarker，可以以out-of-the-box（如何翻译确切？）的方式实现Velocity所能做的 2、特性比较清单下面是一个使用FreeMarker能够实现，而Velocity不能实现的不太全面的特性清单：（1）数字和日期支持可以对任何数字类型进行算术运算和比较，包括精度类型可以比较和显示（格式化）日期/时间值（2）国际化根据各种内建和定制的数字格式，格

7、式化本地敏感的数字根据各种内建和定制的日期格式，格式化本地敏感和时区敏感的日期标识（变量名）可以包含非英语字符，如重音字符、阿拉伯字符、中文字符等（3）循环处理可以跳出循环可以在循环外访问循环体内的控制变量可以测试是否达到最后一次循环（4）模板级别的数组处理可以使用类似[i]语法的索引方式访问数组元素可以查询数组长度（5）宏宏可以有局部变量可以递归调用宏，同样可以在模板的后面定义要调用的宏调用宏时，可以按位置或名字的方式传递参数宏参数可以有缺省值，使得在调用时忽略参数也有效调用的宏可以有嵌套的体内容（

8、<@myMacro>body），能够在宏被调用时进行处理宏是纯变量的，可以基于表达式来执行宏，或者作为参数传递给另一个宏（6）命名空间可以对变量使用多命名空间，这对创建宏库很重要，因为这可以避免应用程序中指定的变量和宏库中变量的名字冲突（7）使用内建的函数/操作符维护Java无关的string、list和map可以将字符串转换成大/小写、首字符大/小写，对HTML、XML或RTF进行转义处理，substring、split、查询字符