使用Spring MVC表单标签二
2008-10-14 23:17
288 查看
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：准备表单显示数据
在以上代码中我们覆盖了SimpleFormController的referenceData()和formBackingObject ()方法。参照《Spring MVC的表单控制器》中（http://tech.it168.com/j/2007-07-26/200707261434046.shtml）介绍的表单控制器工作流程，可以知道formBackingObject()方法用于表单页面初始化时使用的表单对象。我们在formBackingObject()方法中，将User的favorites属性的初始值设置为1和3（分别对应computer和entertainment的选项），如①所示。
在②处，我们覆盖了referenceData()方法，该方法为表单页面准备一些数据。该方法返回值类型为Map，该Map的键值将会绑定到请求的属性中。ModelMap是Spring 2.0新增的Map实现类，它提供了链式方法和默认键值的机制。这里，我们使用ModelMap绑定了一个键为“favoriteMap”，值为favoriteMap的数据对象。favoriteMap是所有兴趣爱好的选项，在实际的应用中，你可以从数据库中或配置文件中进行加载。
当请求中绑定了favoriteMap时，对应的表单页面就可以遍历该Map并动态构造出复选框列表了：
在①处，我们通过JSTL标签对属性名为favoriteMap的模型数据对象进行遍历，为每一个元素项生成一个复选框。注意②处的复选框代码，它有两个明显的特征：1)使用Spring复选框标签；2)通过EL引用Map类型的模型数据。由于favorite是Map类型，所以我们可以通过${favorite.key}和${favorite.value}引用Map元素的键和值。
提示：
对于同时使用JSTL和Spring表单标签的JSP文件，JSTL的标签会被首先解析，然后再解析Spring表单标签，因此如实例那样混合使用二者可以如预期一样输出正确的结果。
下拉框组件标签
下拉框标签的典型形式为： <form.:select path="city" items="${cityList}"/>，它包括两方面的数据：1)对应表单对象属性值（city）；2)用于构造整个下拉框选项的数据(cityList)。严格地说，下拉框组件分为单选和多选两种形式，当表单对象对应属性为复数形态的类型时（如String[]、List、Set），产生的目标组件为多选下拉框，反之为单选下拉框。
用于构造下拉框选项的数据也必须在referenceData()方法中准备好（可能从数据库字典表中加载或从外部配置文件中加载）：
代码清单 4 UserRegisterController：为下拉框标签准备数据
首先，我们注意到②处有一个和复选框组件相似的配套隐藏组件，之所以会需要这个隐藏组件是出于和复选框相同的原因。下拉框的值和标签是相同的，都是cityList列表中的元素值。在实际应用中，我们一般为每一个选项提供一个代码，而非采用和标签相同的值，这样可以使用规范简短的代码保存数据，为后续的查询、引用带来方便。这时，可以采用下拉框标签的另一种属性设置方式：
<form.:select path="city" items="${cityMap}" itemValue="key" itemLabel="value"/>
cityMap是一个已经通过referenceData()方法准备好的Map对象，itemValue对应下拉框的value属性，而itemValue="key"表示使用cityMap元素的键，itemLable对应下拉框的标签值， itemLabel="value"表示使用cityMap元素的值。实际上，items属性所绑定的也可以是一个List对象，其元素可以是一个JavaBean，这时可以通过itemValue和itemLabel指定引用JavaBean的属性。如下所示：
<form.:select path="city" items="${cities}" itemValue="code" itemLabel="name"/>
cities对应一个通过referenceData()方法准备好的List对象，其元素为City对象，City对象包括code和name两个属性。通过以上这些方式，我们可以得到一个选项的值和标签不相同的下拉框：
<select id="city" name="city">
<option value="1">北京</option>
<option value="2">上海</option>
<option value="3">天津</option>
<option value="4" >厦门</option>
</select>
<input type="hidden" name="_city" value="1"/>
一般情况下，下拉框会提供一个类似于“请选择”或“--未选择--”的默认选项，这个选项本身不是有效的数据项，它们的存在仅仅为提示用户作选择或代表一个未作选择的空值。这时，我们可能会考虑手工提供一个下拉框选项，而其它的选项通过referenceData()提供的数据动态生成：
<form.:select path="city">
<form.:option value="" label="--请选择--"/> ①提示性的选项
<form.:options items="${cityMap}" itemValue="key" itemLabel="value"/>②真实的选项数据
</form.:select>
这样产生的下拉框在默认情况下将显示①处对应的选项，如果用户没有选择，选项相当于是一个空值。②处对应的<form.:options>会将cityMap的数据转换为下拉框选项列表。
错误标签
错误标签是和服务端校验信息关联的对应物，假设在服务端通过以下代码对表单数据进行校验：
ValidationUtils.rejectIfEmptyOrWhitespace(errors, "userName","required.username", "用户名必须填写");
ValidationUtils.rejectIfEmptyOrWhitespace(errors, "password","required.password", "密码不能为空");
当提交的表单数据不合法引发校验错误时，提交的表单将被驳回，请求被重定向到表单输入页面，在该页面中通过
通过path和表单对象特定属性错误信息进行绑定，一个表单对象属性可能包括一个或多个错误信息，也可以没有错误信息，<form.:errors>会根据错误信息的情况进行合理的展示。此外，path还支持通配符匹配的表示方式：
path="*"： 显示所有的错误信息；
path="lastName*"： 显示所有属性名前缀为lastName的错误信息。
小结
在Spring 2.0中，新增的表单标签是Spring MVC的一个显著的升级，它可以绑定服务端的表单对象，让页面数据的渲染工作变得轻松。因为Spring MVC框架本身的优越性，使得许多Spring MVC表单标签无需进行过多的属性设置就可以正确使用，因此相比于Struts的表单标签，Spring MVC在使用上更加方便，更加轻松。
复选框组件标签相对来说复杂一些，复选框组件对应的表单属性不但可以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);
}
}在以上代码中我们覆盖了SimpleFormController的referenceData()和formBackingObject ()方法。参照《Spring MVC的表单控制器》中（http://tech.it168.com/j/2007-07-26/200707261434046.shtml）介绍的表单控制器工作流程，可以知道formBackingObject()方法用于表单页面初始化时使用的表单对象。我们在formBackingObject()方法中，将User的favorites属性的初始值设置为1和3（分别对应computer和entertainment的选项），如①所示。
在②处，我们覆盖了referenceData()方法，该方法为表单页面准备一些数据。该方法返回值类型为Map，该Map的键值将会绑定到请求的属性中。ModelMap是Spring 2.0新增的Map实现类，它提供了链式方法和默认键值的机制。这里，我们使用ModelMap绑定了一个键为“favoriteMap”，值为favoriteMap的数据对象。favoriteMap是所有兴趣爱好的选项，在实际的应用中，你可以从数据库中或配置文件中进行加载。
当请求中绑定了favoriteMap时，对应的表单页面就可以遍历该Map并动态构造出复选框列表了：
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ taglib prefix="form" uri="http://www.springframework.org/tags/form"%>
<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%>
<html>
<head>
<title>宝宝淘论坛用户注册</title>
</head>
<body>
<form.:form>
…
兴趣爱好:
<c:forEach items="${favoriteMap}" var="favorite">①引用favoriteMap的请求属性
②引用Map的键和值
<form.:checkbox path="favorites" value="${favorite.key}" />${favorite.value}
</c:forEach>
<input type="submit" value="注册" name="testSubmit"/>
<input type="reset" value="重置" />
</form.:form>
</body>
</html>在①处，我们通过JSTL标签对属性名为favoriteMap的模型数据对象进行遍历，为每一个元素项生成一个复选框。注意②处的复选框代码，它有两个明显的特征：1)使用Spring复选框标签；2)通过EL引用Map类型的模型数据。由于favorite是Map类型，所以我们可以通过${favorite.key}和${favorite.value}引用Map元素的键和值。
提示：
对于同时使用JSTL和Spring表单标签的JSP文件，JSTL的标签会被首先解析，然后再解析Spring表单标签，因此如实例那样混合使用二者可以如预期一样输出正确的结果。
下拉框组件标签
下拉框标签的典型形式为： <form.:select path="city" items="${cityList}"/>，它包括两方面的数据：1)对应表单对象属性值（city）；2)用于构造整个下拉框选项的数据(cityList)。严格地说，下拉框组件分为单选和多选两种形式，当表单对象对应属性为复数形态的类型时（如String[]、List、Set），产生的目标组件为多选下拉框，反之为单选下拉框。
用于构造下拉框选项的数据也必须在referenceData()方法中准备好（可能从数据库字典表中加载或从外部配置文件中加载）：
代码清单 4 UserRegisterController：为下拉框标签准备数据
package com.baobaotao.web.user;
…
public class UserRegisterController extends SimpleFormController {
@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");
List cityList = new ArrayList();①为下拉框选项准备的数据
cityList.add("北京");
cityList.add("上海");
cityList.add("天津");
cityList.add("厦门");
return new ModelMap()
.addObject("favoriteMap", favoriteMap)
.addObject("cityList", cityList);
}
…
}
这时，生成的下拉框HTML代码如下所示：
<select id="city" name="city" > ①
<option value="北京">北京</option>
<option value="上海">上海</option>
<option value="天津">天津</option>
<option value="厦门">厦门</option>
</select>
<input type="hidden" name="_city" value="1"/> ②首先，我们注意到②处有一个和复选框组件相似的配套隐藏组件，之所以会需要这个隐藏组件是出于和复选框相同的原因。下拉框的值和标签是相同的，都是cityList列表中的元素值。在实际应用中，我们一般为每一个选项提供一个代码，而非采用和标签相同的值，这样可以使用规范简短的代码保存数据，为后续的查询、引用带来方便。这时，可以采用下拉框标签的另一种属性设置方式：
<form.:select path="city" items="${cityMap}" itemValue="key" itemLabel="value"/>
cityMap是一个已经通过referenceData()方法准备好的Map对象，itemValue对应下拉框的value属性，而itemValue="key"表示使用cityMap元素的键，itemLable对应下拉框的标签值， itemLabel="value"表示使用cityMap元素的值。实际上，items属性所绑定的也可以是一个List对象，其元素可以是一个JavaBean，这时可以通过itemValue和itemLabel指定引用JavaBean的属性。如下所示：
<form.:select path="city" items="${cities}" itemValue="code" itemLabel="name"/>
cities对应一个通过referenceData()方法准备好的List对象，其元素为City对象，City对象包括code和name两个属性。通过以上这些方式，我们可以得到一个选项的值和标签不相同的下拉框：
<select id="city" name="city">
<option value="1">北京</option>
<option value="2">上海</option>
<option value="3">天津</option>
<option value="4" >厦门</option>
</select>
<input type="hidden" name="_city" value="1"/>
一般情况下，下拉框会提供一个类似于“请选择”或“--未选择--”的默认选项，这个选项本身不是有效的数据项，它们的存在仅仅为提示用户作选择或代表一个未作选择的空值。这时，我们可能会考虑手工提供一个下拉框选项，而其它的选项通过referenceData()提供的数据动态生成：
<form.:select path="city">
<form.:option value="" label="--请选择--"/> ①提示性的选项
<form.:options items="${cityMap}" itemValue="key" itemLabel="value"/>②真实的选项数据
</form.:select>
这样产生的下拉框在默认情况下将显示①处对应的选项，如果用户没有选择，选项相当于是一个空值。②处对应的<form.:options>会将cityMap的数据转换为下拉框选项列表。
错误标签
错误标签是和服务端校验信息关联的对应物，假设在服务端通过以下代码对表单数据进行校验：
ValidationUtils.rejectIfEmptyOrWhitespace(errors, "userName","required.username", "用户名必须填写");
ValidationUtils.rejectIfEmptyOrWhitespace(errors, "password","required.password", "密码不能为空");
当提交的表单数据不合法引发校验错误时，提交的表单将被驳回，请求被重定向到表单输入页面，在该页面中通过
<form.:errors>标签就可以显示出校验的错误信息： <form.:form> 用户名：<form.:input path="userName" cssClass="inputStyle" cssErrorClass="asdfe"/> <font color="red"><form.:errors path="userName" /></font> <br> 密 码：<form.:password path="password" /> <font color="red"><form.:errors path="password" /></font> <br> </form.:form>
通过path和表单对象特定属性错误信息进行绑定，一个表单对象属性可能包括一个或多个错误信息，也可以没有错误信息，<form.:errors>会根据错误信息的情况进行合理的展示。此外，path还支持通配符匹配的表示方式：
path="*"： 显示所有的错误信息；
path="lastName*"： 显示所有属性名前缀为lastName的错误信息。
小结
在Spring 2.0中，新增的表单标签是Spring MVC的一个显著的升级，它可以绑定服务端的表单对象，让页面数据的渲染工作变得轻松。因为Spring MVC框架本身的优越性，使得许多Spring MVC表单标签无需进行过多的属性设置就可以正确使用，因此相比于Struts的表单标签，Spring MVC在使用上更加方便，更加轻松。
内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理 
相关文章推荐
- spring mvc使用@InitBinder 标签对表单数据绑定
- spring mvc使用@InitBinder 标签对表单数据绑定
- spring mvc使用@InitBinder 标签对表单数据绑定
- 关于Spring MVC中的表单标签库的使用
- 使用Spring MVC表单标签
- spring mvc使用@InitBinder 标签对表单数据绑定
- spring mvc使用@InitBinder 标签对表单数据绑定
- spring mvc使用@InitBinder 标签对表单数据绑定
- spring mvc使用@InitBinder 标签对表单数据绑定
- spring mvc使用@InitBinder 标签对表单数据绑定
- spring mvc使用@InitBinder 标签对表单数据绑定
- 使用Spring MVC表单标签
- 关于Spring MVC中的表单标签库的使用
- spring mvc使用@InitBinder 标签对表单数据绑定
- spring mvc使用@InitBinder 标签对表单数据绑定
- Spring mvc使用@InitBinder标签对表单数据绑定
- 关于Spring MVC中的表单标签库的使用
- spring mvc系列文章 - 使用Spring MVC表单标签
- spring mvc中使用spring form标签无法正常提交表单
- spring mvc使用@InitBinder 标签对表单数据绑定