velocity的几层窗户纸
2007-12-23 12:30:47 来源:WEB开发网这几天有一个项目要使用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.cncms.com)
更多精彩
赞助商链接