velocity的幾層窗戶紙

這幾天有一個項目要使用velocity來生成文件，遇到了一些問題，最后也輾轉找到了解決的方法。用一個朋友的話說，這就是一層窗戶紙。

開發環境：Tomcat5.5，Velocity-1.4

1、velocity模版和配置文件的位置

為了測試方便，我首先把根據模版生成文件的源代碼單獨拿出來，代碼（省去了無關的代碼）如下：

//FileManager.java

//初始化方法，獲得屬性配置

privatevoidinit(){

try{

Velocity.init(velocity.properties);

}catch(Exceptione){

System.out.println(初始化時發生錯誤！);

e.printStackTrace();

}

}

/**

*根據模板建立文件

*/

publicbooleancreateFile(Stringbt,Stringcontent,String[]tp,StringfileName){

//是否創建成功

booleanisCreateSuccess=true;

try{

//建立模版

VelocityContextcontext=newVelocityContext();

//設置各個變量

//…

//得到模版

Templatetemplate=Velocity.getTemplate(news.vm);

//寫入文件

//…

}catch(Exceptione){

//異常處理

//…

}

}

這里配置文件是：velocity.properties，模版文件：news.vm，它們和FileManager的package在同一個目錄下，如：

FileManager的package為com.bokee.mydeman，FileManager.class的位置是C:1combokeemydemanFileManager.class，那么velocity.properties和news.vm的路徑就是C:1velocity.properties和C:1news.vm；如果FileManager沒有聲明package，那么配置文件和模版文件就和FileManager.class在同一個目錄下。

按照以上規則，測試通過。于是移植到Tomcat下面，可是配置文件和模版文件應該放在什么地方呢？按照上面的規則，它們就應該在WEB-INF/classes下，可是實際運行卻報出無法找到資源的異常。于是就把它們分別放在了web工程根目錄下、WEB-INF下等幾個位置，均報同樣的異常。google一下，發現竟然要放在system32下，呵呵，這樣放置程序如何移植？于是決定自己指定它們的路徑，修改后的程序如下：

//

publicclassFileManager{

privateStringconfig=;

//構造函數中指定配置文件和模版文件所在的路徑

publicFileManager(Stringconfig){

this.config=config;

init();

}

/**

*初始化模版

*/

privatevoidinit(){

//…

Velocity.init(config+/velocity.properties);

//…

}

/**

*根據模板建立文件

*/

publicbooleancreateFile(Stringbt,Stringcontent,String[]tp,StringfileName){

//…

Templatetemplate=Velocity.getTemplate(config+/news.vm);

//…

}

}

保存測試，init()方法順利通過，可是模版仍然報出無法找到資源的異常。嗚呼，只有google了，說是要使用Velocity的ResourceEngine來加載資源，否則找不到vm文件。按照指示修改源代碼，如下：

VelocityEngineengine=newVelocityEngine();

Propertiesproperties=newProperties();

properties.setProperty(Velocity.FILE_RESOURCE_LOADER_PATH,config);

engine.init(properties);

Templatetemplate=engine.getTemplate(news.vm);

重新運行測試，OK！

2、模版的中文問題

Java的中文問題像一個幽靈一樣總是在程序員的周圍轉來轉去，不定什么時候就會出來騷擾一下。

news.vm中使用了中文的字符串，在生成的文件中總是會變成莫名其妙的亂碼。查閱Velocity的Developer'sGuide文檔，在VelocityConfigurationKeysandValues一節中給出了具體的解決方法，使用input.encoding和output.encoding指定輸入和輸出的編碼格式（默認的是ISO-8859-1），于是在velocity.properties中分別指定二者的值：

input.encoding=GBK

output.encoding=GBK

單獨測試通過，可以正確輸出中文。可是在Tomcat中無論如何都出不來中文，把這兩個屬性值在ISO-8859-1、UTF-8和GBK中變換了無數次，仍然是亂碼。最后向高人求教，修改源代碼為：

Templatetemplate=engine.getTemplate(news.vm,GBK);

呵呵，一切OK！中文正常顯示，向其道謝，笑稱“一層窗戶紙”。

3、$velocityCount變量

vm文件中需要使用$velocityCount，并且文件包含了數個循環，而按照Velocity的DOC的說明，$velocityCount是循環的索引值，于是便擔心$velocityCount在下一個循環中，會不會以上一個循環的結束值為初始值，實際運行發現這種擔心是沒有必要，每次$velocityCount都是從1開始計數。

在循環中要用到$velocityCount的前一個值和后一個值，于是直接使用$velocityCount-1和$velocityCount+1。怪現象出現了，加1的情況可以正確計算出結果，并且能夠正確顯示，可是減1的語句直接把$velocityCount-1作為一個字符串輸出了。把表達式單獨提出來，仍然如此。于是改為#set($temp=$velocityCount-1)，呵呵，依然如此，$temp并沒有被賦為整數值，還是$velocityCount-1字符串。再次修改：

#set($temp=$velocityCount)

$temp-1