在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出版發行