Struts1.x系列教程（14）：动态Form

一、动态Form简介

虽然ActionForm功能强大，但有些时候使用起来有些麻烦。如每建立一个用户录入界面（JSP页面），就得建立一个ActionForm子类来和这个页面对应。当然，我们可以采用嵌套属性从一定程度上弥补这个问题。但是在建立新的用户录入界面时，仍不可避免地要建立新的ActionForm子类。

在Struts1.2.6及以后的Struts版本中提供了一种动态Form的技术。使得不用再建立新的ActionForm就可以封装用户提交的数据。实际上，这种技术将定义ActionForm子类的工作变成了编写XML文件的工作。

每定义一个动态Form，就要在struts-config.xml中加一个<form-bean>元素，并使用<form-property>子元素来定义动态Form的属性。

在本章的最后还会介绍一个LazyValidatorForm类，通过这个类甚至可以不定义动态Form的属性就可以使用动态Form.这将大大简化开发人员的工作量。

二、声明动态Form

声明一个动态Form非常简单，只需要在struts- config.xml的<form-beans>元素中加入一个<form-bean>子元素，并使用<form- property>元素来定义动态Form的属性。我们可以定义的属性类型有简单属性（如String）、索引属性（如数组）、映射属性（如 HashMap）以及嵌套属性（属性类型是另一个类）。

对于动态Form来说，Form的类型必须是org.apache.struts.action.DynaActionForm或其子类。声明一个动态Form的代码如下：

<form-bean name="dynamicForm" type="org.apache.struts.action.DynaActionForm"> <!-- 声明一个简单属性 --> <form-property name="simpleProp" type="java.lang.String" initial="bill"/> <!-- 声明一个索引属性 --> <form-property name="indexedProp" type="java.lang.String[]" /> <!-- 声明一个映射属性 --> <form-property name="mappedProp" type="java.util.HashMap" /> <!-- 声明一个嵌套属性 --> <form-property name="nestedProp" type="com.bean.MyBean" /> </form-bean>

三、动态Form的属性类型

下面列出了动态Form支持的简单属性的所有类型：

java.math.BigDecimal java.math.BigInteger java.lang.Boolean java.lang.Byte java.lang.Character java.lang.Class java.lang.Double java.lang.Float java.lang.Integer java.lang.Long java.lang.Short java.lang.String java.sql.Date java.sql.Time java.sql.Timestamp

实际上，上面的数据类型就是Java中提供了简单数据类型。它们用在动态Form中和在Java中代表的数据类型是完全一样的。我们还可以使用<form-property>元素的initial属性为动态Form的简单属性指定一个默认值。如在例程6-11中name属性的默认值为“bill”。

对于索引属性的类型来说，可以是数组，也可以是java.util.List接口的类（如ArrayList）。我们还可以为动态Form的属性指定实现java.util.Map接口的类作为数据类型（也就是映射属性）。但遗憾的是，如果使用动态Form，就无法使用泛型进行自动类型转换了。

四、访问动态Form

我们可以使用DynaActionForm类的getter方法来读取动态Form中的属性值。DynaActionForm类的getter方法有三个重载形式，分别用来读取简单属性、索引属性和映射属性。这三个getter方法的定义如下：

public Object get(String name) ; // 读取简单属性 public Object get(String name, int index) ; // 读取索引属性 public Object get(String name, String key); // 读取映射属性

下面的代码演示了如何通过getter方法获得动态Form的属性值：

DynaActionForm dForm = (DynaActionForm)form; String name = (String)dForm.get("name"); String[] hobbies = (String[])dForm.get(“hobbies”); String value1 = (String)dForm.get(“myMap”, “key1”);

除了上述的get方法外，DynaActionForm还提供了getString和getString方法，分别用来读取String和String[]类型的属性值，这两个方法的定义如下：

public String getString(String name) ; public String[] getStrings(String name) ;

下面的代码演示了如何通过getString和getStrings方法获得动态Form的属性值：

String name = dForm.getString(“name”); // 相当于String name = (String)dForm.get("name"); String[] hobbies = dForm.getStrings(“hobbies”); // 相当于String[] hobbies = (String[])dForm.get(“hobbies”);

在使用getString和getStrings方法时应注意，这两个方法只能读取String或String[]类型的属性，读取其他类型的属性将会抛出异常。

五、一个动态Form的例子

我们在这一部分来实现一个完整的动态Form的例子，在这个例子中的动态Form有四个属性，三个是简单数据类型，一个是数组类型。完成这个例子需要如下四步：

【第1步】配置动态Form打开struts-config.xml，在<form-beans>元素中加入如下的内容：

<form-bean name="dynamicForm" type="org.apache.struts.action.DynaActionForm"> <form-property name="name" type="java.lang.String" /> <form-property name="age" type="java.lang.Short" /> <form-property name="salary" type="java.lang.Float" /> <form-property name="hobby" type="java.lang.String[]" /> </form-bean>

【第2步】编写Struts Action类

这个Struts Action类负责从动态Form中获得属性值，并输出到客户端浏览器。在<samples工程目录>"src"action目录中建立一个DynamicAction.java文件，代码如下：

package chapter6.action; import javax.servlet.http.*; import org.apache.struts.action.*; import java.io.*; public class DynamicAction extends Action { public ActionForward execute(ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response) { try { DynaActionForm dForm = (DynaActionForm) form; String name = (String) dForm.get("name"); Short age = (Short) dForm.get("age"); Float salary = (Float) dForm.get("salary"); // 获得数组类型字段值的数组长度 int hobbyCount = ((String[]) dForm.get("hobby")).length; PrintWriter out = response.getWriter(); out.println("name: " + name + "<p/>"); out.println("age: " + age + "<p/>"); out.println("salary: " + salary + "<p/>"); for (int i = 0; i < hobbyCount; i++) out.println("hobby" + (i + 1) + ": " + dForm.get("hobby", i) + "<p/>"); } catch (Exception e) { } return null; } }

【第3步】配置Struts Action

打开struts-config.xml文件，在<action-mappings>元素中加入如下的内容：

<action name="dynamicForm" path="/dynamic" scope="request" type="action.DynamicAction" />

【第4步】编写用户录入数据的JSP页面

在Web根目录中建立一个dynamic.jsp文件，代码如下：

<%@ page pageEncoding="GBK"%> <%@ taglib uri="http://struts.apache.org/tags-html" prefix="html"%> <html> <head> <title>测试动态Form</title> <html:base/> </head> <body> <html:form action="dynamic" > 姓 名：<html:text property="name" />  <p> 年 龄：<html:text property="age" />  <p> 工 资：<html:text property="salary" />  <p> 爱好1：<html:text property="hobby" value=""/>  <p> 爱好2：<html:text property="hobby" value=""/>  <p> 爱好3：<html:text property="hobby" value=""/>  <p> <html:submit value="提交" /> </html:form> </body> </html>

启动Tomcat后，在IE中输入如下的URL来测试程序：

http://localhost：8080/samples/dynamic.jsp

六、验证动态Form

有两种方法可以验证动态Form：

1. 在DynaActionForm的子类中覆盖validate方法。

2. 如果要使用Validator框架来验证动态Form，需要用DynaActionForm的子类org.apache.struts.validator. DynaValidatorForm或其子类来作为动态Form的类型。

在使用DynaValidatorForm的了类时，要想使用Validator框架的验证机制，需要在DynaValidatorForm子类的validate方法的开始位置使用 super.validate（）语句来调用DynaValidatorForm中的validate方法。