velocity的幾層窗戶紙
這幾天有一個項目要使用velocity來生成文件，遇到了一些問題，最后也輾轉(zhuǎn)找到了解決的方法。用一個朋友的話說，這就是一層窗戶紙。
開發(fā)環(huán)境：Tomcat5.5，Velocity-1.4
1、velocity模版和配置文件的位置
為了測試方便，我首先把根據(jù)模版生成文件的源代碼單獨拿出來，代碼（省去了無關(guān)的代碼）如下：
//FileManager.java
//初始化方法，獲得屬性配置
privatevoidinit(){
try{
Velocity.init("velocity.properties");
}catch(Exceptione){
System.out.println("初始化時發(fā)生錯誤！");
e.printStackTrace();
}
}
/**
*根據(jù)模板建立文件
*/
publicbooleancreateFile(Stringbt,Stringcontent,String[]tp,StringfileName){
//是否創(chuàng)建成功
booleanisCreateSuccess=true;
try{
//建立模版
VelocityContextcontext=newVelocityContext();
//設置各個變量
//…
//得到模版
Templatetemplate=Velocity.getTemplate("news.vm");
//寫入文件
//…
}catch(Exceptione){
//異常處理
//…
}
}
這里配置文件是：velocity.properties，模版文件：news.vm，它們和FileManager的package在同一個目錄下，如：
FileManager的package為com.bokee.mydeman，F(xiàn)ileManager.class的位置是C:1combokeemydemanFileManager.class，那么velocity.properties和news.vm的路徑就是C:1velocity.properties和C:1news.vm；如果FileManager沒有聲明package，那么配置文件和模版文件就和FileManager.class在同一個目錄下。
按照以上規(guī)則，測試通過。于是移植到Tomcat下面，可是配置文件和模版文件應該放在什么地方呢？按照上面的規(guī)則，它們就應該在WEB-INF/classes下，可是實際運行卻報出無法找到資源的異常。于是就把它們分別放在了web工程根目錄下、WEB-INF下等幾個位置，均報同樣的異常。google一下，發(fā)現(xiàn)竟然要放在system32下，呵呵，這樣放置程序如何移植？于是決定自己指定它們的路徑，修改后的程序如下：
//
publicclassFileManager{
privateStringconfig="";
//構(gòu)造函數(shù)中指定配置文件和模版文件所在的路徑
publicFileManager(Stringconfig){
this.config=config;
init();
}
/**
*初始化模版
*/
privatevoidinit(){
//…
Velocity.init(config+"/velocity.properties");
//…
}
/**
*根據(jù)模板建立文件
*/
publicbooleancreateFile(Stringbt,Stringcontent,String[]tp,StringfileName){
//…
Templatetemplate=Velocity.getTemplate(config+"/news.vm");
//…
}
}
保存測試，init()方法順利通過，可是模版仍然報出無法找到資源的異常。嗚呼，只有g(shù)oogle了，說是要使用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的中文問題像一個幽靈一樣總是在程序員的周圍轉(zhuǎn)來轉(zhuǎn)去，不定什么時候就會出來騷擾一下。
news.vm中使用了中文的字符串，在生成的文件中總是會變成莫名其妙的亂碼。查閱Velocity的Developer'sGuide文檔，在VelocityConfigurationKeysandValues一節(jié)中給出了具體的解決方法，使用input.encoding和output.encoding指定輸入和輸出的編碼格式（默認的是ISO-8859-1），于是在velocity.properties中分別指定二者的值：
input.encoding=GBK
output.encoding=GBK
單獨測試通過，可以正確輸出中文。可是在Tomcat中無論如何都出不來中文，把這兩個屬性值在ISO-8859-1、UTF-8和GBK中變換了無數(shù)次，仍然是亂碼。最后向高人求教，修改源代碼為：
Templatetemplate=engine.getTemplate("news.vm","GBK");
呵呵，一切OK！中文正常顯示，向其道謝，笑稱“一層窗戶紙”。
3、$velocityCount變量
vm文件中需要使用$velocityCount，并且文件包含了數(shù)個循環(huán)，而按照Velocity的DOC的說明，$velocityCount是循環(huán)的索引值，于是便擔心$velocityCount在下一個循環(huán)中，會不會以上一個循環(huán)的結(jié)束值為初始值，實際運行發(fā)現(xiàn)這種擔心是沒有必要，每次$velocityCount都是從1開始計數(shù)。
在循環(huán)中要用到$velocityCount的前一個值和后一個值，于是直接使用$velocityCount-1和$velocityCount+1。怪現(xiàn)象出現(xiàn)了，加1的情況可以正確計算出結(jié)果，并且能夠正確顯示，可是減1的語句直接把$velocityCount-1作為一個字符串輸出了。把表達式單獨提出來，仍然如此。于是改為#set($temp=$velocityCount-1)，呵呵，依然如此，$temp并沒有被賦為整數(shù)值，還是$velocityCount-1字符串。再次修改：
#set($temp=$velocityCount)
$temp-1
下載文檔
