這是一篇Velocity入門(mén)級的文章,雖然很簡(jiǎn)單,但確實(shí)能夠說(shuō)明Velocity的工作原理,值得一讀。
使用Velocity 模板引擎開(kāi)發(fā)網(wǎng)站
Velocity 是如何工作的呢? 雖然大多 Velocity 的應用都是基于 Servlet 的網(wǎng)頁(yè)制作。但是為了說(shuō)明 Velocity 的使用,我決定采用更通用的 Java application 來(lái)說(shuō)明它的工作原理。
似乎所有語(yǔ)言教學(xué)的開(kāi)頭都是采用 HelloWorld 來(lái)作為第一個(gè)程序的示例。這里也不例外。
任何 Velocity 的應用都包括兩個(gè)方面:
第一是: 模板制作,在我們這個(gè)例子中就是 hellosite.vm:
它的內容如下(雖然不是以 HTML 為主,但是這很容易改成一個(gè) html 的頁(yè)面)
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() );
}
}
?將兩個(gè)文件放在同一個(gè)目錄下、(注意:在做一個(gè)項目時(shí)模版文件一定不要放在src目錄下否則會(huì )有異常拋出),編譯運行,結果是:
Hello Eiffel Qiu! Welcome to http://www.j2medev.com world
為了保證運行順利,請從 Velocity 的網(wǎng)站 http://jakarta.apache.org/velocity/ 上下載 Velocity 的運行包,將其中的 Velocity Jar 包的路徑放在系統的 Classpath 中,這樣就可以編譯和運行以上的程序了。
這個(gè)程序很簡(jiǎn)單,但是它能讓你清楚的了解 Velocity 的基本工作原理。程序中其他部分基本上很固定,最主要的部分在以下代碼
這里 Velocity 獲取模板文件,得到模板引用
/* next, get the Template */
Template t = ve.getTemplate( "hellosite.vm" );
這里,初始化環(huán)境,并將數據放入環(huán)境
/* create a context and add data */
VelocityContext context = new VelocityContext();
context.put("name", "Eiffel Qiu");
context.put("site", "http://www.j2medev.com");
其他代碼比較固定,但是也非常重要,但是對于每個(gè)應用來(lái)說(shuō)寫(xiě)法都很相同:
這是初始化 Velocity 模板引擎
/* first, get and initialize an engine */
VelocityEngine ve = new VelocityEngine();
ve.init();
這是用來(lái)將環(huán)境變量和輸出部分結合。
StringWriter writer = new StringWriter();
t.merge( context, writer );
/* show the World */
System.out.println( writer.toString() );
記住,這在將來(lái)的 servlet 應用中會(huì )有所區別,因為網(wǎng)頁(yè)輸出并不和命令行輸出相同,如果用于網(wǎng)頁(yè)輸出,將并不通過(guò) System.out 輸出。這會(huì )在以后的教程中給大家解釋的。
那讓我來(lái)總結一下 Velocity 真正的工作原理:
Velocity 解決了如何在 Servlet 和 網(wǎng)頁(yè)之間傳遞數據的問(wèn)題,當然這種傳輸數據的機制是在 MVC 模式上進(jìn)行的,也就是View 和 Modle , Controller 之間相互獨立工作,一方的修改不影響其他方變動(dòng),他們之間是通過(guò)環(huán)境變量(Context)來(lái)實(shí)現的,當然雙方網(wǎng)頁(yè)制作一方和后臺程序一方要相互約定好對所傳遞變量的命名約定,比如上個(gè)程序例子中的 site, name 變量,它們在網(wǎng)頁(yè)上就是 $name ,$site 。 這樣只要雙方約定好了變量名字,那么雙方就可以獨立工作了。 無(wú)論頁(yè)面如何變化,只要變量名不變,那么后臺程序就無(wú)需改動(dòng),前臺網(wǎng)頁(yè)也可以任意由網(wǎng)頁(yè)制作人員修改。這就是 Velocity 的工作原理。
你會(huì )發(fā)現簡(jiǎn)單變量名通常無(wú)法滿(mǎn)足網(wǎng)頁(yè)制作顯示數據的需要,比如我們經(jīng)常會(huì )循環(huán)顯示一些數據集,或者是根據一些數據的值來(lái)決定如何顯示下一步的數據, Velocity 同樣提供了循環(huán),判斷的簡(jiǎn)單語(yǔ)法以滿(mǎn)足網(wǎng)頁(yè)制作的需要。Velocity 提供了一個(gè)簡(jiǎn)單的模板語(yǔ)言以供前端網(wǎng)頁(yè)制作人員使用,這個(gè)模板語(yǔ)言足夠簡(jiǎn)單(大部分懂得javascript的人就可以很快掌握,其實(shí)它比 javascript 要簡(jiǎn)單的多),當然這種簡(jiǎn)單是刻意的,因為它不需要它什么都能做, View 層其實(shí)不應該包含更多的邏輯,Velocity 的簡(jiǎn)單模板語(yǔ)法可以滿(mǎn)足你所有對頁(yè)面顯示邏輯的需要,這通常已經(jīng)足夠了,這里不會(huì )發(fā)生象 jsp 那樣因為一個(gè)無(wú)限循環(huán)語(yǔ)句而毀掉系統的情況,jsp 能做很多事情,Sun 在制定 Jsp 1.0 標準的時(shí)候,沒(méi)有及時(shí)的限定程序員在 jsp 插入代碼邏輯,使得早期的jsp 代碼更象是 php 代碼,它雖然強大,但是對顯示層邏輯來(lái)說(shuō),并不必要,而且會(huì )使 MVC 三層的邏輯結構發(fā)生混淆。