这几天有一个项目要使用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
运行后，查看生成的文件，问题解决，终于得到了需要的整数值。
（出处：http://www.knowsky.com）
