Velocity入门

是一篇Velocity入门级的文章，虽然很简单，但确实能够说明Velocity的工作原理，值得一读。

使用Velocity 模板引擎开发网站

Velocity 是如何工作的呢？ 虽然大多 Velocity 的应用都是基于 Servlet 的网页制作。但是为了说明 Velocity 的使用，我决定采用更通用的 Java application 来说明它的工作原理。 
　　似乎所有语言教学的开头都是采用 HelloWorld 来作为第一个程序的示例。这里也不例外。 

　　任何 Velocity 的应用都包括两个方面:
　　第一是： 模板制作，在我们这个例子中就是 hellosite.vm:
　　它的内容如下（虽然不是以 HTML 为主，但是这很容易改成一个 html 的页面）

Hello $name! Welcome to $site world!
　　第二是 Java 程序部分：
　　下面是 Java 代码

 程序代码

import java.io.StringWriter;
import org.apache.velocity.app.VelocityEngine;
import org.apache.velocity.Template;
import org.apache.velocity.VelocityContext;
public class HelloWorld{
public static void main( String[] args )throws Exception{
   /* first, get and initialize an engine */
   VelocityEngine ve = new VelocityEngine();
   ve.init();
   /* next, get the Template */
   Template t = ve.getTemplate( "hellosite.vm" );
   /* create a context and add data */
   VelocityContext context = new VelocityContext();
   context.put("name", "Eiffel Qiu");
   context.put("site", "http://www.j2medev.com");
   /* now render the template into a StringWriter */
   StringWriter writer = new StringWriter();
   t.merge( context, writer );
   /* show the World */
   System.out.println( writer.toString() ); 
}
}

将两个文件放在同一个目录下、（注意：在做一个项目时模版文件一定不要放在src目录下否则会有异常抛出），编译运行，结果是： 
Hello Eiffel Qiu! Welcome to http://www.j2medev.com world 

　　为了保证运行顺利，请从 Velocity 的网站 http://jakarta.apache.org/velocity/ 上下载 Velocity 的运行包，将其中的 Velocity Jar 包的路径放在系统的 Classpath 中，这样就可以编译和运行以上的程序了。

这个程序很简单，但是它能让你清楚的了解 Velocity 的基本工作原理。程序中其他部分基本上很固定，最主要的部分在以下代码 

　　这里 Velocity 获取模板文件，得到模板引用

 程序代码

/* next, get the Template */
Template t = ve.getTemplate( "hellosite.vm" );

　　这里，初始化环境，并将数据放入环境

 程序代码

/* create a context and add data */
VelocityContext context = new VelocityContext();
context.put("name", "Eiffel Qiu");
context.put("site", "http://www.j2medev.com");

　　其他代码比较固定，但是也非常重要，但是对于每个应用来说写法都很相同：
这是初始化 Velocity 模板引擎

 程序代码

/* first, get and initialize an engine */
VelocityEngine ve = new VelocityEngine();
ve.init();

　　这是用来将环境变量和输出部分结合。

 程序代码

StringWriter writer = new StringWriter();
t.merge( context, writer );
/* show the World */
System.out.println( writer.toString() );

　　记住，这在将来的 servlet 应用中会有所区别，因为网页输出并不和命令行输出相同，如果用于网页输出，将并不通过 System.out 输出。这会在以后的教程中给大家解释的。 

那让我来总结一下 Velocity 真正的工作原理： 
　　Velocity 解决了如何在 Servlet 和 网页之间传递数据的问题，当然这种传输数据的机制是在 MVC 模式上进行的，也就是View 和 Modle , Controller 之间相互独立工作，一方的修改不影响其他方变动，他们之间是通过环境变量（Context）来实现的，当然双方网页制作一方和后台程序一方要相互约定好对所传递变量的命名约定，比如上个程序例子中的 site, name 变量，它们在网页上就是 $name ,$site 。 这样只要双方约定好了变量名字，那么双方就可以独立工作了。 无论页面如何变化，只要变量名不变，那么后台程序就无需改动，前台网页也可以任意由网页制作人员修改。这就是 Velocity 的工作原理。 

　　你会发现简单变量名通常无法满足网页制作显示数据的需要，比如我们经常会循环显示一些数据集，或者是根据一些数据的值来决定如何显示下一步的数据， Velocity 同样提供了循环，判断的简单语法以满足网页制作的需要。Velocity 提供了一个简单的模板语言以供前端网页制作人员使用，这个模板语言足够简单（大部分懂得javascript的人就可以很快掌握，其实它比 javascript 要简单的多），当然这种简单是刻意的，因为它不需要它什么都能做， View 层其实不应该包含更多的逻辑，Velocity 的简单模板语法可以满足你所有对页面显示逻辑的需要，这通常已经足够了，这里不会发生象 jsp 那样因为一个无限循环语句而毁掉系统的情况，jsp 能做很多事情，Sun 在制定 Jsp 1.0 标准的时候，没有及时的限定程序员在 jsp 插入代码逻辑，使得早期的jsp 代码更象是 php 代码，它虽然强大，但是对显示层逻辑来说，并不必要，而且会使 MVC 三层的逻辑结构发生混淆。