简介
Velocity是基于Java开发的模板引擎,一款简单而强大的开发工具,可以方便的按照格式创建、渲染文档和显示数据。在本指南中,我们希望能够对使用Velocity开发的基本知识做一个概述。
使用Velocity构建Web应用
Velocity通常被用于构建Web应用程序,想要在Web应用中使用Velocity,还需要一个servlet或以servlet为基础的框架。最直接的方法就是使用VelocityViewServlet(在Velocity Tools子项目中),也可以使用许多第三方框架或者根据接下来介绍的技术自己构建servlet。
为了方便做出选择,我们推荐阅读这篇文章getting started with web applications以获取更多信息。
下载Velocity
可以在Apache Velocity主下载站点下载Velocity或Velocity Tools的最新发行版本,Velocity的源码也包含在其中。
如果想下载最新的源码,可以通过svn,或者下载完整的nightly snapshot。
如何从源码编译Velocity在Build文档中有相关说明。
依赖关系
Velocity需要用到Java 2 API的许多元素,诸如集合,因此编译Velocity需要Java 2标准版SDK(Software Development Kit)。运行Velocity,需要Java 2标准版RTE(运行时环境),或者使用SDK当然也是可以的。
Velocity的基本功能还要依赖于一些包。这些包就在 build/lib 目录下,但默认的构建选项并不包含这些包,如果使用默认的编译选项,必须将这些依赖的包添加到classpath中。
- Jakarta Commons Collections – 必选
- Jakarta Commons Lang – 必选.
- Excalibur (ex-Avalon) Logkit – 可选,但很常见. 如果使用Velocity默认的文件日志方式是必选依赖.
- Jakarta ORO – 可选. 当使用 org.apache.velocity.convert.WebMacro 模板转换工具或者org.apache.velocity.app.event.implement.EscapeReference ReferenceInsertionEventHandler时为必选依赖.