WebWork教程

WebWork教程－0.90版
作者：moxie(安子)
发布记录：
2004-6-29：WebWork教程0.90 版
说明：本次发布的是初稿部分，除了章节：“实战G-Roller-WW”、“WebWork与其它开源项
目的集成”，其余章节全部完成。
WebWork教程
有任何意见和建议，请email to:achqian@hotmail.com（MSN）
版权所有，请勿转载和篡改
目 录
WebWork教程－0.90 版.................................................................................................................1
WebWork介绍.........................................................................................................................3
WebWork安装－HelloWorld...................................................................................................3
WebWork安装.................................................................................................................3
HelloWorld.......................................................................................................................4
Action(动作).............................................................................................................................6
Action介绍.......................................................................................................................6
用户注册例子...................................................................................................................6
Field-Driven Action vs. Model-Driven Action ...............................................................10
ActionContext(Action上下文) ..............................................................................................12
ActionContext介绍........................................................................................................12
ServletActionContext......................................................................................................13
ServletDispatcher 原理...........................................................................................................14
Action的单元测试.........................................................................................................17
Result Type .............................................................................................................................18
表达式与言EL和OGNL......................................................................................................22
OGNL介绍....................................................................................................................22
值堆栈－OgnlValueStack...............................................................................................22
Interceptor(拦截器)框架........................................................................................................28
Interceptor 的原理..........................................................................................................31
验证框架...............................................................................................................................32
为用户注册添加验证功能.............................................................................................32
XWork配置详述....................................................................................................................37
xwork.xml 文件的标签元素..........................................................................................37
实战G-Roller-WW................................................................................................................41
G-Roller-WW介绍.........................................................................................................41
JSTL与WebWork的整合.............................................................................................41
中文解决方案.................................................................................................................41
WebWork与其它开源项目的集成........................................................................................41
Spring.............................................................................................................................41
Hibernate........................................................................................................................41
Xml-RPC ........................................................................................................................41
总结.......................................................................................................................................42
附录.......................................................................................................................................42
我钟爱的Opensympnony ..............................................................................................42
从技术的角度Struts1.1 与WebWork2 的比较.............................................................44
WebWork的项目资源....................................................................................................46
参考资料........................................................................................................................46
WebWork教程
有任何意见和建议，请email to:achqian@hotmail.com（MSN）
版权所有，请勿转载和篡改
WebWork介绍
WebWork是由OpenSymphony 组织开发的，致力于组件化和代码重用的拉出式MVC模式
J2EE Web 框架。WebWork目前最新版本是2.1，现在的WebWork2.x 前身是Rickard Oberg
开发的WebWork，但现在WebWork已经被拆分成了Xwork1 和WebWork2 两个项目，如下
示意图所示：
Xwork简洁、灵活功能强大，它是一个标准的Command模式实现，并且完全从web 层
脱离出来。Xwork提供了很多核心功能：前端拦截机（interceptor），运行时表单属性验证，
类型转换，强大的表达式语言（OGNL – the Object Graph Notation Language），IoC（Inversion
of Control 倒置控制）容器等。
WebWork2 建立在Xwork 之上，处理HTTP 的响应和请求。WebWork2 使用
ServletDispatcher 将HTTP 请求的变成Action(业务层Action 类), session（会话）application
（应用程序）范围的映射，request请求参数映射。WebWork2 支持多视图表示，视图部分可
以使用JSP, Velocity, FreeMarker, JasperReports，XML 等。
下面我们提到的WebWork将为WebWork2,使用的版本是2.1。
HelloWorld实例
首先看下面这个程序HelloWorldAction.java：
package helloWorld
import com.opensymphony.xwork.Action;
public class HelloWorldAction implements Action{
String greeting;
public String getGreeting() {
return greeting;
}
public String execute() throws Exception {
greeting = "Hello World!";
return SUCCESS;
}
}
HelloWorldAction 是一个普通的Java 类，它实现了Action 这个接口。Action 是一个非
常简单的接口，只有一个方法：public String execute() throws Exception; ，Action类介绍见
下一节。HelloWorldAction有一个String类型字段greeting，在execute()方法中，greeting被
赋值“Hello World!”，并返回String型常量SUCCESS，SUCCESS的定义详见Action接口，
这个常量代表了execute()方法执行成功，将返回成功页面。
返回的页面greetings.jsp代码如下：
<%@ taglib prefix="ww" uri="webwork" %>
<html>
<head>
<title>First WebWork Example</title>
</head>
<body>
<p><ww:property value="greeting"/></p>
</body>
</html>
greetings.jsp很简单的jsp页面，它使用了WebWork自带的标签库。它的作用是输出变
量“greeting”的值。这个<ww:property value="greeting"/>语句，相当于调用相应Action
（HelloWorldAction）的getGreeting（）方法，取得变量“greeting”的值。
我们的HelloWorld代码就这么多，完了。可是，HelloWorldAction怎么去调用、执行？
执行成功它又怎么知道返回到greetings.jsp？XWork 的配置文件xwork.xml 会负责将要执行
的Action和展现的视图连接起来，见xwork.xml 的如下片断：
<action name="hello" class=" helloWorld .HelloWorldAction">
<result name="success" type="dispatcher">
<param name="location">/greetings.jsp</param>
</result>
</action>
我们先看action标签：name=”hello”，表示我们调用这个Action的标识是hello，这样我
们可以通过下面的url访问这个Action：…/hello.action,
例如：http://localhost:8080/webwork/hello.action；class=" helloWorld .HelloWorldAction"很好
理解，这是真正调用执行的类。我们在看看result 标签：name="success"，记得前面
HelloWorldAction返回的字符常量SUCCESS吗？它的值其实就是“success”，它表示Action
执行成功返回success就转向这个结果；type="dispatcher"表示执行完Action，转向结果页面
的方式；param参数指定了结果页面的位置：/greetings.jsp。
代码写完，剩下的当然是编译、部署。启动tomcat服务器之后我们就可以执行了：
在浏览器里输入你的地址：http://localhost:8080/webwork/hello.action
你将会看到结果。
Action(动作)
Action介绍
Action 在MVC 模式中担任控制部分的角色，在WebWork 中使用的最多。每个请求的
动作都对应于一个相应的Action，一个Action 是一个独立的工作单元和控制命令，它必需
要实现XWork里的Action接口，实现Action接口的execute()方法。Action接口的代码如下：
package com.opensymphony.xwork;
import java.io.Serializable;
public interface Action extends Serializable {
public static final String SUCCESS = "success";
public static final String NONE = "none";
public static final String ERROR = "error";
public static final String INPUT = "input";
public static final String LOGIN = "login";
public String execute() throws Exception;
}
excute()方法是Action类里最重要的部分，它执行返回String类型的值，在Action中返
回的值一般使用它上面定义的标准静态字符常量。例如：前面的HelloWorldAction返回的就
是SUCCESS 字符常量，真正的值当然就是“success”，它与xwork 配置文件里result 标签
name的值是相对应的。它用来决定execute（）方法执行完成之后，调用哪一种返回结果。
字符常量的含义如下：
SUCCESS：Action正确的执行完成，返回相应的视图；
NONE：表示Action正确的执行完成，但并不返回任何视图；
ERROR：表示Action执行失败，返回到错误处理视图；
INPUT：Action 的执行，需要从前端界面获取参数，INPUT 就是代表这个参数输入的
界面，一般在应用中，会对这些参数进行验证，如果验证没有通过，将自动返回到该视图；
LOGIN：Action 因为用户没有登陆的原因没有正确执行，将返回该登陆视图，要求用
户进行登陆验证。
用户注册例子
下面我们将以一个用户注册的例子详细介绍Action的原理：
功能描述：一个用户注册页面register.jsp，用户可以在这个页面里输入用户注册的基本
信息（例如：姓名、密码、Email 等），输入完成提交表单，执行用户注册的Action，执行
成功返回成功提示的页面（register-result.jsp）并将注册的信息输出。
模型：User.java
控制：RegisterAction.java
视图：register.jsp、register-result.jsp
配置：xwork.xml
User.java：
package example.register;

