Velocity模版引擎

使用Velocity作为页面显示层是常见的，作为模版形式出现，可能用的不一定多，至少现在我只用过几次，下面也是以前找到的一篇文章，举例说明了Velocity作为模版的用法，还是很实用的！

通常，Velocity模板的文件后缀是“.vm”。下面我们要创建一个hellovelocity.vm模板文件，虽然很简单，但足以证明Velocity模板引擎是否正确安装，也足以显示出Velocity模板分离内容及其表现方式的一般过程。把下面这行代码加入hellovelocity.vm模板。

Hello $name, this is Velocity working!

保存hellovelocity.vm模板，然后再新建一个HelloVelocity.java文件，这两个文件最好放入同一目录下。下面是HelloVelocity.java的代码，它显示了在Java程序中调用Velocity模板引擎的一般过程。

（例1）

import java.io.StringWriter;

import org.apache.velocity.app.VelocityEngine;

import org.apache.velocity.Template;

import org.apache.velocity.VelocityContext;

public class HelloVelocity{

   public static void main(String[] args) throws Exception {

   /* 首先创建一个模板引擎的实例，并予以初始化 */

    VelocityEngine engine = new VelocityEngine();

    engine.init();

   /* 接着，获得一个模板 */

    Template template = engine.getTemplate( "hellovelocity.vm" );

   /* 创建上下文，填充数据 */

    VelocityContext context = new VelocityContext();

    context.put("name", "World");

    /* 现在，把模板和数据合并，输出到StringWriter */

    StringWriter writer = new StringWriter();

     template.merge( context, writer );

    /* 显示结果 */

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

   }

}

准备好两个文件后，编译Java文件并运行。如果一切顺利的话，你可以看到下面的输出：

Hello World, this is Velocity working!

（例2）

import java.io.BufferedWriter;
import java.io.OutputStreamWriter;

import org.apache.velocity.Template;
import org.apache.velocity.VelocityContext;
import org.apache.velocity.app.Velocity;

public class HelloVelocity {
    public static void main(String[] args) throws Exception {
        Velocity.init(); 
        VelocityContext context = new VelocityContext();
        context.put("name", "dreamhead");

        BufferedWriter writer = new BufferedWriter(new OutputStreamWriter(System.out));
        Template template = Velocity.getTemplate("hello.vm");
        template.merge(context, writer);

        writer.flush();
        writer.close();    
     }
}

我们可以把模板理解为一个剧本，剧本设定了剧情和角色，比如上面的剧情就是对一个角色——name说“Hello”。鉴于name是一个角色，为了不与剧本中的内容混杂，我们编写的时候需要加上一个“$”，以示区分。再好的剧本也需要表演出来，换句话说，角色要人来扮演，这些人共同按照剧本完成剧情。在上面的例子中，最终扮演name角色的是“dreamhead”这个字符串，它完成剧情规定的任务，结果就是“Hello,dreamhead”。

在这个过程中，我们——程序员是导演，拿来剧本，找来演员，规定各自的角色，一起看看我们如何完成这个指导过程吧！
在一切就绪之前，我们先要做一些准备性的工作：
    Velocity.init();
然后是分配角色，不过，为了防止死无对证，我们需要记录分配结果，这是VelocityContext的强项：
    VelocityContext context = new VelocityContext();
开始分配角色了，"dreamhead"扮演的角色是name：
    context.put("name", "dreamhead");
人员就位，准备开始拍摄了！怎么拍呢？当然是用摄影机拍，最终存放在胶片上了，准备胶片：
    BufferedWriter writer = new BufferedWriter(new OutputStreamWriter(System.out));
没有剧本我拿拍什么啊？剧本、剧本……
    Template template = Velocity.getTemplate("hello.vm");
对了，演员要看一下剧本的：
    template.merge(context, writer);
各部门准备，action！
    writer.flush();
cut！
    writer.close();

一个紧张而忙碌的拍摄过程就这样完成了，虽然从拍摄的过程来看，我们显得手忙脚乱，但结果还是比较理想的，因为我们熟悉的“Hello”出现在了我们的面前。模板的威力就在于，相同的剧本可以由不同的演员进行自己的诠释。也许尝试用自己的名字重新演绎Hello的传说，你就能体会到这一点了。