velocity的使用示例（转）
xiajlxiajl 2011-07-28
不少人看过或了解过Velocity，名称字面翻译为：速度、速率、迅速，用在Web开发里，用过的人可能不多，大都基本知道和在使用Struts，到底 Velocity和Struts是如何联系，怎么看待Velocity呢？让我们来尝试一下，了解Velocity的概念，通过在这里的介绍，强调在技术选择上的问题，让大家在选择项目开发时，可以考虑Velocity，另外也让大家了解它的思想，毕竟它提供了一个很好的思维方式，给大家换换筋骨，换一种思考的方式。
本文基于你对Java开发有一定基础，知道MVC，Struts等开发模式。
Velocity是一种Java模版引擎技术，该项目由Apache提出，由另外一种引擎技术Webmacro引深而来。那什么是官方的Velocity定义呢？Apache对它的定义是：一种基于Java的模板引擎，但允许任何人使用简单而强大的模板语言来引用定义在Java代码中的对象。目前最新的版本是1.4，可以在http://jakarta.apache.org/velocity/index.html查找更多信息。
其实说白了Velocity也就是MVC架构的一种实现，但它更多的是关注在Model和View之间，作为它们的桥梁。对于MVC的最流行架构Struts来说，相信大家都不陌生，很多开发人员已经大量在使用Struts架构，包括IBM的Websphere5以上的管理平台版本，Struts技术很好的实践了MVC，它有效的减少Java代码在View（Jsp）中的出现，但在Model和View之间还是依靠Struts的Taglib技术来实现，试想如果前台开发的网页设计师对Struts乃至Taglib不熟（相信也挺难熟的，包括后期的维护人员也一样），将会对网页设计师和前台开发工程师的相互协作开发带来很大的难度，现实开发中也还是存在这样事实，网页设计师和前台开发之间的工作或多或少还是存在一定的耦合，怎样最大限度的解决这个难题呢？还是让我们来看看Velocity或者说这个概念吧。
先做一个最简单的Velocity开发例子，让大家看看Velocity是怎样工作的：
1、创建1个文件，文件名为：hellovelocity.vm，即velocity模版（其实和html一样），内容：
Welcome$nametoJavayou.com!
todayis$date.
2、创建1个java文件，HelloVelocity.java，内容：
packagecom.javayou.velocity;
importjava.io.StringWriter;
importjava.util.*;
importorg.apache.velocity.app.VelocityEngine;
importorg.apache.velocity.Template;
importorg.apache.velocity.VelocityContext;
/**
*@authorLiang.xf2004-12-14
*/
publicclassHelloVelocity{
publicstaticvoidmain(String[]args)throwsException{
//初始化并取得Velocity引擎
VelocityEngineve=newVelocityEngine();
ve.init();
//取得velocity的模版
Templatet=ve.getTemplate("hellovelocity.vm");
//取得velocity的上下文context
VelocityContextcontext=newVelocityContext();
//把数据填入上下文
context.put("name","Liang");
context.put("date",(newDate()).toString());
//为后面的展示，提前输入List数值
Listtemp=newArrayList();
temp.add("1");
temp.add("2");
context.put("list",temp);
//输出流
StringWriterwriter=newStringWriter();
//转换输出
t.merge(context,writer);
System.out.println(writer.toString());
}
}
3、在http://jakarta.apache.org/site/binindex.cgi上下载Velocity1.4zip，解压后获取velocity-1.4.jar，用它来编译上面的类HelloVelocity.java。
4、把1上的hellovelocity.vmcopy到运行的当前目录下，运行HelloVelocity还需要其他类包，可以从下载后的velocity1.4.zip来，//velocity-1.4//build//lib，把commons-collections.jar、logkit-1.0.1.jar引入后运行java-cp.//bin;-Djava.ext.dirs=.//lib2com.javayou.velocity.HelloVelocity，假设class编译到.//bin目录，而我们所需的类包放到.//lib2目录内，运行结构如下：
WelcomeLiangtoJavayou.com!
todayisTueDec1419:26:37CST2004.
以上是最简单的运行结果，怎么样，知道个大概吧，模版hellovelocity.vm里的2个定义变量$name和$date分别被context.put("name","Liang")和context.put("date",(newDate()).toString())所设的值替代了。
由此看来业务流程处理包括业务结果基本在model这层全部解决，而view这一层基本只用使用简单的VTL（VelocityTemplateLanguage）来展示。这样，Jsp岂不是不用了么？是的，这样的使用模式有点象早前的CGI方式：）由Velocity自动输出代码，并且Velocity在这方面的能力也很强，Turbine里就采用了Velocity来产生很多代码。
在Velocity中，变量的定义都是使用“$”开头的，$作为Velocity的标识符。字母、数字、中划和下划线都可以作为Velocity的定义变量。
此外我们还需要注意的是Velocity特色的变量定义，如：$student.No、$student.Address，它有2层含义：第1种是如果student是hashtable，则将从hashtable中提取key为No和Address的值，另外第2种就是它有可能是调用方法，即上面2个变量将被转换为student.getNo()和student.getAddress()。Velocity对在servlet中的javacode返回的值有对象，还可以调用对象的方法，如$student.getAddress()等等，在此就不一一举例和深入了。
上面的例子只是简单的举例，现在当然不少人已经不满足这样的例子了，实际的应用中我们还常常需要作些选择性展示和列举一些迭代数据，如List列表，当然Velocity（具体来说应该是VTL模版语言）也支持这项功能，此外还支持其他一些常用的展示，如模版内部的变量（如Jsp内的变量），还有强大一些的如创建宏以实现自动化，让我们继续接着往下看吧。
我们还是使用上面的例子，把模版hellovelocity.vm中的内容改为：
#set($iAmVariable="good!")
Welcome$nametoJavayou.com!
todayis$date.
$iAmVariable
重新执行上面的运行命令，结果：
WelcomeLiangtoJavayou.com!
todayisTueDec1422:44:39CST2004.
good!
可以看得模版中的变量定义为#set开头的语句，不是很难理解，执行后模版中的变量$iAmVariable都转换成定义的值：
good!
再来看看简单的选择，把模版hellovelocity.vm中的内容改为：
#set($admin="admin")
#set($user="user")
#if($admin==$user)
Welcomeadmin!
#else
Welcomeuser!
#end
执行运行命令，结果：
Welcomeuser!
可以看到判断语句只是简单的#if()、#else、#end，不是很复杂。
接着继续来看看迭代数据吧，把模版hellovelocity.vm中的内容改为：
#foreach($productin$list)
$product
#end
执行运行命令，结果：
#1
#2
把在例子中预先保存在VelocityContext的List中的值列举了出来，是不是很方便啊？仅仅只是用了#foreach（$variableinxx）而已，如果上面的List换成Hashtable，则可以用下面的语法：
#foreach($keyin$hashVariable.keySet())
$key‘svalue:$hashVariable.get($key)
#end
一点不觉得这些脚本很复杂。
还有不少人还会问，如果是javabean怎么办？好的，我们增加一个bean：
packagecom.javayou.velocity;
/**
*@authorLiang.xf2004-12-14
*/
publicclassStudent{
//注意class的属性是public的
publicStringno="";
publicStringaddress="";
publicStudent(String_no,String_address){
no=_no;
address=_address;
}
publicStringgetAddress(){
returnaddress;
}
publicvoidsetAddress(Stringaddress){
this.address=address;
}
publicStringgetNo(){
returnno;
}
publicvoidsetNo(Stringno){
this.no=no;
}
}
这个Student是实足的javabean，或者说是databean，常见的用来装载数据的类，然后我们修改HelloVelocity.java，把：
temp.add("1");
temp.add("2");
替换成：
temp.add(newStudent("123","Guangzhou"));
temp.add(newStudent("456","Zhuhai"));
再把hellovelocity.vm的内容改为：
#foreach($sin$students)
<$velocityCount>Address:$s.address
#end
重新编译和执行运行命令，结果如下：
<1>Address:Guangzhou
<2>Address:Zhuhai
这样把list中Student的数据打印了出来，大功告成！这里用了Velocity的内建变量$velocityCount，指的是默认的列举序号，从1开始，也可以改成0开始，但需要在Velocity.properties中更改，Velocity.properties位于velocity-1.4.jar包内的目录org//apache//velocity//runtime//defaults下。
再复杂一些的迭代怎么处理呢？我们看看下面的模版例子就清楚了：
#foreach($elementin$list)
--innerforeach--
#foreach($elementin$list)
Thisis$element.
$velocityCount
#end
--innerforeach--
--outerforeach--
Thisis$element.
$velocityCount
--outerforeach--
#end
看出来了吧，Velocity是支持标签嵌套的，这个可是很强大的功能，这里就不深入演示了，如果有兴趣，自己试试吧。
其实，稍为深入思考刚刚我们举的例子，就已经可以看出来，Velocity的用处在哪里？即Servlet+Velocity的模式，另外，还记得我们早期Jsp开发的模式Jsp+JavaBean吗？在这里，我们更改为Servlet+JavaBean+Velocity，想想，是不是已经替代了Jsp+JavaBean，并更彻底的把Java代码去除在Jsp（vm）外，如果光使用Struts（Servlet+Jsp），那么带来的代价是Java代码总或多或少出现在Jsp上，即使可以做到不出现Java代码，但做过复杂架构系统的开发者都知道，代价也是很昂贵的，并且在可维护性、和网页设计师的集成开发上存在一定的困难，所以我们在这里能感觉到，Servlet+JavaBean+Velocity的模式较好的实现了OOD的概念。而在效率上，大家也不用担心，此种结合方式比Servlet+Jsp的方式要高效一些。
愿意了解Velocity的人应该不少，但真正实用到项目的，也许不多（还是有些项目在使用，如Jute），毕竟和Jsp比起来，Jsp更标准、更广泛使用和有不少开发工具已经支持Jsp开发。但Velocity的功能不会仅仅局限在和Jsp竞争的局面，由上可看出它在自动代码输出方面功能很强，前面提到Turbine就是采用Velocity来生成很多代码，你也可以稍加改动就可以做成代码生成器，或其他模版生成上，都是很不错的想法。
好了，我们再来看看要深入Velocity来做项目，还需要注意的一些常见问题吧，首先是国际化的问题，
Velocity本身支持模版的国际化编码转换，看看Velocity提供的方法：
PublicTemplategetTemplate(Stirngtemplate,Stringencoding)，
由此推测这样做其实不能彻底的做到国际化。
最简单的在Struts中国际化的概念，即在Jsp上使用国际化语言标签的方式来做到，而每种语言采用不同的语言标签库的方式，引申到这里，其实手工来做一样可以做到，只不过需要稍加手工处理而已。
好在已经有人处理了上面所说问题，做成了Velocity的tools:MessageTool，提供了变量text包含国际化标签，这样只需要简单的编写标签代码即可，如：$text.get(‘title’)，更多具体的内容还可在http://jakarta.apache.org/velocity/tools/struts/MessageTool.html中了解。
好了，基于Velocity的介绍我们就说这么多，再说说其他引伸方面的内容吧。有人评论Velocity不是标准的MVC结构，没错，刚开始我们就说过Velocity只是Model和View之间的良好结合，只是个好的模版引擎，毕竟还没有形成MVC三者良好的结合。好在Apache又基于Struts和Velocity的结合，推出了VelocityStruts，这部分的陈述我们可以在后面的专题里再推出，这里简单介绍它的概念，它是在Struts的结构上，在业务逻辑处理的Action后，把业务流程转向基于Velocity的显示层，从而代替Jsp作为View层。以上我们也看到了所举的例子基本上只是基于原理和演示，没有和Web开发紧密结合起来，这方面内容我们在讲述VelocityStruts的内容时再来结合吧。
Velocity使用介绍－在java中的代码
1．首先初始化对象
VelocityContextcontext=newVelocityContext();
StringWriterwriter=newStringWriter();
Stringencoding2="GBK";
2．PROPERTY_PATH＝系统properties文件中的TEMPLATE_INIT_PATH（指定velocity所需的property文件路径。）
3．Properties中的内容
file.resource.loader.path=D:/resin/webapps/mip/files/templateupload/（模板所在地方）
4．然后要初始化Velocity.init(PROPERTY_PATH);
5．将velocity中的标签跟java对应context.put(key,value);
6．然后加载文件Velocity.mergeTemplate(templateName,encoding2,context,writer);
7．最后调用Generator.writeToFile()生成文件。
8．writeToFile函数如下：
FileOutputStreamof=newFileOutputStream(theFile);
of.write(writer.toString().getBytes("GBK"));
//Stringtt=writer.toString();
of.flush();
of.close();
