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