使用Spring MVC表单标签

使用SpringMVC表单标签

关键字:ViewController切面编程观察者模式JOTM

使用SpringMVC表单标签。

概述

在低版本的Spring中,你必须通过JSTL或<spring:bind>将表单对象绑定到HTML表单页面中,对于习惯了Struts表单标签的开发者来说,SpringMVC的这一表现确实让人失望。不过这一情况已经一去不复返了,从Spring2.0开始,SpringMVC开始全面支持表单标签,通过SpringMVC表单标签,我们可以很容易地将控制器相关的表单对象绑定到HTML表单元素中。

在上一篇文章《SpringMVC的表单控制器》中(http://tech.it168.com/j/2007-07-26/200707261434046.shtml)我们已经使用到了部分的SpringMVC表单标签,在本文中我们将对SpringMVC表单标签进行全面的介绍,让我们首先从<form:form>标签开始吧。

form标签

和使用任何JSP扩展标签一样,在使用Spring表单标签之前,你必须在JSP页面中添加一行引用Spring表单标签的声明,如下所示:

<%@pagelanguage="java"contentType="text/html;charset=UTF-8"pageEncoding="UTF-8"%>

<%@taglibprefix="form"uri="http://www.springframework.org/tags/form"%>①引入标签的声明

<html>

…②声明后,在页面中就可以使用任意Spring表单标签了

</html>  一般情况下,我们使用“form”作为SpringMVC表单标签的前缀,当然只要愿意,你可以调整为其它的前缀名。在声明好标签引用后,就可以在该JSP文件中使用所有SpringMVC的表单标签了。下面是一个使用<form:form>表单标签的示例,它将最终生成一个HTML的form表单: <form:form>

用户名:<form:inputpath="userName"/><br>

密码:<form:passwordpath="password"/><br>

Email:<form:inputpath="email"/><br>

<inputtype="submit"value="注册"name="testSubmit"/>

<inputtype="reset"value="重置"/>

</form:form>

回忆一下我们在《SpringMVC的表单控制器》(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代码自动包含表单提交地址:

<formid="command"method="post"action="/baobaotao//registerUser.html">…</form>

2)<form:form>标签内部的组件标签(如<form:input>、<form:password>等)可以直接和表单控制器所对应的表单对象进行值绑定。

默认情况下,表单控制器将表单对象以“command”为名放到PageContext中,你可以通过表单控制器commandName属性的设置使用其它的名字(假设设置为“user”),这时你必须通过<form:formcommandname="user">显式指定绑定的表单对象名称。

除了commandName属性外,Spring表单标签拥有丰富的可设置属性,这些属性大都是HTML表单标签属性的镜像,如onclick、ondblclick、tabindex等等。需要注意的一点是这些属性都是小写的,而对应的HTML标签的属性则没有这个限制。但是有几个和HTML标签有区别的属性,我们通过表1进行说明:

表1表单元素标签特殊属性

目录说明

cssClass使用该属性指定表单元素CSS样式名,相当于HTML元素的class属性。示例:<form:inputpath="userName"cssclass="inputStyle"/>。

cssStyle直接通过该属性指定样式,相当于HTML元素的style属性。示例:

<form:inputpath="userName"cssstyle="width:100px"/>。

cssErrorClasscssClass表示表单元素未发生错误时对应的样式,而cssErrorClass表示表单元素发生错误时对应的样式,示例:

<form:inputpath="userName"cssclass="sty1"cssErrorclass="sty2"/>

输入组件标签

表单中有一些用于接受输入值的组件,如单行文本框、多行文本框以及密码框,Spring为它们提供了对应的表单标签,请看下面的例子:

代码清单1使用输入组件标签的表单

<form:form>

用户名:<form:inputpath="userName"/><br>①单行文件框标签

密码:<form:passwordpath="password"/><br>②密码框标签

描述:<form:textareapath="desc"cols="20"rows="3"/><br>③多行文件框标签

<form:hiddenpath="times"/>④隐藏组件的值

<inputtype="submit"value="注册"name="testSubmit"/>

<inputtype="reset"value="重置"/>

</form:form>

正如你看到的,所有表单组件标签都通过path属性绑定表单对象的属性值,它支持级联属性,比如path="user.userName"将调用表单对象getUser.getUserName()绑定表单对象的属性值。这些表单组件标签拥有大多数HTML组件标签的镜像属性,如③处的<form:textarea>就使用了cols和rows属性设定列数和行数。

以上使用表单标签的页面的对应HTML页面如下所示:

<formid="command"method="post"action="/baobaotao//registerUser.html">

用户名:<inputid="userName"name="userName"type="text"value=""/><br>

密码:<inputid="password"name="password"type="password"value=""/><br>

描述:<textareaid="desc"name="desc"rows="3"cols="20"></textarea><br>

<inputid="times"name="times"type="hidden"value="0"/>

<inputtype="submit"value="注册"name="testSubmit"/>

<inputtype="reset"value="重置"/>

</form>

单选框和复选框组件标签

单选框和复选框组件虽然在HTML中都对应<input>元素标签,但在SpringMVC表单标签中,它们分别对应两个更达意的标签:  

<form:radiobutton>和<form:checkbox>。

radiobutton

单选框组件由两个同名的标签组件组成,当表单对象对应属性值和value值相等时,单选框选中。下面是一个代表性别的单选框:

<form:form>

性别:<form:radiobuttonpath="sex"value="0"/>男

<form:radiobuttonpath="sex"value="1"/>女

</form:form>

当表单对象的sex属性为0时(可以是String、int等可以自动转换为String的类型),所生成的HTML代码如下所示:

<formid="command"method="post"action="/baobaotao//registerUser.html">

性别:<inputid="sex1"name="sex"type="radio"value="0"checked="checked"/>男

<inputid="sex2"name="sex"type="radio"value="1"/>女

</form>checkbox

复选框组件标签相对来说复杂一些,复选框组件对应的表单属性不但可以boolean类型,还可以是String[]、Collection,Enum等类型。针对不同属性类型,复选框的选中状态的判断条件是不一样的:

boolean类型:当对应属性为true时,该复选框选中(一个属性仅对应一个复选框);

String[]、Collection或Enum类型:复选框对应值出现在对应属性列表中,该复选框选中;

其它类型:当复选框对应的值可以转换为对应属性值,该复选框选中。

假设用户注册的User表单对象包含了一个List类型的favorites属性:

importjava.util.List;

publicclassUser{

privateListfavorites;

publicListgetFavorites(){

returnfavorites;

}

publicvoidsetFavorites(Listfavorites){

this.favorites=favorites;

}

}

我们希望将其在页面中使用一个复选框组件绑定这个属性,则可以使用以下的代码:

代码清单2复选框标签的使用

<form:form>

兴趣爱好:

<form:checkboxpath="favorites"value="1"/>computer

<form:checkboxpath="favorites"value="2"/>sport

<form:checkboxpath="favorites"value="3"/>entertainment

<form:checkboxpath="favorites"value="4"/>literature

</form:form>

除了正常的path属性名外,还必须提供一个value属性,假设User表单对象的favorites属性包括了1和3的值,那么产生的HTML页面为:

<formid="command"method="post"action="/baobaotao//registerUser.html">

兴趣爱好:<inputid="favorites1"name="favorites"type="checkbox"value="1"checked="checked"/>

<inputtype="hidden"value="1"name="_favorites"/>computer

<inputid="favorites2"name="favorites"type="checkbox"value="2"/>

<inputtype="hidden"value="1"name="_favorites"/>sport

<inputid="favorites3"name="favorites"type="checkbox"value="3"checked="checked"/>

<inputtype="hidden"value="1"name="_favorites"/>entertainment

<inputid="favorites4"name="favorites"type="checkbox"value="4"/>

<inputtype="hidden"value="1"name="_favorites"/>literature

</form>

大家可能已经注意到每个复选框组件的后台都跟着一个隐藏组件,这是因为当HTML页面中的复选框没有被选中时,这个复选框的值不会在表单提交时作为HTTP请求参数发送到服务器端,这给Spring的表单数据绑定造成了麻烦——因为无法触发setFavorites()方法的调用(如果原来已经有值,这个值不会被设置为空)。解决方法就是在每个复选框后面加一个隐藏组件,并且将对应的复选框名字前添加一个下划线("_")作为隐藏组件的名字。这样一来,你相当于告诉Spring“这个表单中存在这样一个复选框,我希望表单对象中对应的属性和这个checkbox的状态保持一致”。

假设复选框对应的选项在数据库或配置文件中定义,那么页面复选框标签就不能通过硬编码的方式指定,相反必须根据配置的选项数据动态产生。对于这样的需求,代码清单2的编写方式显然不能满足需求。回忆一下表单控制器的工作流程,我们知道可以通过复写referenceData()方法在表单显示前准备一些需要的数据,现在终于派上用场了,来看一下具体的实现:

代码清单3UserRegisterController:准备表单显示数据

packagecom.baobaotao.web.user;

importorg.springframework.ui.ModelMap;

publicclassUserRegisterControllerextendsSimpleFormController{

privateBbtForumbbtForum;

①创建初始表单对象

protectedObjectformBackingObject(HttpServletRequestrequest)

throwsException{

intuserId=ServletRequestUtils.getIntParameter(request,"userId",-1);

Useruser=bbtForum.getUser(userId);

user.setUserName("tom");

Listfavorites=newArrayList();①-1默认选中值为1和3的选项

favorites.add("1");

favorites.add("3");

user.setFavorites(favorites);

returnuser;

}

@Override②准备表单显示时需要的数据

protectedMapreferenceData(HttpServletRequestrequest)throwsException{

MapfavoriteMap=newLinkedHashMap();

favoriteMap.put("1","computer");

favoriteMap.put("2","sport");

favoriteMap.put("3","entertainment");

favoriteMap.put("4","literature");

②-1将表单页面需要的对象以ModelMap返回,最终将以属性名值对方式出现在请求属性中

returnnewModelMap().addObject("favoriteMap",favoriteMap);

}

@Override

protectedModelAndViewonSubmit(Objectcommand,BindExceptionerrors)

throwsException{

Useruser=(User)command;

bbtForum.registerUser(user);

returnnewModelAndView(getSuccessView(),"user",user);

}

}

在以上代码中我们覆盖了SimpleFormController的referenceData()和formBackingObject()方法。参照《SpringMVC的表单控制器》中(http://tech.it168.com/j/2007-07-26/200707261434046.shtml)介绍的表单控制器工作流程,可以知道formBackingObject()方法用于表单页面初始化时使用的表单对象。我们在formBackingObject()方法中,将User的favorites属性的初始值设置为1和3(分别对应computer和entertainment的选项),如①所示。

在②处,我们覆盖了referenceData()方法,该方法为表单页面准备一些数据。该方法返回值类型为Map,该Map的键值将会绑定到请求的属性中。ModelMap是Spring2.0新增的Map实现类,它提供了链式方法和默认键值的机制。这里,我们使用ModelMap绑定了一个键为“favoriteMap”,值为favoriteMap的数据对象。favoriteMap是所有兴趣爱好的选项,在实际的应用中,你可以从数据库中或配置文件中进行加载。

当请求中绑定了favoriteMap时,对应的表单页面就可以遍历该Map并动态构造出复选框列表了:  

<%@pagelanguage="java"contentType="text/html;charset=UTF-8"pageEncoding="UTF-8"%>

<%@taglibprefix="form"uri="http://www.springframework.org/tags/form"%>

<%@tagliburi="http://java.sun.com/jsp/jstl/core"prefix="c"%>

<html>

<head>

<title>宝宝淘论坛用户注册</title>

</head>

<body>

<form:form>

兴趣爱好:

<c:forEachitems="${favoriteMap}"var="favorite">①引用favoriteMap的请求属性

②引用Map的键和值

<form:checkboxpath="favorites"value="${favorite.key}"/>${favorite.value}

</c:forEach>

<inputtype="submit"value="注册"name="testSubmit"/>

<inputtype="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:selectpath="city"items="${cityList}"/>,它包括两方面的数据:1)对应表单对象属性值(city);2)用于构造整个下拉框选项的数据(cityList)。严格地说,下拉框组件分为单选和多选两种形式,当表单对象对应属性为复数形态的类型时(如String[]、List、Set),产生的目标组件为多选下拉框,反之为单选下拉框。

用于构造下拉框选项的数据也必须在referenceData()方法中准备好(可能从数据库字典表中加载或从外部配置文件中加载):

代码清单4UserRegisterController:为下拉框标签准备数据

packagecom.baobaotao.web.user;

publicclassUserRegisterControllerextendsSimpleFormController{

@Override

protectedMapreferenceData(HttpServletRequestrequest)throwsException{

MapfavoriteMap=newLinkedHashMap();

favoriteMap.put("1","computer");

favoriteMap.put("2","sport");

favoriteMap.put("3","entertainment");

favoriteMap.put("4","literature");

ListcityList=newArrayList();①为下拉框选项准备的数据

cityList.add("北京");

cityList.add("上海");

cityList.add("天津");

cityList.add("厦门");

returnnewModelMap()

.addObject("favoriteMap",favoriteMap)

.addObject("cityList",cityList);

}

}

这时,生成的下拉框HTML代码如下所示:

<selectid="city"name="city">①

<optionvalue="北京">北京</option>

<optionvalue="上海">上海</option>

<optionvalue="天津">天津</option>

<optionvalue="厦门">厦门</option>

</select>

<inputtype="hidden"name="_city"value="1"/>②

首先,我们注意到②处有一个和复选框组件相似的配套隐藏组件,之所以会需要这个隐藏组件是出于和复选框相同的原因。下拉框的值和标签是相同的,都是cityList列表中的元素值。在实际应用中,我们一般为每一个选项提供一个代码,而非采用和标签相同的值,这样可以使用规范简短的代码保存数据,为后续的查询、引用带来方便。这时,可以采用下拉框标签的另一种属性设置方式:

<form:selectpath="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:selectpath="city"items="${cities}"itemValue="code"itemLabel="name"/>

cities对应一个通过referenceData()方法准备好的List对象,其元素为City对象,City对象包括code和name两个属性。通过以上这些方式,我们可以得到一个选项的值和标签不相同的下拉框:

<selectid="city"name="city">

<optionvalue="1">北京</option>

<optionvalue="2">上海</option>

<optionvalue="3">天津</option>

<optionvalue="4">厦门</option>

</select>

<inputtype="hidden"name="_city"value="1"/>

一般情况下,下拉框会提供一个类似于“请选择”或“--未选择--”的默认选项,这个选项本身不是有效的数据项,它们的存在仅仅为提示用户作选择或代表一个未作选择的空值。这时,我们可能会考虑手工提供一个下拉框选项,而其它的选项通过referenceData()提供的数据动态生成:

<form:selectpath="city">

<form:optionvalue=""label="--请选择--"/>①提示性的选项

<form:optionsitems="${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:inputpath="userName"cssclass="inputStyle"cssErrorclass="asdfe"/>

<fontcolor="red"><form:errorspath="userName"/></font>

<br>

密码:<form:passwordpath="password"/>

<fontcolor="red"><form:errorspath="password"/></font>

<br>

</form:form>

通过path和表单对象特定属性错误信息进行绑定,一个表单对象属性可能包括一个或多个错误信息,也可以没有错误信息,<form:errors>会根据错误信息的情况进行合理的展示。此外,path还支持通配符匹配的表示方式:

path="*":显示所有的错误信息;

path="lastName*":显示所有属性名前缀为lastName的错误信息。

小结

在Spring2.0中,新增的表单标签是SpringMVC的一个显著的升级,它可以绑定服务端的表单对象,让页面数据的渲染工作变得轻松。因为SpringMVC框架本身的优越性,使得许多SpringMVC表单标签无需进行过多的属性设置就可以正确使用,因此相比于Struts的表单标签,SpringMVC在使用上更加方便,更加轻松。

链接地址:豆豆网:http://tech.ddvip.com/2008-12/122846658597754.html

相关推荐