1. xwork.xml 主文件
xwork.xml 是 WebWork 自身的配置文件,实际开发中它是配置文件的主干骨架。
xwork 定义了一个 default 包,通过 include 包含 xwork 子文件。如下所示:
<!DOCTYPE xwork PUBLIC "-//OpenSymphony Group//XWork 1.0//EN" "http://www.opensymphony.com/xwork/xwork-1.0.dtd"><xwork> <include file="webwork-default.xml"/> <include file="common.xml"/> <include file="user.xml"/></xwork>
回到顶部
2. xwork.xml 子文件
xwork 子文件一方面有效地对大型程序进行分解,符合程序开发的模块化切分。
另一方面帮助我们遍历整个程序,有助于日后的运维。
由于 webwork 开发过程中 xwork.xml 的结构定义是一致的,保证了较低的学习成本。
<!DOCTYPE xwork PUBLIC "-//OpenSymphony Group//XWork 1.0//EN" "http://www.opensymphony.com/xwork/xwork-1.0.dtd"><xwork> <package name="user" extends="webwork-default" systemId="1001" caption="用户管理"> <default-interceptor-ref name="defaultStack" /> <action name="dirUser" class="com.rambo.app.base.user.action.DirUser" caption="查询用户" event-type="5"> <result name="success" type="dispatcher"> <param name="location">/user/diruser.jsp</param> </result> <result name="error" type="redirect"> <param name="location">doError.action</param> </result> </action> <action name="addUser" class="com.rambo.app.base.user.action.AddUser" caption="添加用户" event-type="3"> <result name="success" type="dispatcher"> <param name="location">/result.jsp</param> </result> <result name="error" type="dispatcher"> <param name="location">/result.jsp</param> </result> <interceptor-ref name="modelDrivenStack" /> </action> </package></xwork>
回到顶部
2.1 package
包: package,包的名称可以理解为模块的名称(各子文件包名称不能重复)。所有的 action 定义在包的下一层。
命名空间:namespace,如:namespace="/user",描述子模块 jsp 文件的所在路径,同时明确了请求访问时的 url 网址:/user/*.action。
命名空间为空则请求访问时的 url 网址:/*.action。
命名空间的好处:
1) 体现模块化
2) 命名空间为空,则访问请求的 url 网址均为/*.action,容易冲突
回到顶部
2.2 action
action name:对应请求的名称,如 dirUser,url:/user/dirUser.action
action class:com.rambo.app.base.user.action.DirUser 后台接收请求对应的 java 处理类
action.result.location:diruser.jsp 对处理结果进行展示,文件所在目录位置为 /user/diruser.jsp
回到顶部
2.3 result
ServletDispatcher 是 WebWork 框架机制的核心。它和 Action 在 MVC 模式中,扮演着控制器的角色,MVC 模式通过控制器实现了模型和视图的分离。
Xwork 文件中的 Result 是 Action 执行完返回的一个字符串常量,它表示Action 执行完成的状态,比如:执行成功、执行失败等。
WebWork 的 Action 提供了默认的几种(包括:success、error、login、none、input 等)另外 Result 完全可以自己定义,只要是一个字符串常量就可以了。
Result 标签定义中 name 为返回的字符串常量值,如:name="success"表示
Action 执行成功,返回结果就将根据此标签的具体配置进行视图输出。
type 对应 Result Type 类,它在 Action 执行完成并返回 Result 之后,决定采用哪一种视图技术,将执行结果展现给用户,主要包括:
type | 参数 | 描述 |
dispatcher |
location(必须) parse |
调度到 jsp 页面展现,其中 Action 请求对应 java 处理程序中的 的数据可以被页面直接使用 |
redirect | location(必须) parse |
将响应重定向到浏览器指定的位置,它将会导致 Action 执行完成 的数据丢失或不再可用。将响应定向到参数 location 指定的、新的 url 中 |
chain |
actionName(必须) namespace |
Action Chaining:一种特殊的视图结果,将 Action 执行完之后链接到另一个 Action 中继续执行。新的 Action 使用上一个 Action 的上下文(ActionContext) |
1. type = dispatcher<result name="success" type="dispatcher"> <param name="location">userinfo.jsp</param></result>简写:<result name="success" type="dispatcher">userinfo.jsp</result> 2. type = redirect<result name="error" type="redirect"> <param name="location">../userinfo.jsp</param></result>简写:<result name="error" type="redirect">../userinfo.jsp</result>3. type = chain<result name="success" type="chain"> <param name="actionName">rambo</param></result>Action:<action name="rambo" class="myPackage.barAction"> ...</action>
回到顶部
2.4 interceptor
WebWork 截获 Action 请求,在 Action 执行之前或之后调用拦截器方法。这样,可以用插拔的方式将功能注入 Action 中。
实际开发中最常用拦截器主要封装了对表单参数提交时的处理,如对象化等,包括如下三类:
1) 默认拦截器 <interceptor-ref name="defaultStack"/>
2) 支持模型驱动拦截器 <interceptor-ref name="modelStack"/>
3) 支持文件上传拦截器 <interceptor-ref name="uploadStack"/>
回到顶部
2.4.1 defaultStack 默认拦截器
默认的表单处理拦截器。Xwork.xml 定义的 Action 只要继承 ActionSupport类,通过默认拦截器就可以自动将 jsp 表单数据转换为 java 文件定义的相应变量。
注意:jsp 文件表单 input 中的 name 名要与 java 文件中的变量名相对应。
如下面示例中的 sysId 和 gUser 对象。
前端:
<form name="form1" id="form1" action="login.action" method="post"> <input type="hidden" name="sysId" id="sysId"/><br/> 用户名:<input name="gUser.email" id="gUser.email"/><br/> 密码:<input name="gUser.password" id="gUser.password" type="password"/><br/> <input name="login" type="submit" value="登录"/></p></form>
Xwork.xml:
<action name="login" class="com.rambo.app.user.login.LoginAction"> <result name="success" type="redirect"> <param name="location">user/dirUser.action</param> </result> <result name="error" type="redirect"> <param name="location">doError.action</param> </result> <interceptor-ref name="defaultStack"/> </action>
Java 端:
public class LoginAction extends ActionSupport{ private Integer sysId; public GUser gUser = new GUser(); public LoginAction() { } public String execute() { //业务处理...... return Action.SUCCESS; } //getter/setter......}
回到顶部
2.4.2 modelStack 模型驱动拦截器
Xwork.xml 定义的 Action 在继承 ActionSupport 类的同时需要实现 ModelDriven(模型驱动)接口中的 Object getModel()方法,通过这个方法返回的就是要接收的模型对象。
就可以直接将 jsp 表单数据转换为 java 文件定义的相应对象。
如下面 Java 示例中的 info 对象。注意:jsp 文件表单 input 中的 name 应该与 java 文件中 info 对象所对应 User 类中的属性相对应。
前端:
<form name="form1" id="form1" action="editUserInfo.action" method="post"> <input type="hidden" name="id" id="id"/> <div>邮箱:<input readonly name="email" id="email"/></div> <div>姓名:<input name="realName" id="realName" /></div> <div>电话:<input name="phone" id="phone"/></div> <div><input type="submit" value="保存"/></div></form>
Xwork.xml:
<action name="editUserInfo" class="com.rambo.app.user.info.EditUserInfo"> <result name="success" type="dispatcher"> <param name="location">../resultjson.jsp</param> </result> <result name="error" type="dispatcher"> <param name="location">../resultjson.jsp</param> </result> <interceptor-ref name="modelStack"/> </action>
Java 端:
public class EditUserInfo extends ActionSupport implements ModelDriven{ private GUser info = new GUser(); public Object getModel() { return info; } public EditUserInfo() { } protected String execute() { //业务处理..... return Action.SUCCESS; } //getter/setter......}
回到顶部
2.4.3 uploadStack 上传拦截器
Xwork.xml 定义的 Action需要继承 ActionSupport 类,通过文件上传拦截器就可以自动将 jsp 表单数据及二 进制文件数转换为 java 文件定义的相应变量各文件对象,如下面示例中的 userId 和 uploadFile 对象。
注意:jsp 文件表单 input 中的 name 名要与 java 文件中的变量名相对应。
前端:
<form name="form1" action="uploadUserImg.action" method="post" ENCTYPE="multipart/form-data" > <input type="hidden" name="userId" id="userId" value="1" /> 上传附件:<input type="file" name="uploadFile" id="uploadFile"> <input type="submit" value="上传"></form>
Xwork.xml:
<action name="uploadUserImg" class="com.rambo.app.user.info.UploadUserImg"> <result name="success" type="dispatcher"> <param name="location">../resultxml.jsp</param> </result> <result name="error" type="dispatcher"> <param name="location">../resultxml.jsp</param> </result> <interceptor-ref name="uploadStack"/> </action>
Java 端:
public class UploadUserImg extends ActionSupport { private Integer userId; private File uploadFile; public UploadUserImg() { } public String execute() { if (uploadFile == null || userId == null) return Action.ERROR; //业务处理...... return Action.SUCCESS; } //getter/setter.....}