Velocity 模板引擎介绍

在现今的软件开发过程中，软件开发人员将更多的精力投入在了重复的相似劳动中。特别是在如今特别流行的 MVC 架构模式中，软件各个层次的功能更加独立，同时代码的相似度也更加高。所以我

们需要寻找一种来减少软件开发人员重复劳动的方法，让程序员将更多的精力放在业务逻辑以及其他更加具有创造力的工作上。Velocity 这个模板引擎就可以在一定程度上解决这个问题。

Velocity 是一个基于 Java 的模板引擎框架，提供的模板语言可以使用在 Java 中定义的对象和变量上。Velocity 是 Apache 基金会的项目，开发的目标是分离 MVC 模式中的持久化层和业务层。但

是在实际应用过程中，Velocity 不仅仅被用在了 MVC 的架构中，还可以被用在以下一些场景中。

1. Web 应用：开发者在不使用 JSP 的情况下，可以用 Velocity 让 HTML 具有动态内容的特性。

2. 源代码生成：Velocity 可以被用来生成 Java 代码、SQL 或者 PostScript。有很多开源和商业开发的软件是使用 Velocity 来开发的。

3. 自动 Email：很多软件的用户注册、密码提醒或者报表都是使用 Velocity 来自动生成的。使用 Velocity 可以在文本文件里面生成邮件内容，而不是在 Java 代码中拼接字符串。

4. 转换 xml：Velocity 提供一个叫 Anakia 的 ant 任务，可以读取 XML 文件并让它能够被 Velocity 模板读取。一个比较普遍的应用是将 xdoc 文档转换成带样式的 HTML 文件。

5. MVC架构：分离 MVC 模式中的持久化层和业务层

Hello Velocity

和学习所有新的语言或者框架的顺序一样，我们从 Hello Velocity 开始学习。首先在 Velocity 的官网上下载最新的发布包，之后使用 Eclipse 建立普通的 Java 项目。引入解压包中的 velocity-

1.7.jar 和 lib 文件夹下面的 jar 包。这样我们就可以在项目中使用 Velocity 了。

项目的主体是两个文件，文件的位置如下图：

在做完上面的准备工作之后，就可以新建一个叫 HelloVelocity 的类，代码如下：

清单 1. HelloVelocity.java

  public class HelloVelocity {

   public static void main(String[] args) {

   VelocityEngine ve = new VelocityEngine();

   ve.setProperty(RuntimeConstants.RESOURCE_LOADER, "classpath");

   ve.setProperty("classpath.resource.loader.class", ClasspathResourceLoader.class.getName());

   ve.init();

   Template t = ve.getTemplate("hellovelocity.vm");

  VelocityContext ctx = new VelocityContext();

  ctx.put("name", "velocity");

  ctx.put("date", (new Date()).toString());

  List temp = new ArrayList();

  temp.add("");

  temp.add("");

  ctx.put("list", temp);

  StringWriter sw = new StringWriter();

  t.merge(ctx, sw);

  System.out.println(sw.toString());

  }

 }

在 HelloVelocity 的代码中，首先 new 了一个 VelocityEngine 类，这个类设置了 Velocity 使用的一些配置，在初始化引擎之后就可以读取 hellovelocity.vm 这个模板生成的 Template 这个类。之后

的 VelocityContext 类是配置 Velocity 模板读取的内容。这个 context 可以存入任意类型的对象或者变量，让 template 来读取。这个操作就像是在使用 JSP 开发时，往 request 里面放入 key-

value，让 JSP 读取一样。

接下来就是写 hellovelocity.vm 文件了，这个文件实际定义了 Velocity 的输出内容和格式。hellovelocity.vm 的内容如下：

清单 2. Hellovelocity.vm

#set( $iAmVariable = "good!" )

Welcome $name to velocity.com

today is $date.

#foreach ($i in $list)

    $i

    #end

iAmVariable

输出结果如下：

Welcome velocity to velocity.com

today is Sun Mar  :: CST .

good!

在输出结果中我们可以看到，$name、$date 都被替换成了在 HelloVelocity.java 里面定义的变量，在 foreach 语句里面遍历了 list 的每一个元素，并打印出来。而$iAmVariable 则是在页面中使用

#set 定义的变量。