摘要
WebWork是一个源代码开放的Web应用框架,用于简化基于Web的应用开发。本专栏介绍了WebWork并且描述了如何使用WebWork和JavaServer Pages(jsp)、Velocity两种技术来建立注册界面的过程。(1000字;2003年3月7日)
---------
Web 应用程序的设计开发是复杂并且费时的。然而,你能够通过运用一种框架处理常见的Web应用程序来简化开发流程。许多开源Web应用框架能够做到这一点甚至更好一些。这些开发框架中最好的一个就是WebWork,是开源项目中OpenSymphony组的一个Web应用开发框架。
WebWork的最大优点是它的简单性和灵活性。WebWork有一个很小的API,它使开发者可以迅速进行开发工作。WebWork是许多特性和适用性的组合,包括使用variour view技术,例如JavaServer Pages(JSP),Velocity,Extensible Stylesheet Language Transformations
Specification(XSLT)和JASPerReporters。WebWork拥有一个活跃的社区,有许多文章、开发者和用户。
注意:本文基于WebWork1.3.0 release candidate 2(RC2)。为了使用本文提供的例子,你需要在你的应用服务器的webapps目录下建立文件夹,将例子拷贝至新的文件夹下,同时将所需的jar文件从WebWork distribution拷贝至WEB-INF/lib目录。在此处下载WebWork和本文相关的源代码。
------
actions
WebWork的一个最重要的特色就是Action接口。WebWork actions通过在页面(视图)和商业逻辑间提供mapping来控制Web应用程序流程。在WebWork中,提交窗体到一个action URI(Uniform Resource Identifier);这个URI指向一个相应的action;action执行;用户可以前进到相应的视图。
下述class,LoginAction,是WebWork处理基于Web应用的注册窗体的例子。LoginAction扩展了ActionSupport。它是一个基类,提供了处理错误、视图映射、和许多有用的功能。
import webwork.action.*;
public class LoginAction extends ActionSupport
{
private String userName;
private String passWord;
public String getPassword()
{
return password;
}
public String getUserName()
{
return userName;
}
public void setPassword(String password)
{
this.password = password;
}
public void setUserName(String userName)
{
this.userName = userName;
}
public String doExecute()
{
return SUCCESS;
}
public void doValidation()
{
if (userName == null userName.length() < 1) addError("UserName", "Please enter username.");
if (password == null password.length() < 1) addError("Password", "Please enter password.");
}
}
LoginAction包括了两个JavaBean属性,password和username。
WebWork把数据从属性中放置到你的视图中并且自动解析送到action的参数来设置属性值。
LoginAction重载了ActionSupport的两个方法:doValidation()和doExecute()。doValidation()方法验证参数,doExecute()方法让用户前进到相应的视图。doExecute()方法返回一个字符串,如果所有的处理是成功的,返回常量success。如果有任何问题发生,在用户输入视图上返回常量input。在LoginAction的doValidation()方法中调用addError指出了一个认证问题并且让用户返回INPUT视图。
---------
view mapping
WebWork有两种方法从map到视图:通过一个Action.XML文件或者一个views.properties文件。每一种动作应该具有一个INPUT视图和一个SUCCESS视图。下述Action.xml文件定义了两个actions,loginJSP和loginVelocity。这两个action都使用了LoginAction类。如果LoginAction返回SUCCESS,这两个action使用LoginAction类并且使用户转向success.Html。如果LoginAction返回INPUT,action转向相应的INPUT视图,或者login.jsp、或者login.vm;
<actions>
<action name="LoginAction" alias="loginJSP">
<view name="input">login.jsp</view>
<view name="success">success.html</view>
</action>
<action name="LoginAction" alias="loginVelocity">
<view name="input">login.vm</view>
<view name="success">success.html</view>
</action>
</actions>
--------
视图
尽管WebWork对于许多不同的视图技术提供了支持,但是最为常见的是JSP和Velociy。以下页面是两个注册页面的例子--一个使用了JSP另一个使用了Velocity。每个页面都包括了一个用户部分和一个密码部分,这两部分提交给WebWork action。
Login.jsp页面通过使用WebWork标记库来建立和处理以上两个部分,并且通过错误收集器来处理错误。webwork:textfield 和 webwork:password标记建立了text和password部分,webwork:iterator标记处理从LoginAction返回的错误。 webwork:property标记设置username,password和errors属性。
<%@ taglib uri="webwork" prefix="webwork" %>
<html>
<head>
<title>WebWork JSP Example</title>
</head>
<body>
<form action="loginJSP.action" method="post">
<webwork:property>
<webwork:textfield label="'Name'" name="'userName'"/>
<webwork:password label="'Password'" name="'password'"/>
</webwork:property>
<input type="submit" value="Submit"/>
</form>
<webwork:iterator value="errors">
<br><webwork:property/>
</webwork:iterator>
</body>
</html>
login.vm页面使用了Velocity模板语言来建立域并且处理错误。
在Velocity中,$符号表明了一个参考。!符号告诉Velocity如果参考为空,那么什么都不显示。#符号表示了一个指令。在下述例子中,$!userName和$!password表明参考引用了LoginAction中的username和password;#foreach在错误处理属性中指示了循环。
<html>
<head>
<title>WebWork Velocity Example</title>
</head>
<body>
<form action="loginVelocity.action" method="post">
<input type="text" name="userName" value="$!userName"/>
<input type="text" name="password" value="$!password"/>
<input type="submit" value="Submit"/>
</form>
#foreach ($error in $errors)
<br>$error
#end
</body>
</html>
---------------
开始工作!
WebWork是一个易用的、灵活的、功能强大的开源Web应用框架,本文介绍了它的基本功能。访问OpenSympony的网站去学习并且下载最新版本的WebWork。你下载完WebWork后,到Jakarta的网站的上部去寻找Velocity,一种简单、快速的开源引擎,它是你在网页中使用JSP的另一个选择。
-----------------
作者介绍
Erik Swenson 是Open Source Software Solutions的顾问和建立者。他主要研究使用开源软件和组件来进行java开发。此外,他参与开发了开源项目JasperEdit和OpenReports。
------------------
资源
下载本文相关的源代码
http://www.javaworld.com/javaworld/jw-03-2003/opensource/jw-0307-opensourceprofile.zip
从OpenSymphony网站下载WebWork:
http://www.opensymphony.com/webwork/
Velocity 是Apache Jakarta项目的一部分,从以下地址下载:
http://jakarta.apache.org/velocity/index.html
“使用Velocity模板引擎” Geir Magnusson Jr. (JavaWorld, 2001年12月):
http://www.javaworld.com/javaworld/jw-12-2001/jw-1228-velocity.html
其他开源Web应用框架包括:
Maverick:
http://mav.sourceforge.net/
Struts:
http://jakarta.apache.org/struts/index.html
JasperReports homepage:
http://jasperreports.sourceforge.net/ (出处:http://www.knowsky.com)