概述
在低版本的Spring中，你必須通過JSTL或<spring:bind>將表單對象綁定到HTML表單頁面中，對于習慣了Struts表單標簽的開發者來說，Spring MVC的這一表現確實讓人失望。不過這一情況已經一去不復返了，從Spring 2.0開始，Spring MVC開始全面支持表單標簽，通過Spring MVC表單標簽，我們可以很容易地將控制器相關的表單對象綁定到HTML表單元素中。
在上一篇文章《Spring MVC的表單控制器》中（http://tech.it168.com/j/2007-07-26/200707261434046.shtml）我們已經使用到了部分的Spring MVC表單標簽，在本文中我們將對Spring MVC表單標簽進行全面的介紹，讓我們首先從<form:form>標簽開始吧。
form標簽
和使用任何JSP擴展標簽一樣，在使用Spring表單標簽之前，你必須在JSP頁面中添加一行引用Spring表單標簽的聲明，如下所示：
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ taglib prefix="form" uri="http://www.springframework.org/tags/form"%> ①引入標簽的聲明
<html>
… ②聲明后，在頁面中就可以使用任意Spring表單標簽了
</html>
一般情況下，我們使用“form”作為Spring MVC表單標簽的前綴，當然只要愿意，你可以調整為其它的前綴名。在聲明好標簽引用后，就可以在該JSP文件中使用所有Spring MVC的表單標簽了。下面是一個使用<form:form>表單標簽的示例，它將最終生成一個HTML的 form表單：
<form:form>
用戶名：<form:input path="userName" /> <br>
密 碼：<form:password path="password" /><br>
Email：<form:input path="email" /><br>
<input type="submit" value="注冊" name="testSubmit"/>
<input type="reset" value="重置" />
</form:form>
回憶一下我們在《Spring MVC的表單控制器》（http://tech.it168.com/j/2007-07-26/200707261434046.shtml）文章中介紹的用戶注冊表單控制器，用戶通過GET請求調用表單控制器時，表單控制器生成一個新的表單對象，然后重定向到表單輸入頁面。正因為表單頁面是通過訪問表單控制器導向過來的，所以<form:form>標簽本身無需做額外的設置就可以達到以下兩個目標：
1) 它不需要象HTML的<form>標簽或Struts的表單標簽一樣通過action屬性指定表單提交的地址。假設和<form:form>標簽對應的控制器的URL是“/registerUser.html”，應用部署目錄為“baobaotao”，則最后產生的HTML代碼自動包含表單提交地址：
<form id="command" method="post" action="/baobaotao//registerUser.html">…</form>
2) <form:form>標簽內部的組件標簽（如<form:input>、<form:password>等）可以直接和表單控制器所對應的表單對象進行值綁定。
默認情況下，表單控制器將表單對象以“command”為名放到PageContext中，你可以通過表單控制器commandName屬性的設置使用其它的名字（假設設置為“user”），這時你必須通過<form:form commandName="user">顯式指定綁定的表單對象名稱。
除了commandName屬性外，Spring表單標簽擁有豐富的可設置屬性，這些屬性大都是HTML表單標簽屬性的鏡像，如onclick、ondblclick、tabindex等等。需要注意的一點是這些屬性都是小寫的，而對應的HTML標簽的屬性則沒有這個限制。但是有幾個和HTML標簽有區別的屬性，我們通過表 1進行說明：
表 1 表單元素標簽特殊屬性
|
目錄
|
說明
|
|
cssClass
|
使用該屬性指定表單元素CSS樣式名，相當于HTML元素的class屬性。示例：<form:input path="userName" cssClass="inputStyle"/>。
|
|
cssStyle
|
直接通過該屬性指定樣式，相當于HTML元素的style屬性。示例：
<form:input path="userName" cssStyle="width:100px"/>。
|
|
cssErrorClass
|
cssClass表示表單元素未發生錯誤時對應的樣式，而cssErrorClass表示表單元素發生錯誤時對應的樣式，示例：
|
輸入組件標簽
表單中有一些用于接受輸入值的組件，如單行文本框、多行文本框以及密碼框，Spring為它們提供了對應的表單標簽，請看下面的例子：
代碼清單 1 使用輸入組件標簽的表單
<form:form>
用戶名：<form:input path="userName" /> <br> ①單行文件框標簽
密 碼：<form:password path="password" /><br> ②密碼框標簽
描 述：<form:textarea path="desc" cols="20" rows="3"/><br> ③多行文件框標簽
<form:hidden path="times"/> ④隱藏組件的值
<input type="submit" value="注冊" name="testSubmit"/>
<input type="reset" value="重置" />
</form:form>
正如你看到的，所有表單組件標簽都通過path屬性綁定表單對象的屬性值，它支持級聯屬性，比如path="user.userName"將調用表單對象getUser.getUserName()綁定表單對象的屬性值。這些表單組件標簽擁有大多數HTML組件標簽的鏡像屬性，如③處的<form:textarea>就使用了cols和rows屬性設定列數和行數。
以上使用表單標簽的頁面的對應HTML頁面如下所示：
<form id="command" method="post" action="/baobaotao//registerUser.html">
用戶名：<input id="userName" name="userName" type="text" value=""/><br>
密 碼： <input id="password" name="password" type="password" value=""/><br>
描 述：<textarea id="desc" name="desc" rows="3" cols="20"></textarea><br>
<input id="times" name="times" type="hidden" value="0"/>
<input type="submit" value="注冊" name="testSubmit"/>
<input type="reset" value="重置" />
</form>
單選框和復選框組件標簽
單選框和復選框組件雖然在HTML中都對應<input>元素標簽，但在Spring MVC表單標簽中，它們分別對應兩個更達意的標簽：
<form:radiobutton>和<form:checkbox>。
radiobutton
單選框組件由兩個同名的標簽組件組成，當表單對象對應屬性值和value值相等時，單選框選中。下面是一個代表性別的單選框：
<form:form>
性 別：<form:radiobutton path="sex" value="0"/>男
<form:radiobutton path="sex" value="1"/>女
</form:form>
當表單對象的sex屬性為0時（可以是String、int等可以自動轉換為String的類型），所生成的HTML代碼如下所示：
<form id="command" method="post" action="/baobaotao//registerUser.html">
性 別：<input id="sex1" name="sex" type="radio" value="0" checked="checked"/>男
<input id="sex2" name="sex" type="radio" value="1"/>女
</form>
checkbox
復選框組件標簽相對來說復雜一些，復選框組件對應的表單屬性不但可以boolean類型，還可以是String[]、Collection，Enum等類型。針對不同屬性類型，復選框的選中狀態的判斷條件是不一樣的：
? boolean類型：當對應屬性為true時，該復選框選中（一個屬性僅對應一個復選框）；
? String[]、Collection或Enum類型：復選框對應值出現在對應屬性列表中，該復選框選中；
? 其它類型：當復選框對應的值可以轉換為對應屬性值，該復選框選中。
假設用戶注冊的User表單對象包含了一個List類型的favorites屬性：
import java.util.List;
public class User {
private List favorites;
public List getFavorites() {
return favorites;
}
public void setFavorites(List favorites) {
this.favorites = favorites;
}
}
我們希望將其在頁面中使用一個復選框組件綁定這個屬性，則可以使用以下的代碼：
代碼清單 2 復選框標簽的使用
<form:form>
興趣愛好：
<form:checkbox path="favorites" value="1"/>computer
<form:checkbox path="favorites" value="2"/>sport
<form:checkbox path="favorites" value="3"/>entertainment
<form:checkbox path="favorites" value="4"/>literature
</form:form>
除了正常的path屬性名外，還必須提供一個value屬性，假設User表單對象的favorites屬性包括了1和3的值，那么產生的HTML頁面為：
<form id="command" method="post" action="/baobaotao//registerUser.html">
興趣愛好：<input id="favorites1" name="favorites" type="checkbox" value="1" checked="checked"/>
<input type="hidden" value="1" name="_favorites"/>computer
<input id="favorites2" name="favorites" type="checkbox" value="2" />
<input type="hidden" value="1" name="_favorites"/>sport
<input id="favorites3" name="favorites" type="checkbox" value="3" checked="checked"/>
<input type="hidden" value="1" name="_favorites"/>entertainment
<input id="favorites4" name="favorites" type="checkbox" value="4"/>
<input type="hidden" value="1" name="_favorites"/>literature
</form>
大家可能已經注意到每個復選框組件的后臺都跟著一個隱藏組件，這是因為當HTML頁面中的復選框沒有被選中時，這個復選框的值不會在表單提交時作為HTTP請求參數發送到服務器端，這給Spring的表單數據綁定造成了麻煩——因為無法觸發setFavorites()方法的調用（如果原來已經有值，這個值不會被設置為空）。解決方法就是在每個復選框后面加一個隱藏組件，并且將對應的復選框名字前添加一個下劃線（"_"）作為隱藏組件的名字。這樣一來，你相當于告訴Spring“這個表單中存在這樣一個復選框，我希望表單對象中對應的屬性和這個checkbox的狀態保持一致”。
假設復選框對應的選項在數據庫或配置文件中定義，那么頁面復選框標簽就不能通過硬編碼的方式指定，相反必須根據配置的選項數據動態產生。對于這樣的需求，代碼清單 2的編寫方式顯然不能滿足需求?；貞浺幌卤韱慰刂破鞯墓ぷ髁鞒?，我們知道可以通過復寫referenceData()方法在表單顯示前準備一些需要的數據，現在終于派上用場了，來看一下具體的實現：
代碼清單 3 UserRegisterController：準備表單顯示數據
package com.baobaotao.web.user;
…
import org.springframework.ui.ModelMap;
public class UserRegisterController extends SimpleFormController {
private BbtForum bbtForum;
①創建初始表單對象
protected Object formBackingObject(HttpServletRequest request)
throws Exception {
int userId = ServletRequestUtils.getIntParameter(request, "userId",-1);
User user = bbtForum.getUser(userId);
user.setUserName("tom");
List favorites = new ArrayList();①-1默認選中值為1和3的選項
favorites.add("1");
favorites.add("3");
user.setFavorites(favorites);
return user;
}
@Override ②準備表單顯示時需要的數據
protected Map referenceData(HttpServletRequest request) throws Exception {
Map favoriteMap = new LinkedHashMap();
favoriteMap.put("1", "computer");
favoriteMap.put("2", "sport");
favoriteMap.put("3", "entertainment");
favoriteMap.put("4", "literature");
②-1將表單頁面需要的對象以ModelMap返回，最終將以屬性名值對方式出現在請求屬性中
return new ModelMap().addObject("favoriteMap", favoriteMap);
}
@Override
protected ModelAndView onSubmit(Object command, BindException errors)
throws Exception {
User user = (User) command;
bbtForum.registerUser(user);
return new ModelAndView(getSuccessView(), "user", user);
}
}
posted on 2009-06-26 11:01
Alpha 閱讀(23981)
評論(4) 編輯 收藏 所屬分類:
Spring