public class User {
private String username;
private String password;
private String email;
private int age;

public void setUsername(String username) {
this.username = username;
}

public String getUsername() {
return username;
}

public void setPassword(String password) {
this.password = password;
}

public String getPassword() {
return password;
}

public void setEmail(String email) {
this.email = email;
}

public String getEmail() {
return email;
}

public void setAge(int age) {
this.age = age;
}

public int getAge() {
return age;
}

public String toString() {
return "username=" + username + ",password=" + password + ",email="
+ email + ",age=" + age;
}
}
模型User 是一个普通的JavaBean，它包含了用户注册的字段信息，并对每个字段提供
相应的set和get方法。下面我们来看看进行用户注册动作的RegisterAction.java：
package example.register;
import com.opensymphony.xwork.Action;
public class RegisterAction implements Action{
private User user=new User();
public User getUser()
{
return user;
}
public String execute()
{
System.out.println("开始注册");
System.out.println("User="+user);
return SUCCESS;
}

}这个Action 是不是特清爽？用户注册就这么几行代码搞定，当然，我们提倡在Action
里最好不要实现业务代码，Action的主要功能是提供从请求中取得参数的值，转化成相应的
模型，再将模型传递给执行业务操作的对象，比如：将注册的用户信息存储到数据库中，由
业务对象执行业务操作，再返回执行的结果。为了简化我们省去了注册的业务逻辑执行步骤。
再看看我们注册信息输入的页面：register.jsp
<html>
<head><title>Register Example</title></head>
<body>
<table border=0 width=97%>
<tr><td align="left">
<form name="register" action="register.action" method="post">
Username:<input type="text" name="user.username"><br>
Password:<input type="text" name="user.password"><br>
Email:<input type="text" name="user.email"><br>
Age:<input type="text" name="user.age"><br>
<input type="submit" name="Submit"><br>
</form>
</td></tr>
</table>
</body>
</html>
register.jsp页面其实只是一个普通的HTML页面，它提供了一个表单，用来接受用户输
入的注册信息，它唯一特殊的部分就是input 输入框定义的name 部分，例如：用户姓名用
的是“user. username”。这种命名方式代表什么含义？它是必需的吗？后面我们将会给出答
案。
RegisterAction正确执行完成之后，会将执行的结果返回到register-result.jsp页面，由它
来显示用户在前面页面输入的注册信息。register-result.jsp代码如下：
<%@ taglib prefix="ww" uri="webwork" %>
<html>
<head><title>Register result</title></head>
<body>
<table border=0 width=97%>
<tr>
<td align="left">
Congratulation,your register success!<p>
Username:<ww:property value="user.username"/><br>
Password:<ww:property value="user.password"/><br>
Email:<ww:property value="user.email"/><br>
Age:<ww:property value="user.age"/><br>
</td>
</tr>
</table>
</body>
</html>
这个Jsp 页面使用了WebWork 的标签库<ww:property />，记得HelloWorld 里的
greetings.jsp吗？它也使用了这个标签库。我们看这个：<ww:property value="user.username"/>
它是一个普通的使用标签库语句，查看这个标签库的源程序，见包
com.opensymphony.webwork.views.jsp 里的PropertyTag.java 文件，你会发现这个类会根据
value 后面赋予的表达式值，去OgnlValueStack 里查找这个表达式值所对应的操作。执行这
个语句OgnlValueStack 会根据value 的值（一个表达式）“user.username”去分别调用
RegisterAction类的getUser()和User 类的getUsername()方法，即：getUser().getUsername()，
取得的数据就是前面注册页面输入的用户名。
我们把“user.username”这样的语句叫做表达式语言（Expression Language，简称为EL）。
它由XWork框架提供，XWork表达式语言的核心是OGNL（Object Graph Notation Language），
OGNL是一种功能强大，技术成熟，应用广泛的表达式语言，将在下面的章节有详细介绍。
我们在回到前面介绍的register.jsp，Input输入框<input type="text" name="user.username">里用的“user.username”，现在我们可以明白，它不是随意设置的，它是一个表达式语言，有着特殊的功能。看到这里，不知道你心中是否有一个疑问：我们的RegisterAction是如何取得用户注册页面输入的数据呢？如果你做过Web 开发，你一定会想到RegisterAction里必需有一些从客户端请求中获取参数的语句，例如： 类似： String username = request.getParameter(“user. username”) 的语句（ request 是
HttpServletRequest 的对象），去从request 请求里面获取用户输入的参数值。可是我们这个
Action 里面只有User 对象简单的get 方法，并没有其它的代码。Xwork 框架的Action 是如
何去实现了与Web 无关？request请求的参数是怎么传递到我们Action的模型User 中呢？
在回答答案之前，我们先看一看Xwork的配置文件xwork.xml：
<action name="register" class="example.register.RegisterAction" >
<result name="success" type="dispatcher">
<param name="location">/register-result.jsp</param>
</result>
<interceptor-ref name="params"/>
</action>
看了前面的介绍，这段配置文件应该不难理解。用户通过注册页面register.jsp输入自己
的注册信息，提交表单到动作register.action，它将有ServletDispatcher 调度，从配置文件
xwork.xml 里查找与“register”匹配的Action 名字，即上面配置的Action。通过这个名字
XWork 框架找到这个Action 的类：example.register.RegisterAction，XWork 框架会负责去创建这个Action 类的对象并调用execute()方法进行用户注册操作。正确执行execute()方法返
回String类型数据“success”之后，它会请求再派遣到register-result.jsp页面。
在这段配置文件里，你一定注意到了它特殊的一句：<interceptor-ref name="params"/>，
interceptor-ref标签设置这个Action用到的拦截器(Interceptor)，“params”引用的是配置文件
<interceptorname="params"class="com.opensymphony.xwork.interceptor.ParametersInterceptor"/>，这个拦截器将在RegisterAction的execute()方法执行之前调用，作用是将request 请求的参数值通过表达式语言设置到相应RegisterAction的模型里。例如：register.jsp里的<input type="text" name="user.username">，它输入的值会由RegisterAction类的getUser()和User类的setUserName(“…”)设置到这个User模型里。假设你在注册页面输入用户名“moxie”，提交表单ParametersInterceptor 就会下面的操作：首先从请求中取得参数的名字和名字对应的值，分别为：“user.username”和“moxie”，根据这个名字，从OgnlValueStack中取得堆栈最上面的getUser().setUsername(“moxie”)操作，即取得RegisterAction对象的User 模型，并设置username属性的值为“moxie”。原来，我们的Action是通过XWork的拦截器ParametersInterceptor 从提交的表单中取得请求的参数和值，再通过OgnlValueStack来执行表达式，调用Action和模型里相应的ge或set 方法，将从请求中取得的值设置到模型中去。register.jsp 中Input 输入框的name="user.username"是必需要遵守OGNL 的命名规则。也正是很多拦截器的使用，使得我们的Action类和Web 实现了完全的解耦，让我们的Action能如此的简单、优雅，拦截器的原理后面章节我们也将会有详细的介绍。
罗索了这么多，你一定是精通了这个用户注册的例子了吧！呵呵！
Field-Driven Action vs. Model-Driven Action
Action根据FormBean的不同可以分为二类，
一类是 Field-Driven（字段驱动的）Action
Action 将直接用自己的字段来充当FormBean 的功能，我们的例子就是使用这种方式。
它一般用在页面表单比较简单的情况使用，而且可以直接用域对象作为Action 的字段，这
样就不用在另写FormBean，减少了重复代码。
另一类是 Model-Driven（模型驱动的）Action
它很像Struts 的FormBean，但在WebWork 中，只要普通Java 对象就可以充当模型部
分。Model-Driven（模型驱动的）Action 要求我们的Action 实现com.opensymphony.xwork.
ModelDriven接口，它有一个方法：Object getModel();，我们用这个方法返回我们的模型对
象就可以了。我们可以将前面的RegisterAction.java 改为Model-Driven（模型驱动的）Action：
package example.register;
import com.opensymphony.xwork.Action;
import com.opensymphony.xwork.ModelDriven;
/**
* @author moxie-qac
* achqian@yahoo.com.cn
*
*/
public class RegisterActionModel implements Action,ModelDriven{
private User user = new User();
public String execute() throws Exception {
System.out.println("Start execute......。。。。。。。。。。。。。。
");
System.out.println("User="+user);
//在这里调用用户注册的业务逻辑，比如：将注册信息存储到数据库
return SUCCESS;
}
public Object getModel() {
return user;
}
}
这时我们输入信息的页面也有了变化：register-model.jsp
<%@page language="java" contentType="text/html; charset=GBK"%>
<html>
<head>

<title>My JSP 'register-model.jsp' starting page</title>

</head>

<body>
<form action="register.action" method="post">
<table border="0" width="100" align="center">
<tr>
<th colspan=2>
<div>
注册信息
</div>
</th>
</tr>
<tr>
<td>
<div>
Username:
</div>
</td>
<td>
<input type="text" name="username">
</td>
</tr>
<tr>
<td>
Password:
</td>
<td>
<input type="text" name="password">
</td>
</tr>
<tr>
<td>
Email:
</td>
<td>
<input type="text" name="email">
</td>
</tr>
<tr>
<td>
Age:
</td>
<td>
<input type="text" name="age">
</td>
</tr>
<th colspan="2">
<input type="submit">
</th>
<tr>
</tr>
</table>
</form>
</body>
</html>
我们发现，输入框里的命名发生了变化。它们都少了“user.”这部分信息。
当我们采用Model-Driven（模型驱动的）Action 时，它将取得模型对象保存在值堆栈中。
“name="username"”就是代表直接调用模型对象的setUsername()方法。
同时，输出信息的界面也要变化，把user.username等都换成username.具体如下：
Register-result.jsp
<%@ page language="java" contentType="text/html;charset=GBK"
pageEncoding="GBK"%>
<%@ taglib prefix="ww" uri="webwork"%>
<html>
<head>
<title>Register Result</title>
</head>
<body>
<table border="0" width="100" align="center">
<tr>
<th colspan="2">
<div align="center">
注册信息
</div>
</th>
</tr>
<tr>
<td>
Username:
</td>
<td>
<ww:property value="username" />
</td>
</tr>
<tr>
<td>
Password:
</td>
<td>
<ww:property value="password" />
</td>
</tr>
<tr>
<td>
Email:
</td>
<td>
<ww:property value="email" />
</td>
</tr>
<tr>
<td>
Age:
</td>
<td>
<ww:property value="age" />
</td>
</tr>
</table>
</body>
</html>
我们Action 的在配置文件中，也要给它指定一个拦截器model-driven，它的作用就是将
模型对象保存到值堆栈中。关于拦截器的介绍请看下面的章节。
配置文件如下：xwork.xml
<action name="registerModel"
class="example.register.RegisterActionModel">
<result name="success" type="dispatcher">
<param name="location">/register-result-model.jsp</param>
</result>
<interceptor-ref name="model-driven"/>
<interceptor-ref name="params"/>
</action>
ActionContext(Action 上下文)
ActionContext介绍
通过上面用户注册例子的学习，我们知道Xwork与Web 无关性，我们的Action不用去
依赖于任何Web 容器，不用和那些JavaServlet复杂的请求（Request）、响应(Response)关联
在一起。对请求（Request）的参数(Param)，可以使用拦截器框架自动调用一些get()和set()
方法设置到对应的Action 的字段中。但是，仅仅取得请求参数的值就能完全满足我们的功
能要求吗？不，在Web 应用程序开发中，除了将请求参数自动设置到Action的字段中，我
们往往也需要在Action 里直接获取请求(Request)或会话（Session）的一些信息，甚至需要
直接对JavaServlet Http的请求（HttpServletRequest）、响应(HttpServletResponse)操作。
带着这些问题，我们来看看下面的一个功能需求：
我们需要在Action中取得request请求参数“username”的值：
ActionContext context = ActionContext.getContext();
Map params = context.getParameters();
String username = (String) params.get(“username”);
为了实现这个功能，我们用了三个步骤：
1、取得我们当前的ActionContext对象context，ActionContext是个什么冬冬？
2、从 context对象里获取我们所有的请求参数，取得的却是一个Map对象params？
3、居然可以从我们的Map 对象params 里获取我们需要的request 请求参数
“username”的值。
ActionContext（com.opensymphony.xwork.ActionContext）是Action 执行时的上下文，
上下文可以看作是一个容器（其实我们这里的容器就是一个Map而已），它存放的是Action
在执行时需要用到的对象，比如：在使用WebWork 时，我们的上下文放有请求的参数
（Parameter）、会话(Session)、Servlet上下文（ServletContext）、本地化（Locale）信息等。
在每次执行Action 之前都会创建新的ActionContext，ActionContext 是线程安全的，也就
是说在同一个线程里ActionContext里的属性是唯一的，这样我的Action就可以在多线程中
使用。
我们可以通过ActionContext 的静态方法：ActionContext.getContext()来取得当前的
ActionContext对象，我们看看这段代码：
public static ActionContext getContext() {
ActionContext context = (ActionContext) actionContext.get();
if (context == null) {
OgnlValueStack vs = new OgnlValueStack();
context = new ActionContext(vs.getContext());
setContext(context);
}
return context;
}
一般情况，我们的ActionContext 都是通过：ActionContext context = (ActionContext)
actionContext.get();来获取的。我们再来看看这里的actionContext 对象的创建：static
ThreadLocal actionContext = new ActionContextThreadLocal();，ActionContextThreadLocal是
实现ThreadLocal 的一个内部类。ThreadLocal 可以命名为“线程局部变量”，它为每一个使用该变量的线程都提供一个变量值的副本，使每一个线程都可以独立地改变自己的副本，而不会和其它线程的副本冲突。这样，我们ActionContext 里的属性只会在对应的当前请求线程中可见，从而保证它是线程安全的。
下面我们看看怎么通过ActionContext取得我们的HttpSession：
Map session = ActionContext.getContext().getSession()；
原来我们取得的session 却是Map 类型的对象，这是为什么？原来，我们的WebWork
框架将与Web 相关的很多对象重新进行了包装，比如这里就将HttpSession对象重新包装成
了一个Map对象，供我们的Action使用，而不用直接和底层的HttpSession打交道。也正是
框架的包装，让我们的Actoion可以完全的和Web 层解藕。
如果我们的Action需要直接与JavaServlet 的HttpSession、HttpServletRequest等一些对
象进行操作，我们又该如何处理？请看下面的ServletActionContext。
ServletActionContext
ServletActionContext（com.opensymphony.webwork. ServletActionContext），这个类直接
继承了我们上面介绍的ActionContext，它提供了直接与JavaServlet 相关对象访问的功能，
它可以取得的对象有：
1、javax.servlet.http.HttpServletRequest：HTTPservlet请求对象
2、javax.servlet.http.HttpServletResponse;：HTTPservlet相应对象
3、javax.servlet.ServletContext：Servlet 上下文信息
4、javax.servlet.ServletConfig：Servlet配置对象
5、javax.servlet.jsp.PageContext：Http页面上下文
ServletActionContext 除了提供了上面这些对象访问，它当然也继承了它父类
ActionContex 的很多功能，比如：对OgnlValueStack、Action名字等的访问。
下面我们看看几个简单的例子，让我们了解如何从ServletActionContext 里取得
JavaServlet的相关对象：
1、取得 HttpServletRequest对象：
HttpServletRequest request = ServletActionContext. getRequest();
2、取得 HttpSession对象：
HttpSession session = ServletActionContext. getRequest().getSession();
ServletActionContext和ActionContext有着一些重复的功能，在我们的Action中，该如
何去抉择呢？我们遵循的原则是：如果ActionContext 能够实现我们的功能，那最好就不要
使用ServletActionContext，让我们的Action 尽量不要直接去访问JavaServlet 的相关对象。
在使用ActionContext 时有一点要注意：不要在Action 的构造函数里使用
ActionContext.getContext()，因为这个时候ActionContext里的一些值也许没有设置，这时通
过ActionContext取得的值也许是null。
ServletDispatcher原理
ServletDispatcher 是默认的处理Web Http 请求的调度器，它是一个JavaServlet，是
WebWork 框架的控制器。所有对Action 调用的请求都将通过这个ServletDispatcher 调度。
它将在web.xml 里配置ServletDispatcher 时指定，让所有对WebWork 的Action(默认的
是.action的后缀)的请求都对应到该调度的JavaServlet 中，具体配置在前面的WebWork安装
中有介绍。
ServletDispatcher 接受客户端__________的HTTP请求，将JavaServlet的很多相关对象进行包装，再传给我们的XWork框架，由我们的XWork框架去解析我们的xwork.xml配置文件，根据配置文件的信息，创建对应的Action，组装并调用相应的拦截器，执行Action，返回执行结果。WebWork使用XWork的核心，主要是由这个ServletDispatcher 去实现的，
ServletDispatcher 的主要功能调用如下：
一、init（）方法在服务器启动时调用，
1、初始化Velocity引擎
2、检查是否支持配置文件重新载入功能。如果webwork.configuration.xml.reload（见
webwork.properties 文件）设置为true,每个request请求都将重新装载xwork.xml配置文件。
在开发环境使用将会非常方便，但在生产环境必需设置为false。
代码如下：
if ("true".equalsIgnoreCase(Configuration.getString("webwork.configuration.xml.reload"))) {
FileManager.setReloadingConfigs(true);
}
3、设置一些文件上传的信息，比如：上传临时目录，上传的最大字节等。都设置在
webwork.properties 文件里，如果在classpath 中找不到这个属性文件，它会去读取默认的
default.properties
二、service（）方法，每次客户端的请求都将调用此方法。
1、通过request 请求取得action 的命名空间（namespace，与xwork.xml 配置文件里
package标签的name对应）
例如：/foo/bar/MyAction.action，取得的命名空间为/foo/bar
在xwork.xml配置文件里应该有这一段：
<package name="foo.bar" …….
2、根据servlet请求的Path,解析出要调用该请求的Action的名字（actionName），例
如：（../foo/bar/MyAction.action -> MyAction）
在 xwork.xml配置文件里应该有：
<package name="foo.bar" …….
<Action name=” MyAction”……
3、创建Action上下文（extraContext）。我们前面介绍的ActionContext上下文的对象，
就是在这里设置的。它将JavaServlet 相关的对象进行包装，放入到extraContext 这
个Map对象里。
/**
* 将所有的应用请求和servlet属性保存到一个HashMap中，
* @param requestMap 存放所有request请求属性的Map
* @param parameterMap 存放所有request请求参数的Map
* @param sessionMap存放所有session属性的Map
* @param applicationMap 存放所有servlet上下文属性的Map
* @param request HttpServletRequest 对象
* @param response HttpServletResponse 对象.
* @param servletConfig ServletConfig 对象.
* @return代表Action 上下文的一个HashMap
*/
public static HashMap createContextMap(Map requestMap, Map parameterMap,
Map sessionMap, Map applicationMap, HttpServletRequest request,
HttpServletResponse response, ServletConfig servletConfig) {
HashMap extraContext = new HashMap();
extraContext.put(ActionContext.PARAMETERS, parameterMap);
extraContext.put(ActionContext.SESSION, sessionMap);
extraContext.put(ActionContext.APPLICATION, applicationMap);
extraContext.put(ActionContext.LOCALE, request.getLocale());
extraContext.put(HTTP_REQUEST, request);
extraContext.put(HTTP_RESPONSE, response);
extraContext.put(SERVLET_CONFIG, servletConfig);
extraContext.put(COMPONENT_MANAGER,
request.getAttribute("DefaultComponentManager"));
// helpers to get access to request/session/application scope
extraContext.put("request", requestMap);
extraContext.put("session", sessionMap);
extraContext.put("application", applicationMap);
extraContext.put("parameters", parameterMap);
AttributeMap attrMap = new AttributeMap(extraContext);
extraContext.put("attr", attrMap);
return extraContext;
}
下面我们来看看它是如何将request请求的参数和session进行包装的：
protected Map getParameterMap(HttpServletRequest request) throws IOException {
return request.getParameterMap();
}
这个方法比较简单，它直接调用了HttpServletRequest 的方法getParameterMap（），将
所有request请求的参数封装到一个Map中。
protected Map getSessionMap(HttpServletRequest request) {
return new SessionMap(request);
}
这个方法取得所有Session 中的属性，它调用了com.opensymphony.webwork.dispatcher.
SessionMap类，这个类实现了Map接口，在entrySet（）方法中列举Session的所有属性，
存放在Set中。
4、根据前面获得的namespace、actionName、extraContext，创建一个ActonProxy
ActionProxy proxy = ActionProxyFactory.getFactory().createActionProxy(namespace,
actionName, extraContext);
默认的proxy 是com.opensymphony.xwork.DefaultActionProxy，在它的构造函数会进行
下面的操作：1）、根据namespace、actionName 读取xwork.xml配置文件里这个Action的所
有配置信息。
2）、创建ActionInvocation
invocation = ActionProxyFactory.getFactory().createActionInvocation(this, extraContext);
默认的invocation是com.opensymphony.xwork.DefaultActionInvocation，它的构造函数操
作有：
a) 由com.opensymphony.xwork.ObjectFactory创建我们配置文件描述的Action对
象。再将这个Action 对象存放入OgnlValueStack 中。记得我们前面用户注册
的例子吗？当用户提交表达时它会有表达式语言向OgnlValueStack 取得
Action 对象的字段，再把输入框的数据设置到对应的Action 字段中，这个
Action对象就是在这个时候进栈的。
b) 传入extraContext 参数，创建与ActionInvocation 对应的Action 上下文
（ActionContext）。记得我们在介绍ActionContext的最后，提出了一个需要注
意的地方：不要在Action构造函数中调用ActionContext.getContext()。现在应
该能明白，原来是Action对象实例在ActionContext 对象实例之前创建的，所
有这样取得ActionContext容器对象就有可能会返回null
c) 取得这个Action对应的所有拦截器（Interceptor），存放入java.util.Iterator 对象
中。
5、执行proxy的execute()方法，这个方法最核心的语句是：retCode = invocation.invoke();，
WebWork教程
有任何意见和建议，请email to:achqian@hotmail.com（MSN）
版权所有，请勿转载和篡改
invocation对象的invoke()方法它遍历并执行这个Action对应的所有拦截器，执行Action对
应的方法（默认的是execute()），根据Action 执行返回的值去调用执行相应的Result（返回
结果处理）的方法。
Action的单元测试
理解了ServletDispatcher，我们就明白了整个框架调用执行的顺序。Action 虽然是与Web
无关，可是它的创建、参数设置、执行与我们的WebWork、XWork 紧密关联在一起，有我
们的控制器ServletDispatcher 去统一调度，那我们如何去对Action进行独立的单元测试呢？
请看下面的例子：使用单元测试框架JUnit对register.User. RegisterAction做单元测试
见 example.register. RegisterActionTest类testExecuteWithProxyFactory()方法：
public void testExecuteWithProxyFactory() throws Exception{
Map params = new HashMap();
params.put("user.username","Moxie");
params.put("user.password","mypassword");
params.put("user.email","achqian@yahoo.com.cn");
params.put("user.age",new Integer(23));
Map extraContext = new HashMap();
extraContext.put(ActionContext.PARAMETERS,params);
ActionProxy proxy =
ActionProxyFactory.getFactory().createActionProxy("example",
"register", extraContext);
proxy.setExecuteResult(false);
assertEquals(proxy.execute(),"success");
RegisterAction action = (RegisterAction) proxy.getAction();
assertEquals(action.getUser().getUsername(),"Moxie");
assertEquals(action.getUser().getAge(),23);
}
下面解说这个方法：
1、对象params 表示请求参数的Map,在它里面设置了注册用户的信息。extraContext当然就
是我们ActionContext上下文的容器，它里面保存了放置请求参数的对象params
2、创建我们的ActionProxy，它传入的参数有：“example”－这个Action 的命名空间，
“register”－Action 对应的名字，extraContext－存放Actin 上下文里的对象，，执行并
将它返回的值与“success”比较，测试Action 是否能正确执行完成。注意：
proxy.setExecuteResult(false);，因为我们是单元测试，所以Action 执行完成就可以了，
不用再去调用结果响应的操作，故将是否执行结果设置为“false”。
3、Action正确执行完成之后，我们也可以测试现在Action的字段里的数据是否按照我们预
期的要求正确设置。从ActionProxy对象里取得执行的Action，即RegisterAction对象，
再取得它的User 模型，将其数据与前面设置参数的数据进行比较，判断它是否等于我
Result Type
前面我们学习了ServletDispatcher，它是WebWork 框架机制的核心。它和Action 在我
们MVC 模式中，扮演着控制器的角色，MVC 模式通过控制器实现了我们模型和视图的分
离。WebWork提供了多种活灵活视图展现方式。
我们先看看前面用户注册例子的展现方式：我们使用的是Jsp 和WebWork 自带的标签
库，Action对应的视图当然是在xwork.xml配置文件里设置：
<action name="register" class="example.register.RegisterAction" >
<result name="success" type="dispatcher">
<param name="location">register-result.jsp</param>
</result>
<interceptor-ref name="params"/>
</action>
Result是Action执行完返回的一个字符串常量，它表示Action执行完成的状态，比如：
执行成功、执行失败等。在我们前面Action的介绍中，详细介绍了它默认的标准Result，当
然Result我们也可以自己定义，只要是一个字符串常量就可以了。
Result 的值在xwork.xml 配置文件里就是result 标签里“name”的值，name="success"
表示Action执行成功，返回“success”就对应此标签的配置，进行视图输出。
“type”就是我们的Result Type，Result Type是一个类，它在Action执行完成并返回
Result 之后，决定采用哪一种视图技术，将执行结果展现给用户。我们输出的类型是：
type="dispatcher"，它对应com.opensymphony.webwork.dispatcher.ServletDispatcherResult这个
类，它将执行结果通过javax.servlet.RequestDispatcher 的forward()或include()方法调度到Jsp
页面展现。
我们可以自己开发Result Type，实现我们需要的视图展现方式。Result Type必需要实现
com.opensymphony.xwork..Result 接口。在WebWork 中，它已经为我们提供了很多Result
Type，实现了视图部分对JSP, Velocity, FreeMarker, JasperReports，XML等的支持，具体如
下表格：
Result Type Nname Class
Dispatcher dispatcher com.opensymphony.webwork.dispatcher.ServletDispatcherRes
ult
Redirect redirect com.opensymphony.webwork.dispatcher.ServletRedirectResult
Action Chaining chain com.opensymphony.xwork.ActionChainResult
Velocity velocity com.opensymphony.webwork.dispatcher.VelocityResult
FreeMarker freemarker com.opensymphony.webwork.views.freemarker.FreemarkerRe
WebWork教程
有任何意见和建议，请email to:achqian@hotmail.com（MSN）
版权所有，请勿转载和篡改
sult
JasperReports jasper com.opensymphony.webwork.views.jasperreports.JasperRepor
tsResult
XML/XSL xslt com.opensymphony.webwork.views.xslt.XSLTResult
HttpHeader com.opensymphony.webwork.dispatcher.HttpHeaderResult
Dispatcher：通过javax.servlet.RequestDispatcher的forward()或include()方法调度到页面展现，
这样的页面一般是Jsp页面。
参数(Parameters) 是否必需描 述
location 是执行完成之后转向的位置
parse 否默认的是“true”，如果设置为“false”，location 参数将不
会被OGNL表达式语言解析
例子：
<result name="success" type="dispatcher">
<param name="location">register-result.jsp</param>
</result>
也可以简单写成这样：
<result name="success" type="dispatcher">register-result.jsp</result>
Redirect：将响应重定向到浏览器指定的位置，它将会导致Action执行完成的数据丢失或不
再可用。它在程序里是通过调用javax.servlet.http.HttpServletResponse.sendRedirect(String
location)方法，将响应定向到参数location指定的、新的url中。
参数(Parameters) 是否必需描 述
location 是执行完成之后转向的位置
parse 否默认的是“true”，如果设置为“false”，location 参数将不
会被OGNL表达式语言解析
例子
<result name="success" type="redirect">
<param name="location">foo.jsp</param>
<param name="parse">false</param>
</result>
Action Chaining：一种特殊的视图结果，将Action执行完之后链接到另一个Action中继续
执行。新的Action使用上一个Action的上下文（ActionContext）。
参数(Parameters) 是否必需描 述
actionName 是将要被链接的Action名字
namespace 否被链接的Action 的命名空间（namespace），如果不设置，
默认的即是当前的命名空间
例子：
<result name="success" type="chain">
WebWork教程
有任何意见和建议，请email to:achqian@hotmail.com（MSN）
版权所有，请勿转载和篡改
<param name="actionName">bar</param>
<param name="namespace">/foo</param>
</result>
将要调用的Action如下：
<action name="bar" class="myPackage.barAction">
...
</action>
Velocity：它类似Jsp的执行环境（使用JavaServlet容器），将Velocity模板转化成数据流的
形式，直接通过JavaServlet输出。
参数(Parameters) 是否必需描 述
location 是执行完成之后转向的位置(一般是.vm页面)
parse 否默认的是“true”，如果设置为“false”，location 参数将不
会被OGNL表达式语言解析
__________例子：
<result name="success" type="velocity">
<param name="location">foo.vm</param>
</result>
FreeMarker：FreeMarker 是一个纯Java 模板引擎；一个普通的基于模板生成文本的工具，
它只能应用在Web 应用环境中。
参数(Parameters) 是否必需描 述
location 是执行完成之后转向的位置
parse 否默认的是“true”，如果设置为“false”，location 参数将不
会被OGNL表达式语言解析
contentType 否如果不指定，默认的是"text/html"
例子：
<result name="success" type="freemarker">foo.ftl</result>
JasperReports：将Action 执行的结果通过JasperReports 报表形式输出，可以指定
JasperReports支持的输出格式（PDF、HTML、XLS、CSV、XML等），默认是通过PDF格
式输出。
参数(Parameters) 是否必需描 述
location 是执行完成之后转向的位置
parse 否默认的是“true”，如果设置为“false”，location 参数将不
会被OGNL表达式语言解析
dataSource 是它是 Action的一个字段（通常是一个List），OGNL表达式
被用来去value stack（OgnlValueStack）重新找回这个
dataSource
format 否报表生成的数据格式，默认的是pdf
WebWork教程
有任何意见和建议，请email to:achqian@hotmail.com（MSN）
版权所有，请勿转载和篡改
例子：
<result name="success" type="jasper">
<param name="location">foo.jasper</param>
<param name="dataSource">mySource</param>
<param name="format">CSV</param>
</result>
或者默认的pdf格式
<result name="success" type="jasper">
<param name="location">foo.jasper</param>
<param name="dataSource">mySource</param>
</result>
XML/XSL：将结果转换为xml 输出
参数(Parameters) 是否必需描 述
location 是执行完成之后转向的位置
parse 否默认的是“true”，如果设置为“false”，location 参数将不
会被OGNL表达式语言解析
例子：
<result name="success" type="xslt">foo.xslt</result>
WebWork教程
有任何意见和建议，请email to:achqian@hotmail.com（MSN）
版权所有，请勿转载和篡改
表达式与言 EL和OGNL
OGNL 介绍
OGNL 是Object-Graph Navigation Language 的缩写，它是一种功能强大的表达式语言
（Expression Language，简称为EL），通过它简单一致的表达式语法，可以存取对象的任意
属性，调用对象的方法，遍历整个对象的结构图，实现字段类型转化等功能。它使用相同的
表达式去存取对象的属性。
XWork 遵循“不要重复地发明同一个轮子”的理论，它的表达式语言核心用的就是这个
OGNL。我们先来看看一个简单的例子：
还记得我们用户注册的那个例子吗？我们输入框的name用到的名字就是OGNL的表达式，
比如：用户名的输入框：“<input type="text" name="user.username">”，在用户注册成功之后
我们要显示用户注册的信息，用了“<ww:property value="user.username"/>”。Input输入框里
的“user.username”，它解析成Java 语句为：getUser().setUsername();，property 标签里的
“user.username”解析为Java 语句：getUser.getUsername();。
我们的两个表达式都是相同的，但前一个保存对象属性的值，后一个是取得对象属性的值。
表达式语言简单、易懂却又功能强大，关于OGNL更多的介绍可以去http://www.ognl.org，
那里有很详细的文档。
值堆栈－OgnlValueStack
OGNL 在框架中的应用，最主要是支持我们的值堆栈（Value Stack）——OgnlValueStack，
它主要的功能是通过表达式语言来存取对象的属性。用户界面输入数据，它会根据保存表达
式将数据依次保存到它堆栈的对象中，业务操作完成，结果数据会通过表达式被获取、输出。
还记得我们用户注册的例子吗？下面我们用一段程序来演示它向OgnlValueStack中保存、取
得数据的步骤：
// DemoRegisterValueStack
package example.register;
import com.opensymphony.xwork.util.OgnlValueStack;
/**
* @author moxie-qac
* achqian@yahoo.com.cn
*
*/
public class DemoRegisterValueStack {
public void demo(){
RegisterAction action = new RegisterAction();
OgnlValueStack valueStack= new OgnlValueStack();
WebWork教程
有任何意见和建议，请email to:achqian@hotmail.com（MSN）
版权所有，请勿转载和篡改
valueStack.push(action);
valueStack.setValue("user.username","Moxie");
System.out.println("username =
"+valueStack.findValue("user.username"));
}
public static void main(String[] args) {
DemoRegisterValueStack demoValueStack = new
DemoRegisterValueStack();
demoValueStack.demo();
}
}
我们来看一看它的demo()方法：
1、创建我们的Action（RegisterAction）类的对象action，将action 对象压入堆栈
valueStack 中。在WebWrok 中Action 的创建、入栈是在DefaultActionInvocation 构
造函数中进行的，详细介绍见：ServletDispatcher 原理。
2、通过表达式语言，调用堆栈对象的get()、set()方法，设置该对象的值。
public void setValue(String expr, Object value)
语句：valueStack.setValue("user.username","Moxie");
的作用等同于：action.getUser().setUsername("Moxie");
3、通过表达式语言，去堆栈对象中查找我们前面保存的值，并在控制台打印。
valueStack.findValue("user.username")等同与语句：
action.getUser().getUsername()
最后控制台打印的结果：
username = Moxie
CompoundRoot
在 OgnlValueStack中，一个堆栈其实是一个List。查看OgnlValueStack你会发现，堆
栈就是com.opensymphony.xwork.util.CompoundRoot类的对象：
public class CompoundRoot extends ArrayList {
//~ Constructors /////////////////////////////////////
public CompoundRoot() {
}
public CompoundRoot(List list) {
super(list);
}
//~ Methods ////////////////////////////////////////////
public CompoundRoot cutStack(int index) {
return new CompoundRoot(subList(index, size()));
}
public Object peek() {
return get(0);
}
public Object pop() {
return remove(0);
}
public void push(Object o) {
add(0, o);
}
}
我们通过表达式向堆栈对象操作时，我们并不知道堆栈中有哪些对象。OgnlValueStack
会根据堆栈由上向下的顺序（先入栈在下面，最后入栈在最上面）依次去查找与表达式匹配
的对象方法，找到即进行相应的存取操作。假设后面对象也有相同的方法，将不会__________被调用。
下面我们看一个对OgnlValueStack操作的程序，它主要演示了如何对Map对象的存取和
OgnlValueStack堆栈的原理：
/*
* Created on 2004-6-15
* DemoGroupValueStack.java
*/
package example.register;
import com.opensymphony.xwork.util.OgnlValueStack;
/**
* @author moxie-qac
* achqian@yahoo.com.cn
*
*/
public class DemoGroupValueStack {
public void demoAction(){
DemoGroupAction action = new DemoGroupAction();
OgnlValueStack valueStack= new OgnlValueStack();
valueStack.push(action);
User zhao = new User();
zhao.setUsername("zhao");
zhao.setEmail("zhao@yahoo.com.cn");
User qian = new User();
qian.setUsername("qian");
qian.setEmail("qian@yahoo.com.cn");
valueStack.setValue("users['zhao']",zhao);
valueStack.setValue("users['qian']",qian);
System.out.println("users['zhao'] =
"+valueStack.findValue("users['zhao']"));
System.out.println("users['qian'] =
"+valueStack.findValue("users['qian']"));
System.out.println("users size =
"+valueStack.findValue("users.size"));
System.out.println("allUserName[0] =
"+valueStack.findValue("allUserName[0]"));
}
public void demoModels(){
User model_a = new User();
model_a.setUsername("model_a");
User model_b = new User();
model_b.setUsername("model_b");
User model_c = new User();
model_c.setUsername("model_c");
OgnlValueStack valueStack= new OgnlValueStack();
valueStack.push(model_a);
valueStack.push(model_b);
valueStack.push(model_c);
System.out.println("username =
"+valueStack.findValue("username"));
System.out.println("[1].username =
"+valueStack.findValue("[1].username"));
System.out.println("[0].toString =
"+valueStack.findValue("[0]"));
System.out.println("[1].toString =
"+valueStack.findValue("[1]"));
System.out.println("[2].toString =
"+valueStack.findValue("[2]"));
}
public static void main(String[] args) {
DemoGroupValueStack demoValueStack = new DemoGroupValueStack();
demoValueStack.demoAction();
demoValueStack.demoModels();
}
}
/*
* Created on 2004-6-15
* DemoAction.java
*/
package example.register;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
/**
* @author moxie-qac
* achqian@yahoo.com.cn
*
*/
public class DemoGroupAction {
private Map users = new HashMap();
public Map getUsers(){
return this.users;
}
public List getAllUserName(){
return new ArrayList(users.keySet());
}
public String execute(){
//执行业务操作
return null;
}
public String toString(){
return users.toString();
}
}
注意：1、Map属性的存取，它的表达式语言如：users['zhao']，注意它用’’来引用HashMap
的key字符串。
2、demoModels（）方法演示了OgnlValueStack 中堆栈的原理，请特别注意它的
[0].toString、[1].toString、[2].toString，它们依次调用堆栈中对象的toString()
方法，并逐一的减少堆栈最上面的对象。
控制台输出的结果如下：
users['zhao'] =
username=zhao;password=null;email=zhao@yahoo.com.cn;age=0
users['qian'] =
username=qian;password=null;email=qian@yahoo.com.cn;age=0
users size = 2
allUserName[0] = qian
username = model_c
[1].username = model_b
[0].toString = [username=model_c;password=null;email=null;age=0,
username=model_b;password=null;email=null;age=0,
username=model_a;password=null;email=null;age=0]
[1].toString = [username=model_b;password=null;email=null;age=0,
username=model_a;password=null;email=null;age=0]
[2].toString = [username=model_a;password=null;email=null;age=0]
Interceptor(拦截器)框架
Interceptor（拦截器）将Action共用的行为独立出来，在Action执行前后运行。这也就是我
们所说的AOP（Aspect Oriented Programming，面向切面编程），它是分散关注的编程方法，
它将通用需求功能从不相关类之中分离出来；同时，能够使得很多类共享一个行为，一旦行
为发生变化，不必修改很多类，只要修改这个行为就可以。
Interceptor 将很多功能从我们的Action 中独立出来，大量减少了我们Action 的代码，独立
出来的行为具有很好的重用性。XWork、WebWork 的许多功能都是有Interceptor 实现，可
以在配置文件中组装Action 用到的Interceptor，它会按照你指定的顺序，在Action 执行前
后运行。Interceptor 在框架中的应用如下图所示：
当你提交对Aciton（默认是.action结尾的Url）的请求时，ServletDispatcher 会根据你的请求，
去调度并执行相应的Action。在Action 执行之前，调用被Interceptor 截取，Interceptor 在
Action执行前后运行。
我们在用户注册的例子中就使用了取得Request 请求参数的拦截器，配置文件中
<interceptor-ref name="params"/>将拦截器params 组装到RegisterAction中。“params”在我
们的webwork-default.xml配置文件中有定义，webwork-default.xml 中拦截器的定义如下：
<interceptors>
<interceptor name="timer"
class="com.opensymphony.xwork.interceptor.TimerInterceptor"/>
<interceptor name="logger"
class="com.opensymphony.xwork.interceptor.LoggingInterceptor"/>
<interceptor name="chain"
class="com.opensymphony.xwork.interceptor.ChainingInterceptor"/>
<interceptor name="static-params"
class="com.opensymphony.xwork.interceptor.StaticParametersInterceptor
"/>
<interceptor name="params"
class="com.opensymphony.xwork.interceptor.ParametersInterceptor"/>
<interceptor name="model-driven"
class="com.opensymphony.xwork.interceptor.ModelDrivenInterceptor"/>
<interceptor name="component"
class="com.opensymphony.xwork.interceptor.component.ComponentIntercep
tor"/>
<interceptor name="token"
class="com.opensymphony.webwork.interceptor.TokenInterceptor"/>
<interceptor name="token-session"
class="com.opensymphony.webwork.interceptor.TokenSessionStoreIntercep
tor"/>
<interceptor name="validation"
class="com.opensymphony.xwork.validator.ValidationInterceptor"/>
<interceptor name="workflow"
class="com.opensymphony.xwork.interceptor.DefaultWorkflowInterceptor"
/>
<interceptor name="servlet-config"
class="com.opensymphony.webwork.interceptor.ServletConfigInterceptor"
/>
<interceptor name="prepare"
class="com.opensymphony.xwork.interceptor.PrepareInterceptor"/>
<interceptor name="conversionError"
class="com.opensymphony.webwork.interceptor.WebWorkConversionErrorInt
erceptor"/>
<interceptor-stack name="defaultStack">
<interceptor-ref name="static-params"/>
<interceptor-ref name="params"/>
<interceptor-ref name="conversionError"/>
</interceptor-stack>
<interceptor-stack name="validationWorkflowStack">
<interceptor-ref name="defaultStack"/>
<interceptor-ref name="validation"/>
<interceptor-ref name="workflow"/>
</interceptor-stack>
</interceptors>
这些都时有框架提供的默认的Interceptor，下面我来看看Interceptor 使用的步骤：
WebWork教程
有任何意见和建议，请email to:achqian@hotmail.com（MSN）
版权所有，请勿转载和篡改
1、创建一个自己需要的Interceptor 类，它必需实现
com.opensymphony.xwork.interceptor.Interceptor 接口，具体的开发见下面的Interceptor
的原理。
2、在配置文件（xwork..xml）中申明这个Interceptor 类，它放在标签<interceptor />中，
同是<interceptor />标签嵌入在<interceptors />标签内部。
3、创建Interceptor 栈，使用标签：<interceptor-stack />，让一组Interceptor 可以按
次序调用。（可选）
4、指定Action 所要用到的Interceptor（前面申明过的），可以用<interceptor-ref />或
<default-interceptor-ref />标签。前面的标签指定某个Action 所用到的Interceptor，如果
Action没有被用<interceptor-ref />指定Interceptor，它将使用<default-interceptor-ref />指
定的Interceptor。
框架中给我们提供了很多实用的Interceptor，它的定义上面已经给出，它的具体功能如下：
timer：记录Action执行的时间，并做为日志信息输出；
logger：在日志信息中输出要执行的Action信息；
chain：将前一个执行结束的Action 属性设置到当前的Action 中。它被用在
ResultType 为“chain”指定结果的Action 中，该结果Action 对象会从
OgnlValueStack中获得前一个Action对应的属性，它实现Action链之间的数据
传递；
static-params：将xwork.xml 配置文件里定义的Action 参数，设置到对应的Action
中。Action参数使用<param />标签，是<action />标签的直接子元素。我们这里定
义的Action 类必需实现com.opensymphony.xwork.config.entities.
Parameterizable接口；
params：将Request请求的参数设置到相应Action对象的属性中，用户注册例子用
到过这个拦截器；
model-driven：如果Action 实现ModelDriven 接口，它将getModel()取得的模型对
象存入OgnlValueStack中；
component：激活组件功能支持，让注册过的组件在当前Action中可用，即为Action
提供IoC（依赖倒转控制）框架的支持；
token：核对当前Action 请求（request）的有效标识，防止重复提交Action 请求
(request)。
token-session：功能同上，但是当提交无效的Action请求标识时，它会将请求数据
保存到session中。
validation：实现使用xml 配置文件（{Action}-validation.xml）对Action 属性值进
行验证，详细请看后面介绍的验证框架。
workflow：调用Action 类的验证功能，假设Action 使用ValidationAware实现
验证（ActionSupport提供此功能），如果验证没有通过，workflow会将请求返回到
input 视图（Action的<result />中定义的）。
servlet-config：提供Action 直接对HttpServletRequest 或HttpServletResponse 等
JavaServlet api的访问，Action要实现相应的接口，例如：ServletRequestAware
或ServletResponseAware等。如果必需要提供对JavaServlet api的访问，我们建
议使用ServletActionContext，在前面ActionContext章节中有介绍。
prepare：在Action执行之前调用Action的prepare()方法，这个方法是用来准备
Action 执行之前要做的工作。它要求我们的Action 必需实现
com.opensymphony.xwork. Preparable接口
WebWork教程
有任何意见和建议，请email to:achqian@hotmail.com（MSN）
版权所有，请勿转载和篡改
conversionError：用来处理框架进行类型转化(Type Conversion)时的出错信息。它将
存储在ActionContext 中的类型转化（Type Conversion）错误信息转化成相应的
Action字段的错误信息，保存在堆栈中。根据需要，可以将这些错误信息在视图中
显示出来。
Interceptor 的原理
下面我们来看看Interceptor 是如何实现在Action执行前后调用的：
Action 和Interceptor 在框架中的执行，是由ActionInvocation 对象调用的。它是用方法：
String invoke() throws Exception;来实现的，它首先会依次调用Action 对应的
Interceptor，执行完成所有的Interceptor 之后，再去调用Action的方法，代码如下：
if (interceptors.hasNext()) {
Interceptor interceptor = (Interceptor) interceptors.next();
resultCode = interceptor.intercept(this);
} else {
if (proxy.getConfig().getMethodName() == null) {
resultCode = getAction().execute();
} else {
resultCode = invokeAction(getAction(), proxy.getConfig());
}
}
它会在拦截器栈中遍历Interceptor，调用Interceptor 的方法：
String intercept(ActionInvocation invocation) throws Exception;。
我们一直都提到，Interceptor 是在Action 前后执行，可是从上面的代码我们看到的却是执行
完所有Interceptor 的intercept()方法之后再去调用我们的Action。“在Action前后执行”
是如何实现的呢？我们来看看抽象类AroundInterceptor的intercept（）实现：
public String intercept(ActionInvocation invocation) throws Exception {
String result = null;
before(invocation);
result = invocation.invoke();
after(invocation, result);
return result;
}
原来在intercept()方法又对ActionInvocation 的invoke()方法进行递归___________调用，
ActionInvocation 循环嵌套在intercept() 中， 一直到语句result =
invocation.invoke();执行结束，即：Action执行完并返回结果result，这时Interceptor
对象会按照刚开始执行的逆向顺序依次执行结束。这样before（）方法将在Action执行前
调用，after（）方法在Action执行之后运行。
WebWork教程
有任何意见和建议，请email to:achqian@hotmail.com（MSN）
版权所有，请勿转载和篡改
验证框架
WebWork提供了在Action执行之前，对输入数据的验证功能，它使用了其核心XWork的验
证框架。提供了如下功能：
1、可配置的验证文件。它的验证文件是一个独立的XML 配置文件，对验证的添加、修改
只需更改配置文件，无需编译任何的Class。
2、验证文件和被验证的对象完全解藕。验证对象是普通的JavaBean 就可以了（可以是
FormBean、域对象等），它们不需实现任何额外的方法或继承额外的类。
3、多种不同的验证方式。因为它验证功能是可以继承的，所以可以用多种不同的方式指定
验证文件，比如：通过父类的Action、通过Action、通过Action 的方法、通过Action
所使用的对象，等等。
4、强大的表达式验证。它使用了OGNL的表达式语言，提供强大的表达式验证功能。
5、同时支持服务器端和客户端验证。
为用户注册添加验证功能
下面我们来看看如何为用户注册添加验证功能：
1、注册我们的验证类型
WebWork为不同的验证要求提供不同的验证类型。一个验证类型，一般是有一个类来
提供。这个类必须实现接口：com.opensymphony.xwork.validator.Validator，但我
们在写自己的验证类型时，无需直接实现Validator 接口，它有抽象类可供直接使用如
ValidatorSupport、FieldValidatorSupport等。
验 证 类型在使用之前， 必须要在ValidatorFactory
（com.opensymphony.xwork.validator. ValidatorFactory）中注册。可以有二种
方法实现验证类型的注册。一、写程序代码进行注册，它使用ValidatorFactory类的静
态方法：registerValidator(String name, String className)。二、使用配置文
件validators.xml 进行注册，要求把文件validators.xml 放到ClassPath 的跟目录中
（/WEB-INF/classes）。但在实际开发中，一般都使用第二中注册方法。我们的验证类型注册
如下：
<validators>
<validator name="required"
class="com.opensymphony.xwork.validator.validators.RequiredFieldValid
ator"/>
<validator name="requiredstring"
class="com.opensymphony.xwork.validator.validators.RequiredStringVali
dator"/>
<validator name="int"
class="com.opensymphony.xwork.validator.validators.IntRangeFieldValid
ator"/>
<validator name="date"
class="com.opensymphony.xwork.validator.validators.DateRangeFieldVali
dator"/>
<validator name="expression"
class="com.opensymphony.xwork.validator.validators.ExpressionValidato
r"/>
<validator name="fieldex