心情: 挺好
之前的文章《Velocity初体验》，介绍了Velocity的工作原理和一些演示样例，但有朋友觉得不和Web结合起来针对性不够突出，所以下面结合Web开发来进一步说明，Velocity+Servlet（+JavaBean）是怎样工作的。
通过下面的说明，仅提出Velocity在Web方面的简单示例，为大家献上一个原始但清晰的认识，来了解Velocity在Web方面的工作原理，未来还有深入的主题贡献给大家。
Web环境要求Tomcat，我是用5.5版本。
首先我们还是使用VTL（Velocity Template Language）编一个.vm模版，考察在网页设计师的角度是不是很容易理解和编辑，首先创建sample.vm内容如下：
<html>
<head><title>Velocity</title></head>
<body bgcolor="#ffffff">
<center>
<h2>Welcom to Velocity!</h2>
<i>Here's the list of people</i>
<table cellspacing="0" cellpadding="5" width="20%" >
<tr>
<td bgcolor="#eeeeee" align="center">
Names：
</td>
</tr>
#foreach ($name in $theList)
<tr>
<td bgcolor="#eeeeee" align="center">$name</td>
</tr>
#end
</table>
</center>
</body>
</html>
然后打开FrontPage（或其他类似工具）网页编辑器，点击"工具－选项－配置编辑器"，上面列出了FrontPage能打开的文件，点击添加，填入文件类型：vm，编辑器名称：FrontPage，命令：C:\Program Files\Microsoft Office\Office\frontpg.exe（FrontPage运行的完整路径，可从已有的文件类型中Copy出完整路径），点击打开界面的确定后，我们从FrontPage的文件菜单中选择打开文件，选择上面新建的sample.vm，怎么样，编辑、预览和修改都一目了然吧（如下图），即使不清楚VTL的，也可以通过简单的手册查询知道（一般都不会用到吧），这样对于网页设计师、开发人员和维护人员来说，都是很容易的事。而如果你使用了一些开发工具，如Jbuilder则在tools－proference的编辑类型里，在Html档增加.vm的支持，则就可以进行编辑和用html预览器预览了，其他的开发工具自己摸索吧。
接下来看看最简单的Servlet是怎么和Velocity结合工作的，创建SampleServlet.java，由于VelocityServlet提供了统一的Servlet入口和封装了大部分工作，以及把展示数据合并到模版中，所以SampleServlet通过继承VelocityServlet，工作将简便很多，代码如下：
package com.javayou.velocity.servlet;
/*
* @author Liang.xf 2004-12-15
* Velocity + Servlet 演示
* www.javayou.com
*/
import java.io.IOException;
import java.io.FileNotFoundException;
import java.util.Properties;
import java.util.Vector;
import javax.servlet.ServletConfig;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.apache.velocity.Template;
import org.apache.velocity.context.Context;
import org.apache.velocity.servlet.VelocityServlet;
import org.apache.velocity.app.Velocity;
import org.apache.velocity.exception.ResourceNotFoundException;
import org.apache.velocity.exception.ParseErrorException;
public class SampleServlet extends VelocityServlet {
/**
* 由VelocityServlet.init()调用， We want to set a set of properties
* 在此找出模版的路径
*/
protected Properties loadConfiguration(ServletConfig config )
throws IOException, FileNotFoundException {
Properties p = new Properties();
/*
* first, we set the template path for the
* FileResourceLoader to the root of the
* webapp. This probably won't work under
* in a WAR under WebLogic, but should
* under tomcat :)
*/
String path = config.getServletContext().getRealPath("/");
if (path == null) {
System.out.println(" SampleServlet.loadConfiguration() : unable to "
+ "get the current webapp root. Using '/'. Please fix.");
path = "/";
}
p.setProperty( Velocity.FILE_RESOURCE_LOADER_PATH, path );
//同样设置log
p.setProperty( "runtime.log", path + "velocity.log" );
return p;
}
/**
* Velocity主要的商业逻辑处理方法，由VelocityServlet自动调用
* @param ctx a Velocity Context object to be filled with
* data. Will be used for rendering this
* template
* @return Template to be used for request
*/
public Template handleRequest( HttpServletRequest request,
HttpServletResponse response, Context ctx ) {
//主要在此设置演示用的数据，开发中在此调用相应的业务处理流程，
// 并设置返回到页面的数据
System.out.println("------SampleVelocity.handleRequest-------");
//待展示的列表数据
String p1 = "第一位：LiuDong";
String p2 = "第二位：Liang.xf";
Vector personList = new Vector();
//中文需要转换
try {
personList.addElement(new String(p1.getBytes(), "ISO-8859-1") );
personList.addElement(new String(p2.getBytes(), "ISO-8859-1") );
} catch (Exception e) {
System.out.println("数据转换异常："+e);
}
//设置数据，供页面模版替换成显示的数据
ctx.put("theList", personList );
/*
* get the template. There are three possible
* exceptions. Good to know what happened.
*/
Template outty = null;
try {
outty = getTemplate("sample.vm");
} catch( ParseErrorException pee ) {
System.out.println("SampleServlet: parse error for template " + pee);
} catch( ResourceNotFoundException rnfe ) {
System.out.println("SampleServlet: template not found " + rnfe);
} catch( Exception e ){
System.out.println("Error " + e);
}
return outty;
}
}
编译需要velocity-1.4.jar和j2ee.jar，这里演示手工编译命令（所有资源放在同一目录）：
javac -classpath .\velocity-1.4.jar;.\j2ee.jar SampleServlet.java
编译通过后，我们接着需要发布了，以Tomcat5.5为例，新建Web应用简易说明如下：
1、\tomcat55\webapps目录下新建目录test，把上述sample.vm Copy进test目录，在test内新建目录WEB-INF，在WEB-INF内分别新建目录：classes和lib，在WEB-INF目录下新建文件web.xml，内容：
<?xml version="1.0" encoding="ISO-8859-1"?>
<web-app>
<display-name>Welcome to Javayou.com</display-name>
<servlet>
<servlet-name>SampleServlet</servlet-name>
<servlet-class>com.javayou.velocity.servlet.SampleServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>SampleServlet</servlet-name>
<url-pattern>/SampleServlet</url-pattern>
</servlet-mapping>
</web-app>
2、在classes内建立类包目录：com\javayou\velocity\servlet\，copy上面编译后的SampleServlet.class；
3、在lib目录内分别copy进：commons-collections.jar、logkit-1.0.1.jar、velocity-1.4.jar；
OK，Tomcat运行环境搭建完毕。
启动Tomcat，在IE上输入：http://localhost:8080/test/SampleServlet，页面显示和数据列表：第一位：LiuDong、第二位：Liang.xf 2正确，大功告成！
注意上面的显示数据含中文，所以在设置进装载容器时注意进行编码，稍显麻烦，这可以用更自动化的办法，如使用Util工具类等。
以上看来Servlet+Velocity的结合还是挺容易和简单的，而至于引伸到Servlet+Velocity+JavaBean 也不是很困难的事，稍为扩展即可达到，在这里就不再多述。
---www.javayou.com
