结合实战简析Controller 配置

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 之后，决定采用哪一种视图技术，将执行结果展现给用户，主要包括：

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.....}