FreeMarker是一个模版引擎,一个基于模版生成文本输出的通用工具,使用纯Java编写。FreeMarker被设计用来生成HTML Web页面,特别是基于MVC模式的应用程序。
http://www.sunjava.cn/FreeMarker.htm http://freemarker.sourceforge.net/docs/index.html
FreeMarker有一些编成能力,但通常情况下用java程序准备要显示的数据,由FreeMarker生成页面,通过模版显示准备的数据。FreeMarker不是一个Web应用框架,而更适合作为一个Web应用框架的一个组件。FreeMarker与容器无关,它并不知道HTTP或者Servlet,FreeMarker同样可以用于非Web应用环境。FreeMarker更适合Model2的视图组件,同样可以在模版中使用JSP标记库。
FreeMarker的通用目标:能够生成各种文本,HTML、XML、RTF、Java源代码等等;易于嵌入,轻量级、不需要Servlet环境;插件式的模版载入器,可以在任何源载入,如本地文件、数据库等等;按需生成文本,保存到本地文件、作为Email发送、从Web应用程序发送它返回到Web浏览器。
强大的模版语言:所有常用的指令,include、if/elseif/else、循环结构。在模板中创建和改变变量。可以使用复杂的表达式来使用值。命名的宏,可以具有位置参数和嵌套内容。名字空间有助于建立和维护可重用的宏库,或者将一个大的工程分为若干个模块,而不必担心命名的冲突。输出转换块,在嵌套模版片断生成输出时,转换HTML转义、压缩、语法高亮等等。。
通用的数据模型:FreeMarker不是直接反映到java对象,java对象通过插件式封装,以变量的方式在模版中展示。使用抽象的方式表示对象,使其不受技术细节的打扰。
在模板语言中内建处理典型Web 相关任务(如HTML 转义)的结构
能够集成到Model2Web 应用框架中作为JSP 的替代
支持JSP 标记库
为MVC 模式设计:分离可视化设计和应用程序逻辑;分离页面设计员和程序员
5、智能的国际化和本地化
字符集智能化(内部使用UNICODE)
数字格式本地化敏感
日期和时间格式本地化敏感
非US 字符集可以用作标识(如变量名)
多种不同语言的相同模板
6、强大的XML 处理能力
<#recurse> 和<#visit>指令(2.3 版本)用于递归遍历XML 树
在模板中清楚和直觉的访问XML 对象模型
FreeMarker是一个Java模版语言,它是 JSP 的绝佳替代方案. FreeMarker在你的action result可能需要在Servlet容器环境以外被载入的情况下是理想选择. 例如,如果你希望在你的应用程序中支持plugins,你可能会乐意使用Freemarker,因为那样的话plugins可以支持将所有的action class和view都打包到一个从classloader进行装载的jar文件里面.
关于FreeMarker的更多信息,请访问FreeMarker网站.
FreeMarker与Velocity非常相似, 它们都是可以在Servlet容器外使用的模版语言. WebWork小组更推荐FreeMarker, 而不是Velocity, 这是因为FreeMarker提供了更好的错误报告, 支持JSP标签, 稍多的功能. 当然, 这两种技术都是代替JSP的很好方案.
快速上手
确认配置好你的项目的classpath中的所有依赖以后, 开始使用FreeMarker就非常简单了. 典型情况下只需要 freemarker.jar. 除它以外, webwork-default.xml已经配置好了将FreeMarker Result映射到你的模版文件. 你现在可以试验一下如下 xwork.xml 配置:
<action name="test" class="com.acme.TestAction">
<result name="success" type="freemarker">test-success.ftl</result>
</action
然后写好 test-success.ftl:
<html>
<head>
<title>Hello</title>
</head>
<body>
Hello, ${name}
</body>
</html>
这里 name 是你的action中的一个属性. 这样就可以了! 该文档的余下部分将介绍模版如何被加载, 变量如何解析, tags(标签)也可以使用.
模版加载
Webwork在两个位置查找FreeMarker模版(按顺序):
Web应用程序目录(Web application)
Class path
这个顺序对于在完全编译的jar中提供模版很理想, 但是也同时支持在Web应用程序目录中定义这些模版来覆盖jar中的模版文件. 事实上, 这就是为什么你可以覆盖WebWork中默认的UI tags和Form Tags的原理.
FreeMarker是一个模板引擎,一个基于模板生成文本输出的通用工具,使用纯Java编写
l FreeMarker被设计用来生成HTML Web页面,特别是基于MVC模式的应用程序
l 虽然FreeMarker具有一些编程的能力,但通常由Java程序准备要显示的数据,由FreeMarker生成页面,通过模板显示准备的数据(如下图)
l FreeMarker不是一个Web应用框架,而适合作为Web应用框架一个组件
l FreeMarker与容器无关,因为它并不知道HTTP或Servlet;FreeMarker同样可以应用于非Web应用程序环境
l FreeMarker更适合作为Model2框架(如Struts)的视图组件,你也可以在模板中使用JSP标记库
l FreeMarker是免费的
1、通用目标
l 能够生成各种文本:HTML、XML、RTF、Java源代码等等
l 易于嵌入到你的产品中:轻量级;不需要Servlet环境
l 插件式模板载入器:可以从任何源载入模板,如本地文件、数据库等等
l 你可以按你所需生成文本:保存到本地文件;作为Email发送;从Web应用程序发送它返回给Web浏览器
2、强大的模板语言
l 所有常用的指令:include、if/elseif/else、循环结构
l 在模板中创建和改变变量
l 几乎在任何地方都可以使用复杂表达式来指定值
l 命名的宏,可以具有位置参数和嵌套内容
l 名字空间有助于建立和维护可重用的宏库,或者将一个大工程分成模块,而不必担心名字冲突
l 输出转换块:在嵌套模板片段生成输出时,转换HTML转义、压缩、语法高亮等等;你可以定义自己的转换
3、通用数据模型
l FreeMarker不是直接反射到Java对象,Java对象通过插件式对象封装,以变量方式在模板中显示
l 你可以使用抽象(接口)方式表示对象(JavaBean、XML文档、SQL查询结果集等等),告诉模板开发者使用方法,使其不受技术细节的打扰
4、为Web准备
l 在模板语言中内建处理典型Web相关任务(如HTML转义)的结构
l 能够集成到Model2 Web应用框架中作为JSP的替代
l 支持JSP标记库
l 为MVC模式设计:分离可视化设计和应用程序逻辑;分离页面设计员和程序员
5、智能的国际化和本地化
l 字符集智能化(内部使用UNICODE)
l 数字格式本地化敏感
l 日期和时间格式本地化敏感
l 非US字符集可以用作标识(如变量名)
l 多种不同语言的相同模板
6、强大的XML处理能力
l <#recurse> 和<#visit>指令(2.3版本)用于递归遍历XML树
l 在模板中清楚和直觉的访问XML对象模型