第3.4式. 在表單中使用索引屬性
問題
你想要在表單中創建對應於一個Bean中的索引屬性的一套輸入字段。
動作要領
在Struts html標籤庫的標籤中使用indexed屬性來產生屬性值：
<html:form action="TestOneAction"><p> <logic:iterate name="MyForm" property="stringArray" id="stringValue" indexId="ctr"> <br/> <html:text property="stringArray" indexed="true"/></logic:iterate></html:form>
動作變化
如第3.3時所示，訪問索引值以供顯示是很容易的。但是，在表單中使用索引屬性則有些麻煩。如果所產生的輸入字段的名稱沒有正確的格式化，在HTML表單被提交後， Apache Struts Web Framework 便不能正確的裝配ActionForm。Struts 要使用Jakarta Commons BeanUtils 包來從HTTP請求中的值組裝ActionForm。特別地，BeanUtils.populate( )方法是從表單提交時從HTTP請求數據發送的數據中裝載ActionForm的。
對於索引值，BeanUtils.populate( )使用請求參數來決定適當的setter 方法以調用ActionForm。表3-3 列出了不同的表單輸入字段是如何處理的。表中列出了HTML 標籤，對應的HTTP 請求響應對，以及在請求被處理時在ActionForm之上調用的方法。
表3-3. ActionForm 組裝示例 | ||
|
HTML form 輸入標記 |
產生的請求對 |
導致的方法調用 |
|
<input type="text" name="bar"> |
bar=someValue |
Form.setBar("someValue") |
|
<input type="text" name="sna.fug"> |
sna.fug=blah |
Form.getSna( ).setFug("blah"); |
|
<input type="text" name="baz[0]"> |
baz[0]=someValue |
Form.setBaz(0,"firstVal"); |
|
<input type="text" name="glub[1].waf"> |
glub[1].waf=halb |
Form.getGlub(1).setWaf("halb"); |
|
<input type="text" name="dog.leg[2]"> |
dog.leg[2]=lame |
Form.getDog( ).setLeg(2, "lame"); |
考慮一個允許用戶輸入最喜愛列表，比如顏色和網站，的表單。持有這些數據的ActionForm包含一個表示用戶名稱的String屬性，表示用戶喜好顏色的String數組，以及一個表示用戶喜好網站的WebLink對象的List。WebLink類如Example 3-5所示，它定義了一個簡單的JavaBean，具有表示站點名稱和URL的屬性。
Example 3-5. WebLink JavaBean
package com.oreilly.strutsckbk;
public class WebLink {
public String getName( ) {
return name;
} public void setName(String name) { this.name = name; } public String getUrl( ) { return url; } public void setUrl(String url) { this.url = url; } private String url; private String name;
}
form bean, FavoritesForm, 則包含了用戶名稱，喜愛顏色，以及喜好網站。如Example 3-6所示：
Example 3-6. FavoritesForm form bean
package com.oreilly.strutsckbk;import java.util.ArrayList;import java.util.List;import org.apache.struts.action.ActionForm;public final class FavoritesForm extends ActionForm { public FavoritesForm( ) { webLinks = new ArrayList( ); for (int i=0; i<5; i++) webLinks.add(new WebLink( )); colors = new String[3]; } public String getName( ) { return name; } public void setName(String name) { this.name = name; } public String getColor(int index) { return colors[index]; } public void setColor(int index, String color) { colors[index] = color; } public String[] getColor( ) { return colors; } public List getWebLinks( ) { return webLinks; } public WebLink getWebLink(int index) { return (WebLink)webLinks.get(index); } public void setWebLink(int index, WebLink webLink) { webLinks.set(index, webLink); } public void reset( ) { webLinks.clear( ); colors = new String[3]; } private List webLinks; private String name; private String[] colors; }
現在你可以創建一個JSP 頁面 (favorites.jsp) ，通過它用戶可以輸入表單中的相應數據，其代碼如Example 3-7所示.
Example 3-7. FavoritesForm JSP
<%@ page contentType="text/html;charset=UTF-8" language="java" %><%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean" %><%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %><%@ taglib uri="/WEB-INF/struts-logic.tld" prefix="logic" %><%@ taglib uri="http://java.sun.com/jstl/core" prefix="c" %><html:html locale="true"><head><title><bean:message key="index.title"/></title><html:base/></head><body bgcolor="white"><h2>Favorites Poll</h2><html:form action="/admin/ViewFavorites"> <p> What is your name: <br/><html:text property="name"/> </p> <p> What are your three favorite colors: <br/><html:text property="color[0]"/> <br/><html:text property="color[1]"/> <br/><html:text property="color[2]"/> </p> <p> What are your favorite links? <table> <tr> <th>Name</th> <th>URL</th> </tr> <tr> <td><html:text property="webLink[0].name"/></td> <td><html:text property="webLink[0].url"/></td> </tr> </table> </p> <html:submit/> <html:reset/></html:form></body></html:html>
因爲Example 3-7 中的索引值是硬編碼，不是動態的，html:text標籤的property值便很容易構造，所以產生的HTML 標籤便具有適當的name屬性值。然而，假設你想要使用logic:iterate標籤來產生重複的輸入字段。比如，爲了對color屬性這樣做，你可能想要嘗試以下的JSP 代碼：
What are your three favorite colors: <logic:iterate name="FavoritesForm" id="theColor"> <br/><html:text property="color" indexed="true"/> </logic:iterate>
但是這段代碼不會產生需要的HTML 標記。indexed屬性對爲特定的Struts html標籤（這裏是html:text）的name屬性所指定的值應用一個索引(即, [n]) 。如果你使用上面的片斷部署了一個JSP ，所產生的HTML可能是下面的樣子：
What are your three favorite colors:<br/><input type="text" name="org.apache.struts.taglib.html.BEAN[0].color" value="[Ljava.lang.String;@5f1ba8"><br/><input type="text" name="org.apache.struts.taglib.html.BEAN[1].color" value="[Ljava.lang.String;@5f1ba8"><br/><input type="text" name="org.apache.struts.taglib.html.BEAN[2].color" value="[Ljava.lang.String;@5f1ba8">
索引並沒有應用到屬性的值。相反，卻被應用到了Form Bean的內部internal Apache Struts Web Framework 名稱。另外，value包含了對數組調用toString( )方法的結果，而不是數組中特定的元素。.
說到底，意思就是當你需要設置一個本身是複雜對象，比如一個JavaBean 的索引屬性的嵌套的簡單屬性時，indexed屬性時很有用的。你可以在logic:iterate標籤中爲一個非嵌套屬性產生輸入字段，但是你卻必須藉助scriptlet 來產生數組索引：
What are your three favorite colors: <logic:iterate name="FavoritesForm" id="theColor" indexId="ctr"> <br/><html:text property='<%="color["+ctr+"]"%>'/> </logic:iterate>
假設你想要使用logic:iterate標籤來爲喜好鏈接(WebLink對象)產生輸入字段。這種情況下，indexed的行爲則正如你願：
What are your favorite links?<table> <tr> <th>Name</th> <th>URL</th> </tr> <logic:iterate id="webLink" name="FavoritesForm" property="webLinks"> <tr> <td><html:text name="webLink" property="name" indexed="true"/></td> <td><html:text name="webLink" property="url" indexed="true"/></td> </tr> </logic:iterate><table>
在html標籤中使用indexed屬性多少有點使人混淆。混淆之處主要來自於name屬性的不同意義。大多數情況下，在使用html標籤時，name都可以忽略因爲值將基於action mapping 中聲明的form-bean。然而，在使用indexed屬性時，name卻引用到對應的ActionForm的嵌套的索引屬性。
我們回去看color屬性的問題，你可以選擇使用scriptlet之外的方式。可以使用Struts html-el標籤或者JSTL。它們都可以做一些和scriptlet相同的基本事情，但是它們是通過EL 表達式來進行的。最簡潔的方法是使用html-el標籤：
What are your three favorite colors: <logic:iterate name="FavoritesForm" id="theColor" indexId="ctr"> <br/><html-el:text property='color[${ctr}]>'/> </logic:iterate>
如你喜歡JSTL，你也可以直接產生需要的輸入標籤而不是使用Struts html標籤：
What are your three favorite colors:<logic:iterate id="color" name="FavoritesForm" property="color" indexId="ctr"> <br/><input type="text" name="color[<c:out value='${ctr}'/>]" value="<c:out value='${FavoritesForm.color[ctr]}'/>"/></logic:iterate>
這個JSTL 版本幾乎和原來使用scriptlet的版本一樣醜陋。另外，因爲Struts html:text和html-el:text標籤都沒使用， HTML input標籤的value屬性必須是顯式編碼的。如果你使用Struts html:text標籤，這個值就是自動設置的。
相關招式
第3.3式討論了在表單之外顯示索引屬性所用的技術。
第3.5式討論如何在JSTL c:forEach循環中使用索引屬性。
Jakarta Commons項目的BeanUtils包定義了索引屬性如何解析。相關信息可訪問：http://jakarta.apache.org/commons/beanutils/api/org/apache/commons/beanutils/package-summary.html#package_description.
[引用提示]阿泠引用了該文章, 地址: http://blog.donews.com/inclear/archive/2005/11/12/624363.aspx