OpenDoc Series’
Webwork2 开发指南
V1.0
作者：夏昕、唐勇
So many open source projects. Why not Open your Documents? J
Webwork2 Developer’s Guide Version 1.0
October 19, 2004 So many open source projects. Why not Open your Documents?
2
文档说明
参与人员：
作者 联络
夏昕 xiaxin(at)gmail.com
唐勇 jlinux(at)gmail.com
(at) 为 email @ 符号
发布记录
版本 日期 作者 说明
0.9 2004.10.10 夏昕 创建
1.0 2004.10.15 唐勇 补充“Webwork 配置说明”部分
OpenDoc 版权说明
本文档版权归原作者所有。
在免费、且无任何附加条件的前提下，可在网络媒体中自由传播。
如需部分或者全文引用，请事先征求作者意见。
如果本文对您有些许帮助，表达谢意的最好方式，是将您发现的问题和文档改进意见及时反馈给
作者。当然，倘若有时间和能力，能为技术群体无偿贡献自己的所学为最好的回馈。
Open Doc Series 目前包括以下几份文档：
n Spring 开发指南
n Hibernate 开发指南
n ibatis2 开发指南
n Webwork2 开发指南
以上文档可从 http://blog.csdn.net/nuke 获取最新更新信息
Webwork2 Developer’s Guide Version 1.0
October 19, 2004 So many open source projects. Why not Open your Documents?
3
目录
目录.....................................................................................................................................................3
WebWork2 开发指南.........................................................................................................................4
Quick Start ..........................................................................................................................5
WebWork 高级特性................................................................................................................18
Action 驱动模式...............................................................................................................18
XWork 拦截器体系.............................................................................................................23
输入校验...........................................................................................................................29
国际化支持 .......................................................................................................................43
Webwork2 in Spring........................................................................................................46
WebWork 配置说明................................................................................................................54
Webwork2 Developer’s Guide Version 1.0
October 19, 2004 So many open source projects. Why not Open your Documents?
4
WebWork2 开发指南
很长一段时间内， OpenSymphony 作为一个开源组织，其光辉始终被 Apache 所掩盖。
Java 程序员热衷于 Apache 组织 Struts 项目研讨之后，往往朦朦胧胧的感觉到，似乎还有另
外一个框架正在默默的发展。
这种朦胧的感觉，则可能来自曾经在国内流行一时的论坛软件－Jive Forum。
很多软件技术人员不惜从各种渠道得到 Jive 的源代码，甚至是将其全部反编译以探其究
竟。作为一个论坛软件能受到技术人员如此垂青，想必作者睡梦中也会乐醒。J
而 WebWork，就是 Jive 中，MVC 实现的核心
1
。
这里我们所谈及的 WebWork，实际上是 Webwork+XWork 的总集，Webwork1.x 版本中，
整个框架采用了紧耦合的设计（类似 Struts），而 2.0 之后，Webwork 被拆分为两个部分，
即 Webwork 2.x +XWork 1.x，设计上的改良带来了系统灵活性上的极大提升。这一点我们稍
后讨论。
Webwork 发行包中的文档并不是很全面，如果开发中遇到什么问题，登录 Webwork Wiki
站点查看在线文档是个不错的选择：
http://www.opensymphony.com/webwork/wikidocs
1
Jive 对 WebWork 的源代码进行了重新封装，主要是包结构上的变化，如 com.opensymphony.webwork
在 Jive 中被修改为 com.jivesoftware.webwork，核心功能并没有太大改变
Webwork2 Developer’s Guide Version 1.0
October 19, 2004 So many open source projects. Why not Open your Documents?
5
Quick Start
准备工作：首先下载 WebWork2 的最新版本(http://www.opensymphony.com/webwork/)。
WebWork2 发 行 包 中的\lib\core 目 录 下 包含了 WebWork2 用 到 的 核心类库。将
\webwork-2.1.1.jar 以及\lib\core\*.jar 复制到 Web 应用的 WEB-INF\lib 目录。本 例 的部署结构
如图所示：
这里我们选择了一个最常见的登录流程来演示 Webwork2 的工作流程。虽然简单，但足
以明理。
页面流程如下：
登录成功页面，显示几条通知消息：
