使用ActionForm一次获取表单的所有参数值

用过Jakarta Struts的兄弟都知道ActionForm的使用方法和她在Struts框架中所起的作用,但是您是否在为要给ActionForm编写一大堆setter和getter方法而感到厌倦和疲惫呢?的确,我是厌倦了,所以我要寻求新的方法。我第一反映就是想使用Map接口,将所有的表单参数全部放进HashMap中,然后在Action中get出这个Map,并进行业务逻辑的操作。有了想法当然要去试验了,实践才是检验真理的唯一标准。
首先要编写一个扩展ActionForm的类。代码如下(由于篇幅,我只列出了代码的关键部分):

package com.jacktan.struts.formbean;
import java.util.*;
import javax.servlet.http.*;
import org.apache.struts.action.*;

public class CustomForm extends ActionForm {

private Map formValueMap = new HashMap();

public void setFormValueMap(Map p_FormValueMap){
this.formValueMap = p_FormValueMap;
}

public Map getFormValueMap(){
return this.formValueMap;
}

public void setFormValue(String key,Object value){
formValueMap.put(key,value);
}

public Object getFormValue(String key){
return formValueMap.get(key);
}
}

下面对上面的代码一一做解释:
第11行定义了一个HashMap类的实例变量,这个Map用于存放表单递交上来的参数值,作为键值对存在;
第13行的setFormValueMap()方法用于设置实例变量formValueMap;
第17行的getFormValueMap()方法用于获取实例变量formValueMap,这个方法将在Action类中调用,替代了以前在Action类中调用大量的(CustomForm)form.getXXX()方法;
第21行是关键的方法,setFormValue()这个方法就是取代以前在ActionForm中大量的setXXX()方法,用于接受表单传递上来的输入值。注意这个方法的参数,key是一个String类型的,用作Map的key,value是Object类型的,这个参数就是表示表单传送过来的各个输入值。
第25行是getFormValue()方法,用于从Map中根据key返回一个value对象。

好了,ActionForm的任务完成了,不过离目标还有好大一段距离,目前只完成了三分之一的工作。我们继续干!

有了ActionForm接下来就是要编写Action类了,代码如下(由于篇幅,我只列出了代码的关键部分):

package com.jacktan.struts.action;

import java.util.*;
import javax.servlet.http.*;

import org.apache.struts.action.*;

import com.jacktan.struts.formbean.CustomForm;

public class CustomAction extends Action {
public ActionForward execute(
ActionMapping p_Mapping,
ActionForm p_Form,
HttpServletRequest p_Request,
HttpServletResponse p_Response)
throws Exception{
Map formValues =
((CustomForm)p_Form).getFormValueMap();
return p_Mapping.findForward("Success");
}
}

CustomAction类的关键行在第21-22行,使用在CustomForm类中定义的 getFormValueMap()方法一次就将表单中所有的提交参数收集完毕,省掉了以前要使用很多getXXX()方法从ActionForm中获取表单值的做法。
好了,接下来是要编写JSP页面了,因为我们的ActionForm使用特殊的方法接受参数值,所以在写表单页面的时候也要使用特殊的签名。代码如下:

<html:form action="login">
<table width="100%" border="0">
<tr>
<td width="3%"> </td>
<td width="31%"> </td>
<td width="66%" rowspan="6" valign="top">
<html:errors/>
</td>
</tr>
<tr>
<td> </td>
<td height="25">用户名</td>
</tr>
<tr>
<td> </td>
<td height="25">
<html:text property="formValue(username)" size="12" maxlength="12"/>
</td>
</tr>
<tr>
<td> </td>
<td height="25">密码</td>
</tr>
<tr>
<td> </td><td height="25">
<html:password property="formValue(password)" size="12" maxlength="12" redisplay="false"/>
</td>
</tr>
<tr>
<td> </td>
<td height="25">
<html:submit value="登录"/>
<html:button property="close" value="关闭" onclick="Close()"/>
</td>
</tr>
</table>

上面是一个用户登录的界面,注意红色的部分,这个签名要和CustomForm类中的setFormValue()签名保持一致,注意大小写,Struts会利用Java的反射机制寻找到合适的方法调用。formValue(username)圆括号中的字符串可以是表示该输入域在数据库中字段的映射,也可以是自己自定义的字符串,这个字符串将作为Map的key保存。
好了,终于要完成了,最后要做的就是设置struts的配置文件了,打开struts-config.xml文件,

在<form-beans>段输入以下代码:

<form-beans>
<form-bean
name="CustomForm"
type="com.jacktan.struts.formbean.CustomForm"/>
</form-beans>

在<action-mappings>段输入以下代码:

<action
path="/login"
type="com.jacktan.struts.action.CustomAction"
name="addDeviceForm"
scope="request">
<forward name="login" path="main.jsp"/>
</action>

大功告成,所有的任务都完成了。为了检测是否可以正确运行,我在Action类中加入如下测试代码:

Set set = formValues.entrySet();
Iterator it = set.iterator();
while( it.hasNext() ){
Map.Entry me = (Map.Entry)it.next();
System.out.println((String)me.getKey);
System.out.println((String)me.getValue);
}

以上代码将在Tomcat的控制台中打印出所有表单提交的参数值,你也可以使用Struts中log4j组件在日志文件中输入。好了,就写到这里吧,以上就是使用Map将表单提交的数据一次性获取,并在Action中调用的全部工作内容,希望对大家使用Struts做开发的兄弟有所提示和启发。

Jacktan
写于2004-7-20凌晨1:42

困惑,不知道这样做的好处。
1.客户端提交的数据用vo(常用form bean)封装,自然比用map封装安全得多。map.get(key),缺乏key正确性的保障。
2.获得这个map数据集合有什么用,用它作为业务层和表现层的数据通讯单元吗?将map传到业务层,也避免不了使用map.get(key)。一个属性名变化了呢,自动化工具没法帮你找到什么地方该修改。
一般还是用po吧(有时也不得不用vo,甚至request)。
action里的主要责任是控制页面流转,其中一部分工作是将vo转化为po,如果嫌get、set麻烦,大不了用BeanUtils.copyProperties()。