轉 如何使用velocity模板引擎開發網站

標籤：style   http   color   java   使用   os   io   strong   

基於 Java 的網站開發，很多人都採用 JSP 作為前端網頁製作的技術，尤其在是國內。這種技術通常有一些問題，我試想一下我們是怎樣開發網站的，通常有幾種方法：

1：功能確定後，由美工設計網頁的UI（介面）部分，然後由程式員在其上加入代碼顯示邏輯（比如迴圈，判斷顯示資料結果）。也就是通常的 jsp 頁面製作，當然這部分可以由美工完成模板，然後由 jsp 工程師再繼續以它為原型建立相應的 jsp 頁面。

2：功能確定後，由美工設計網頁的UI（介面）部分，然後由網頁製作人員在其上加入代碼顯示邏輯（比如迴圈，判斷顯示資料結果），在這一步的 jsp 頁面製作中，網頁製作人員（通常只懂得 javascript 和 html ）在工程師的指導下學會如何嵌入 jsp taglib 標記，然後以美工的模板為原型製作 jsp 網頁。

顯然後面一種方式要比前面一種方式分工明確，然後在很多小公司，或者項目很急的情況下，jsp 網頁製作和背景程式開發都是同一個人。這樣無疑加大了程式員的負擔。 後一種情況雖然比前面的好，但是它有兩個缺點： 一：網頁製作人員必須學會如何使用 jsp taglib 的使用，這無疑加大了網頁製作人員的負擔。二：如果頁面因為客戶的要求從新設計，那麼無論那種情況網頁製作人員都要從新將顯示邏輯從新嵌入 jsp 網頁。

在這方面， jsp 做的並不好，雖然從效能角度和 taglib 的使用上來說，它比 php 和 asp 要強很多， 但是它在設計上很類似 php 這種伺服器頁面語言，也就是在頁面中嵌入指令碼語言的技術，雖然它比傳統的基於 CGI 的指令碼語言的開發模式速度快，但是它將背景程式邏輯與頁面顯示混淆了，所以從這個角度來說, 它是一種不太良好的設計。想想看，你看到的眾多 php 程式是怎麼樣子的吧，在一堆 .php 檔案中，你已經分不清楚那些是背景程式，那些只是用來顯示頁面的程式。

現在更多的網站製作採用一種 MVC 模式，也就是將網站製作工作分工，分別為M(Model, 模型)，V（View 視圖），C(Controller 控制器).

 

• M(Model, 模型）也就是背景事務邏輯，真正處理事務的代碼，商業邏輯等等。他們是整個網站最重要的工作部分，通常這部分代碼相對來說比較穩定，不經常變動，就是有所變動也不會對前端的頁面有什麼影響。

   

• V（View 視圖）: 也就是網頁的顯示部分，這個部分接受來自背景程式的結果或資料，進行顯示，但是這個部分通常是變化比較大的部分，比如網站的介面更新是經常要要作的事情，每隔一段時間更新網頁風格就會造成 View 視圖部分的大量更改工作。

   

• C(Controller 控制器). 在視圖和模型之間傳遞控制，並根據要求調用相應的視圖顯示模型返回的資料，主要負責調度工作。

  這種職責的分工到底有什麼好處呢，它簡化了軟體開發過程中所有相關人員的工作， 使得不同的部分的修改通常不會影響的其他部分的工作，比如，我修改了後台某些程式的演算法，並不影響前台的頁面顯示，前台頁面修改不影響背景程式的開發。這種分工合作比起 jsp 混淆代碼邏輯和顯示層的做法要好的多。

  所以越來越多的國外程式員在不斷提出替代 jsp 的方案，在眾多方案中， 一種基於 java 模板引擎的技術脫穎而出，最為著名的是 Velocity 和 Webmacro 兩種模板技術。

  模板引擎的設計思想最早是有 webmacro 提出的， 後來應用在一個著名的搜尋引擎 www.altavista.com上， 這種思想漸漸被 Apache 開發小組所採用，並作為一個子項目被提出來，這就是現在的 Velocity。模板引擎與MVC中視圖這一部分的關係更為密切。它是經常作為一種 jsp 的替代技術出現在國外的一些論壇上的。但是 Velocity 可以應用在任何需要格式化資料顯示的 java 程式中。

  那麼 Velocity 到底是什麼呢？它的官方解釋是：

  "Velocity 是一種基於 java 的模板引擎，它允許任何人使用簡單而強大的範本語言來引用定義在 java 代碼中的對象"

  你可能因為下面幾種原因而使用 Velocity:

  1:它很容易整合在各種各樣的程式領域中。

  2:它為網頁製作人員提供了一種清晰而又簡單的文法

  3:因為模板和代碼是分離的，所以你可以分別獨立的開發和維護它們。

  4:Velocity 引擎可以很容易的整合到一些 Java 運行環境，特別是 Servlet.

  5:Velocity 使得模板可以訪問任何環境對象中的共有方法。

  Velocity 的強大之處在於它嚴格的區分程式開發功能的職責劃分。 它限制模板可能訪問的對象（也就是背景程式允許它得到的對象）來實現這一點。這意味著，網頁設計人員可以只把精力放在資料的顯示部分（View 視圖）而程式員則只要關注如何寫好程式的控制層（Controller,控制器）和商業邏輯和資料管理（模型 Model）, 這就是 MVC 開發模式。MVC 現在已經是廣泛接受的一種開發模式，它簡化了開發和日益複雜的應用和維護工作。

  Velocity 最擅長做哪些方面的工作呢？

  1： 基於 servlet 的網站製作

  2： Java 和 Sql 代碼產生

  3： XML 處理和轉換

  4： 文文書處理，比如產生 TRF 檔案。

  不過 Velocity 用的最多的還是在基於 Java servlet 的網頁程式中作產生網頁的引擎，以替代 JSP 等技術。 除了比較容易使用外， 它提供了強大的範本語言以顯示和操作資料，但是不是產生資料，這點很重要， 因為這個工作應該是程式邏輯的部分。 Velocity 非常適合在 J2EE (Java 2 Platform, Enterprise Edition) 的網站開發中充當替代 jsp 做輸出頁面的技術工作，雖然 JSP 包含在 j2ee 的規範中，其實 j2ee 本身並不需要 jsp .

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.eiffelqiu.com");

/* now render the template into a StringWriter */

StringWriter writer = new StringWriter();

t.merge( context, writer );

/* show the World */

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

}

}將兩個檔案放在同一個目錄下，編譯運行，結果是：

Hello Eiffel Qiu! Welcome to http://www.eiffelqiu.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.eiffelqiu.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 三層的邏輯結構發生混淆。