這是一篇Velocity入門級的文章，雖然很簡單，但確實能夠說明Velocity的工作原理，值得一讀。

使用Velocity 模板引擎開發網站

Velocity 是如何工作的呢？ 雖然大多 Velocity 的應用都是基于 Servlet 的網頁制作。但是為了說明 Velocity 的使用，我決定采用更通用的 java application 來說明它的工作原理。
　　似乎所有語言教學的開頭都是采用 HelloWorld 來作為第一個程序的示例。這里也不例外。

　　任何 Velocity 的應用都包括兩個方面:
　　第一是： 模板制作，在我們這個例子中就是 hellosite.vm:
　　它的內容如下（雖然不是以 Html 為主，但是這很容易改成一個 html 的頁面）

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

BTitle> 程序代碼

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 三層的邏輯結構發生混淆。

（出處：http://m.survivalescaperooms.com）