velocity的幾層窗戶紙

2019-11-18 16:15:26

字體：大中小

來源：轉載

供稿：網友

這幾天有一個項目要使用velocity來生成文件，遇到了一些問題，最后也輾轉找到了解決的方法。用一個朋友的話說，這就是一層窗戶紙。
開發環境：Tomcat5.5，Velocity-1.4
1、velocity模版和配置文件的位置
   為了測試方便，我首先把根據模版生成文件的源代碼單獨拿出來，代碼（省去了無關的代碼）如下：
   //FileManager.java
   //初始化方法，獲得屬性配置
   PRivate void init() {
  try {
   Velocity.init("velocity.properties");

  } catch(Exception e) {
   System.out.println("初始化時發生錯誤！");
   e.printStackTrace();
  }
}

        /**
* 根據模板建立文件
*/
public boolean createFile(String BT, String content, String[] tp, String fileName) {
  //是否創建成功
  boolean isCreateSUCcess = true;

  try {
   //建立模版
   VelocityContext context = new VelocityContext();

   //設置各個變量
   //…

   //得到模版
   Template template = Velocity.getTemplate("news.vm");

   //寫入文件
   //…
  } catch (Exception e) {
   //異常處理
   //…
  }
          }
   這里配置文件是：velocity.properties，模版文件：news.vm，它們和FileManager的package在同一個目錄下，如：
   FileManager的package為com.bokee.mydeman，FileManager.class的位置是C:/1/com/bokee/mydeman/FileManager.class，那么velocity.properties和news.vm的路徑就是C:/1/velocity.properties和C:/1/news.vm；如果FileManager沒有聲明package，那么配置文件和模版文件就和FileManager.class在同一個目錄下。
   按照以上規則，測試通過。于是移植到Tomcat下面，可是配置文件和模版文件應該放在什么地方呢？按照上面的規則，它們就應該在WEB-INF/classes下，可是實際運行卻報出無法找到資源的異常。于是就把它們分別放在了web工程根目錄下、WEB-INF下等幾個位置，均報同樣的異常。Google一下，發現竟然要放在system32下，呵呵，這樣放置程序如何移植？于是決定自己指定它們的路徑，修改后的程序如下：
　　//
　　public class FileManager {
private String config = "";

        //構造函數中指定配置文件和模版文件所在的路徑
public FileManager(String config) {
  this.config = config;
  init();
}

/**
* 初始化模版
*/
private void init() {
  //…
   Velocity.init(config + "/velocity.properties");
  //…
}

/**
* 根據模板建立文件
*/
public boolean createFile(String bt, String content, String[] tp, String fileName) {
  //…
   Template template = Velocity.getTemplate(config + "/news.vm");

  //…
}

    }
   保存測試，init()方法順利通過，可是模版仍然報出無法找到資源的異常。嗚呼，只有google了，說是要使用Velocity的ResourceEngine來加載資源，否則找不到vm文件。按照指示修改源代碼，如下：
   VelocityEngine engine = new VelocityEngine();
   Properties properties = new Properties();
   properties.setProperty(Velocity.FILE_RESOURCE_LOADER_PATH, config);
   engine.init(properties);
   Template template = engine.getTemplate("news.vm");
   重新運行測試，OK！
2、模版的中文問題
   Java的中文問題像一個幽靈一樣總是在程序員的周圍轉來轉去，不定什么時候就會出來騷擾一下。
   news.vm中使用了中文的字符串，在生成的文件中總是會變成莫名其妙的亂碼。查閱Velocity的Developer's Guide文檔，在Velocity Configuration Keys and Values一節中給出了具體的解決方法，使用input.encoding和output.encoding指定輸入和輸出的編碼格式（默認的是ISO-8859-1），于是在velocity.properties中分別指定二者的值：
   input.encoding = GBK
   output.encoding = GBK
   單獨測試通過，可以正確輸出中文。可是在Tomcat中無論如何都出不來中文，把這兩個屬性值在ISO-8859-1、UTF-8和GBK中變換了無數次，仍然是亂碼。最后向高人求教，修改源代碼為：
   Template template = 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
   運行后，查看生成的文件，問題解決，終于得到了需要的整數值。