在Succeeding with Struts的前面安装部分，我间接提到了DynaForms在运行期内可以动态的控制表格大小。换句话说，就是能够根据需要得到5行、或者10行、或者15行长的表格。可能有点不明智，我把这种策略的实际实现作为一种练习留给了读者自己。在接下来的几个月内，我收到了几十个读者的请求，他们请求给出详细的实现细节，所以这个月我将用两种不同的方法来实现动态调整的表格。
第一个方法就是我在前面的栏目中提到的那个方法，将尺寸参数留给DynaForm 的form-property 属性来实现。为了演示详细过程，我们来看看一个非常简单的应用：添加关于不同Star Wars 演员的注释。在这个应用中我们感兴趣的关键事实是：演员的数量在表格配置中动态设定，而不是在struts-config.xml文件中动态设定。
首先，我们先来看看struts-config.xml 文件：
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE struts-config PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 1.1//EN" "http://jakarta.apache.org/struts/dtds/struts-config_1_1.dtd"> <struts-config> <form-beans> <form-bean name="dynamicArrayForm" type="org.apache.struts.validator.DynaValidatorForm"> <form-property name="people" type="demo.Person[]"/> </form-bean> </form-beans> <action-mappings> <action path="/setupForm" type="demo.SetupFormAction" name="dynamicArrayForm" scope="session" validate="false"> <forward name="success" path="/displayForm.jsp"/> </action> <action path="/processActorComments" type="demo.ProcessFormAction" name="dynamicArrayForm" scope="session" validate="false"> <forward name="success" path="/displayForm.jsp"/> </action> </action-mappings> </struts-config> |
如你所见，这是一个相当简单的配置文件，只定义了一个表格和两个动作。第一个动作，/setupForm，用来在初始显示之前配置表格；另一个动作，/processActorComments 用来处理用户输入的注释。
在这个文件中有两个重要的事情需要注意，它们对于事态的发展很关键：
1. people 表格属性定义为demo.Person[] 类型(即demo.Person的一个排列)，但不给出任何size 参数。这就为要创建的排列产生了一个占位符，但是没有任何例示的实排列。
2. 这两个动作将表格定义在会话期范围内。这是很关键的，因为用户在填写数值之后提交表格时，数值在动作执行之前已经填充到表格内了。这就意味着没有机会手动创建具有恰当空位数的排列，正如你在表格显示之前在SetupFormAction 类中看到的情况一样。换句话说，当表格提交时，必须已经有恰当的空位来接受表格值，唯一能保证这个的方法就是在会话期范围内就已经有了这个表格。
基本上在Person bean 中是没有值的，他只是一个具有lastName、 firstName、 dateOfBirth、gender 和comment字段的普通bean。源文件包括在WAR 文件内。
现在我们来看看SetupFormAction 类，它在表格第一次显示之前调用。
package demo; /** * Copyright 2004, James M. Turner. * All Rights Reserved * * A Struts action that sets up a DynaForm which is globally scoped */ import java.io.IOException; import javax.servlet.ServletException; import javax.servlet.http.*; import org.apache.struts.action.*; import org.apache.struts.validator.DynaValidatorForm; public class SetupFormAction extends Action { public ActionForward execute(ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { DynaValidatorForm df = (DynaValidatorForm) form; Person[] p = new Person[3]; p[0] = new Person(); p[0].setDateOfBirth("07/13/1942"); p[0].setLastName("Ford"); p[0].setFirstName("Harrison"); p[0].setGender("M"); p[1] = new Person(); p[1].setDateOfBirth("10/21/1956"); p[1].setLastName("Fisher"); p[1].setFirstName("Carrie"); p[1].setGender("F"); p[2] = new Person(); p[2].setDateOfBirth("09/25/1951"); p[2].setLastName("Hamill"); p[2].setFirstName("Mark"); p[2].setGender("M"); df.set("people", p); return mapping.findForward("success"); } } |
这一次也没有许多东西要看的。execute 方法要做的第一件事情，和任何基于DynaForm的动作所做的一样，就是将泛型ActionForm 类放到DynaValidatorForm内。这就使得我们可以在表格上使用get和set 方法。第二件事情就是，创建一个具有三个元素的类型Person 的排列。在这个方法中，尺寸是硬布线的，在实际应用中可以从数据库中选择一个尺寸。我们需要考虑的重要事情是排列应该在代码中创建，而不是由Struts引擎自己创建。这样行数可根据应用要求由代码随意指定。
一旦排列已经确定，方法将创建三个Person 类实例并赋与数值。同样，在实际的应用中可通过一个循环来实现，这个循环不断地从数据库中读取行和填充表格行。最后，动作返回成功，导致Struts转移控制到displayForm.jsp 页。
<!-- Copyright 2004, James M Turner. All Rights Reserved --> <%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %> <%@ taglib uri="/WEB-INF/c.tld" prefix="c" %> <head> <title>Star Wars Actor Fact Page</title> </head> <H1><center>Start Wars Actor Fact Page</title> <html:form action="/processActorComments" > <table border="1" width="80%"> <tr><th>Last Name</th><th>First Name</th><th>Date of Birth</th><th>Comment</th></tr> <c:forEach var="people" items="${dynamicArrayForm.map.people}"> <tr><td><c:out value="${people.lastName}"/></td> <td><c:out value="${people.firstName}"/></td> <td><c:out value="${people.dateOfBirth}"/></td> <td><html:text name="people" indexed="true" property="comment"/></td> </tr> </c:forEach> </table> <P/> <html:submit value="Update Comments"/> </html:form> |
同样，这里也没有很多东西要看的，他与我们上一篇文章查看固定长度的行时的代码完全一样。该页迭代行（记住在JSTL中我们必须使用map 属性来获得到DynaForm 属性的访问），显示演员的姓、名和出生日期，并提供文本域以便输入注释。
当我们聚焦我们的浏览器合请求时，http://localhost:8080/struts/setupForm.do (假设你把struts.war 文件放在你本地机器的Tomcat 内)，将会出现下列页面：
Start Wars Actor Fact Page
一旦表格提供，另一个简单的Struts动作来处理结果：
package demo; /** * Copyright 2004, James M. Turner. * All Rights Reserved * * A Struts action that sends the new comments to the console */ import java.io.IOException; import javax.servlet.ServletException; import javax.servlet.http.*; import org.apache.struts.action.*; import org.apache.struts.validator.DynaValidatorForm; public class ProcessFormAction extends Action { public ActionForward execute(ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { DynaValidatorForm df = (DynaValidatorForm) form; Person[] p = (Person[]) df.get("people"); for (int i = 0; i < p.length; i++) { System.out.println(p[i].getFirstName() + " " + p[i]. getLastName() + ":" + p[i].getComment()); } return mapping.findForward("success"); } } |
在实际的应用中，这就是数据写回到数据库的地方。在这种情况下，他只将数据倒在控制台上所以我们可以看到他是正确收到的。假设我们为每个演员都填充了恰当的值，我们在控制台上会看到下列内容：
Harrison Ford:Indiana Jones Carrie Fisher:Postcards from the Edge Mark Hamill:Wing Commander |
正如我在文章开头提到的一样，还有另一个方法可以解决这个问题，而且它不需要使用会话期范围内的表格。这个方法就是使用HashMaps 来存储行。我们来看看使用HashMaps编写的同一段代码：
首先，我们添加一个新表格到struts-config.xml：
<form-bean name="dynamicHashmapForm" type="org.apache.struts.validator.DynaValidatorForm"> <form-property name="people" type="java.util.HashMap"/> <form-property name="comments" type="java.util.HashMap"/> </form-bean> |
现在，我们不使用beans的排列，改为使用HashMap 来存储每个人的数据。另外，我们需要一个新的HashMap 来存储注释，原因我稍后再解释。我们也需要一个新的动作来填充数据：
package demo; /** * Copyright 2004, James M. Turner. * All Rights Reserved * * A Struts action that sets up a DynaForm which is globally scoped */ import java.io.IOException; import java.util.HashMap; import javax.servlet.ServletException; import javax.servlet.http.*; import org.apache.struts.action.*; import org.apache.struts.validator.DynaValidatorForm; public class SetupHashFormAction extends Action { public ActionForward execute(ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { DynaValidatorForm df = (DynaValidatorForm) form; HashMap hm = (HashMap) df.get("people"); Person p = new Person(); p = new Person(); p.setDateOfBirth("07/13/1942"); p.setLastName("Ford"); p.setFirstName("Harrison"); p.setGender("M"); hm.put("1", p); p = new Person(); p.setDateOfBirth("10/21/1956"); p.setLastName("Fisher"); p.setFirstName("Carrie"); p.setGender("F"); hm.put("2", p); p = new Person(); p.setDateOfBirth("09/25/1951"); p.setLastName("Hamill"); p.setFirstName("Mark"); p.setGender("M"); hm.put("3", p); return mapping.findForward("success"); } } |
基本上，这段代码与前面的代码相同，除了我们将Person 对象存储到HashMap 中，而不是排列中之外。我们也不需要创建HashMap，因为它可以作为表格初始化的一部分来动态实现。
在JSP本身中相应的技巧部分为：
<!-- Copyright 2004, James M Turner. All Rights Reserved --> <%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %> <%@ taglib uri="/WEB-INF/struts-html-el.tld" prefix="html-el" %> <%@ taglib uri="/WEB-INF/struts-tiles.tld" prefix="tiles" %> <%@ taglib uri="/WEB-INF/c.tld" prefix="c" %> <%@ taglib prefix="fmt" uri="/WEB-INF/fmt.tld" %> <head> <title>Star Wars Actor Fact Page</title> </head> <H1><center>Start Wars Actor Fact Page</title> <html:form action="/processHashActorComments" > <table border="1" width="80%"> <tr><th>Last Name</th><th>First Name</th> <th>Date of Birth</th><th>Comment</th></tr> <c:forEach var="people" items="${dynamicHashmapForm.map.people}"> <tr><td><c:out value="${people.value.lastName}"/></td> <td><c:out value="${people.value.firstName}"/></td> <td><c:out value="${people.value.dateOfBirth}"/></td> <td><html-el:text property="comments(${people.value.lastName}, ${people.value.firstName})" /></td> </tr> </c:forEach> </table> <P/> <html:submit value="Update Comments"/> </html:form> |
记住：在初始化时填充的HashMap 值，只要表格显示就会消失，因为表格是请求范围的，而不是会话期范围的。特别是对于我们来说这就意味着所有的Person 对象都会消失。所以，如果我们粘贴文本域到Person bean 的注释属性上，在提交表格时我们将得到一个空的指针异常，因为Person 对象不再位于HashMap 内(实际上，我们得到的是一个全新的空的HashMap.)。所以，我们需要将注释存储在一个单独的并行HashMap 内，它将注释当作简单的字符串来存储。
在上述的代码中还须注意几件事情。首先，因为现在正迭代HashMap条，来自c:forEach 标记的值实际上是用于堆栈条的占位符，同时具有两个属性。key 属性的值用来访问堆栈（在我们的例子中如字符"1", "2", "3"等等），value 属性的值存储在关键字之下。所以，在这种情况下，我们必须使用value 属性来得到Person bean 的实属性。
而且，我们需要构造一个用于文本框的有效的Struts属性域。在html-el 标记库中使用JSTL 扩展就可以实现。在这种情况下，我们通过一个由演员的最后一个名字、逗号和第一个名字组成的字符串来存储注释。
最后，我们需要一个新的动作来处理结果：
package demo; /** * Copyright 2004, James M. Turner. * All Rights Reserved * * A Struts action that sends the new comments to the console */ import java.io.IOException; import java.util.HashMap; import java.util.Iterator; import javax.servlet.ServletException; import javax.servlet.http.*; import org.apache.struts.action.*; import org.apache.struts.validator.DynaValidatorForm; public class ProcessHashFormAction extends Action { public ActionForward execute(ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { DynaValidatorForm df = (DynaValidatorForm) form; HashMap hm = (HashMap) df.get("comments"); Iterator it = hm.keySet().iterator(); while (it.hasNext()) { String key = (String) it.next(); String comment = (String) hm.get(key); System.out.println(key + ":" + comment); } return mapping.findForward("success"); } } |
同样，这里最大的差别是数据都是作为HashMaps 来存储的。代码获取关键字(lastname,firstname)，然后显示关键字和在控制台注释:
Fisher,Carrie:Leia
Ford,Harrison:Han
Hamill,Mark:Luke
请注意，当控制返回到JSP页时，打印一个空白表格。这是因为我们在初始化操作中创建的HashMap 已经没有了，在处理结果时我们不能重新创建它。你可以将该数据保存在会话期变量中，但是接着你要返回到你使用第一个方案的地方。最好是选择一个关键字，在表格提交时它可以允许你在后台对象上获得，并且能够总是重新创建需要的任何其他的表格数据。
哪种方式更好？基于排列的方案允许你将所有的数据都保存在一个bean 内，而基于堆栈的方法避免了任何会话期范围的数据。你觉得哪种方案最好就采用哪种。
注意：包含运行这些例子所需的所有代码和库的WAR 文件在http://www.blackbear.com/struts.war.上可以找到。
关于作者:James Turner 是Benefit Systems有限公司软件开发总监。他对Apache Struts 项目颇有贡献。他已经出版了两本面向WEB的JAVA技术的书：MySQL and JSP Web Applications, 和Struts Kick Start。他的第三本书，Java Server Faces Kick Start，在2003年冬季由Sams出版发行