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(必须) | 调度到 jsp 页面展现,其中 Action 请求对应 java 处理程序中的 |
redirect | location(必须) parse | 将响应重定向到浏览器指定的位置,它将会导致 Action 执行完成 |
chain | actionName(必须) | Action Chaining:一种特殊的视图结果,将 Action 执行完之后链接到另一个 |
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.....
}