不少人看过或了解过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的Websphere 5以上的管理平台版本,Struts技术很好的实践了MVC,它有效的减少Java代码在View(Jsp)中的出现,但在Model和View之间还是依靠Struts的Taglib技术来实现,试想如果前台开发的网页设计师对Struts乃至Taglib不熟(相信也挺难熟的,包括后期的维护人员也一样),将会对网页设计师和前台开发工程师的相互协作开发带来很大的难度,现实开发中也还是存在这样事实,网页设计师和前台开发之间的工作或多或少还是存在一定的耦合,怎样最大限度的解决这个难题呢?还是让我们来看看Velocity或者说这个概念吧。
先做一个最简单的Velocity开发例子,让大家看看Velocity是怎样工作的:
1、 创建1个文件,文件名为:hellovelocity.vm,即velocity模版(其实和html一样),内容:
Welcome $name to Javayou.com!
today is $date.
2、 创建1个java文件,HelloVelocity.java,内容:
package com.javayou.velocity;
import java.io.StringWriter;
import java.util.*;
import org.apache.velocity.app.VelocityEngine;
import org.apache.velocity.Template;
import org.apache.velocity.VelocityContext;
/**
* @author Liang.xf 2004-12-14
*/
public class HelloVelocity {
public static void main(String[] args) throws Exception {
//初始化并取得Velocity引擎
VelocityEngine ve = new VelocityEngine();
ve.init();
//取得velocity的模版
Template t = ve.getTemplate("hellovelocity.vm");
//取得velocity的上下文context
VelocityContext context = new VelocityContext();
//把数据填入上下文
context.put("name", "Liang");
context.put("date", (new Date()).toString());
//为后面的展示,提前输入List数值
List temp = new ArrayList();
temp.add("1");
temp.add("2");
context.put("list", temp);
//输出流
StringWriter writer = new StringWriter();
//转换输出
t.merge(context, writer);
System.out.println(writer.toString());
}
}
3、 在http://jakarta.apache.org/site/binindex.cgi上下载Velocity 1.4 zip,解压后获取velocity-1.4.jar,用它来编译上面的类HelloVelocity.java。
4、 把1上的hellovelocity.vm copy到运行的当前目录下,运行HelloVelocity还需要其他类包,可以从下载后的velocity1.4.zip来,\velocity-1.4\build\lib,把commons-collections.jar、logkit-1.0.1.jar引入后运行java -cp .\bin; -Djava.ext.dirs=.\lib2 com.javayou.velocity.HelloVelocity,假设class编译到.\bin目录,而我们所需的类包放到.\lib2目录内,运行结构如下:
Welcome Liang to Javayou.com!
today is Tue Dec 14 19:26:37 CST 2004.
以上是最简单的运行结果,怎么样,知道个大概吧,模版hellovelocity.vm里的2个定义变量$name和$date分别被context.put("name", "Liang")和context.put("date", (new Date()).toString())所设的值替代了。
由此看来业务流程处理包括业务结果基本在model这层全部解决,而view这一层基本只用使用简单的VTL(Velocity Template Language)来展示。这样,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中的java code返回的值有对象,还可以调用对象的方法,如$ student.getAddress()等等,在此就不一一举例和深入了。
上面的例子只是简单的举例,现在当然不少人已经不满足这样的例子了,实际的应用中我们还常常需要作些选择性展示和列举一些迭代数据,如List列表,当然Velocity(具体来说应该是VTL模版语言)也支持这项功能,此外还支持其他一些常用的展示,如模版内部的变量(如Jsp内的变量),还有强大一些的如创建宏以实现自动化,让我们继续接着往下看吧。
我们还是使用上面的例子,把模版hellovelocity.vm中的内容改为:
#set( $iAmVariable = "good!" )
Welcome $name to Javayou.com!
today is $date.
$iAmVariable
重新执行上面的运行命令,结果:
Welcome Liang to Javayou.com!
today is Tue Dec 14 22:44:39 CST 2004.
good!
可以看得模版中的变量定义为# set开头的语句,不是很难理解,执行后模版中的变量$iAmVariable都转换成定义的值:good!
再来看看简单的选择,把模版hellovelocity.vm中的内容改为:
#set ($admin = "admin")
#set ($user = "user")
#if ($admin = = $user)
Welcome admin!
#else
Welcome user!
#end
执行运行命令,结果:
Welcome user!
可以看到判断语句只是简单的#if ()、#else、#end,不是很复杂。
接着继续来看看迭代数据吧,把模版hellovelocity.vm中的内容改为:
#foreach( $product in $list )
$product
#end
执行运行命令,结果:
1
2
把在例子中预先保存在VelocityContext的List中的值列举了出来,是不是很方便啊?仅仅只是用了#foreach($variable in xx) 而已,如果上面的List换成Hashtable,则可以用下面的语法:
#foreach($key in $hashVariable.keySet() )
$key ‘s value: $ hashVariable.get($key)
#end
一点不觉得这些脚本很复杂。
还有不少人还会问,如果是javabean怎么办?好的,我们增加一个bean:
package com.javayou.velocity;
/**
* @author Liang.xf 2004-12-14
*/
public class Student {
//注意class的属性是public的
public String no = "";
public String address = "";
public Student(String _no, String _address) {
no = _no;
address = _address;
}
public String getAddress() {
return address;
}
public void setAddress(String address) {
this.address = address;
}
public String getNo() {
return no;
}
public void setNo(String no) {
this.no = no;
}
}
这个Student是实足的javabean,或者说是data bean,常见的用来装载数据的类,然后我们修改HelloVelocity.java,把:
temp.add("1");
temp.add("2");
替换成:
temp.add(new Student("123", "Guangzhou"));
temp.add(new Student("456", "Zhuhai"));
再把hellovelocity.vm的内容改为:
#foreach ($s in $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 ($element in $list)
-- inner foreach --
#foreach ($element in $list)
This is $element.
$velocityCount
#end
-- inner foreach --
-- outer foreach --
This is $element.
$velocityCount
-- outer foreach --
#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提供的方法:
Public Template getTemplate (Stirng template, String encoding),
由此推测这样做其实不能彻底的做到国际化。
//------------------------------------------(2)--------------------------------------------
/*
* Copyright 2000-2001,2006 The Apache Software Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
Servlet直接继承VelocityServlet。需要引入velocity-dep-1.4.jar,velocity-1.4.jar两个包。
package com.javayou;
import java.io.IOException;
import java.io.FileNotFoundException;
import java.util.ArrayList;
import java.util.List;
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;
/**
* Sample of how to use the VelocityServlet.
* This example shows how to add objects to the context and
* pass them to the template.
*
* @author willians He
* @author <a href="mailto:hzxmsn@163.com">willians He.</a>
* @version $Id: SampleServlet.java,v 1.5.8.1 2006/07/15 10:01:29 geirm Exp $
*/
public class SampleServlet extends VelocityServlet
{
/**
* Called by the VelocityServlet
* init(). We want to set a set of properties
* so that templates will be found in the webapp
* root. This makes this easier to work with as
* an example, so a new user doesn't have to worry
* about config issues when first figuring things
* out
*/
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 );
/**
* and the same for the log file
*/
p.setProperty( "runtime.log", path + "velocity.log" );
return p;
}
/**
* <p>
* main routine to handle a request. Called by
* VelocityServlet, your responsibility as programmer
* is to simply return a valid Template
* </p>
*
* @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 )
{
/*
* set up some data to put into the context
*/
String p1 = "Bob-->congratulation to Bob";
String p2 = "Harold-->congratulation to Harold";
String p3 = "Bob--->this is Wrong enter Bob";
String p4 = "Harold-->this is Wrong enter Harold";
String jpgurl2="/test/picture/lxy01.jpg";
String jpgurl1="/test/picture/ch020.jpg";
// 为后面的展示,提前输入List数值
List temp = new ArrayList();
temp.add(new Students("123", "Guangzhou"));
temp.add(new Students("321", "Guangzhou"));
temp.add(new Students("456", "Shanghai"));
temp.add(new Students("654", "Shanghai"));
ctx.put("list", temp);
Vector personList = new Vector();
Vector personList2 = new Vector();
String name=null;
String pass=null;
if(!request.getParameterMap().isEmpty())
{
name = request.getParameter("Account");
pass = request.getParameter("Password");
}else {
name="myname";
pass="123456";
}
if(name.equals("myname")&&pass.equals("123456")) {
personList.addElement( p1 );
personList.addElement( p2 );
personList2.addElement( jpgurl1 );
}
else{
personList.addElement( p3 );
personList.addElement( p4 );
personList2.addElement( jpgurl2 );
}
/*
* Add the list to the context.
* This is how it's passed to the template.
*/
ctx.put("theList", personList );
ctx.put("theImageList", personList2 );
/*
* get the template. There are three possible
* exceptions. Good to know what happened.
*/
Template outty = null;
try
{
//outty = getTemplate("sample.html");
outty=getTemplate("templat/picMoudle/pic1.html");
}
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;
}
}
Students.java
/*
* 创建日期 2006-7-18
*
* TODO 要更改此生成的文件的模板,请转至
* 窗口 - 首选项 - Java - 代码样式 - 代码模板
*/
package com.javayou;
/**
* @author Willian He
*
*/
public class Students {
public String no = "";
public String address = "";
public Students(String _no, String _address) {
no = _no;
address = _address;
}
public String getAddress() {
return address;
}
public void setAddress(String address) {
this.address = address;
}
public String getNo() {
return no;
}
public void setNo(String no) {
this.no = no;
}
}
模板
pic1.html
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Sample Picture page</title></head>
<body bgcolor="#ffffff">
<center>
<h2>Hello ,How are you!</h2>
<i>Here's the list of picture</i>
#set ($foo="The Velocity")
<table width="750" height="200" border="1" cellpadding="1" cellspacing="1">
<tr>
<td bgcolor="#eeeeee" align="center">
Show the picture <br>
##foreach ($s1 in $list)
#foreach ($s in $list)
#if($s.address=="Shanghai")
this is<$velocityCount> Address: $s.address $s.no<br>
#else
that is<$velocityCount> Address: $s.no,$s.address <br>
#end
#end
##end
</td>
</tr>
#foreach ($name in $theList)
<tr align="center">
<td bgcolor="#eeeeee">$name</td>
</tr>
#end
#foreach ($name in $theImageList)
<tr>
<td align="center"><img src="$name" title="give me" /></td>
</tr>
<tr>
<td align="center"><font color="#ff0255">$name</font></td>
</tr>
#end
<tr>
<td bgcolor="#green" align="center">$foo</td>
</tr>
</table>
#macro(tablerows $color $somelist)
#foreach($something in $somelist)
<tr>
<td bgcolor=$color>$something</td>
</tr>
#end
#end
#set($greatlakes=["Superior","Michigan","Huron","Erie","Ontario"])
#set($color=("bllack"))
<table>
#tablerows($color $greatlakes)
</table>
<a href="http://localhost:8080/test/MyJsp.jsp">回上一页</a>
</center>
</html>