SpringMVC支持表单标签,它可以实现将模型数据中的属性和 HTML 表单元素相绑定,以实现表单数据更便捷编辑和表单值的回显。
一般情况下,通过 GET 请求获取表单页面,而通过POST 请求提交表单页面,因此获取表单页面和提交表单页面的 URL 是相同的。只要满足该最佳条件,<form:form> 标签就无需通过 action 属性指定表单提交的 URL。
我们可以通过 modelAttribute 属性指定绑定的模型属性,若没有指定该属性,则默认从 request 域对象中读取command 的表单 bean,如果该属性值也不存在,则会发生错误。
二、SpringMVC的表单标签详解
1、SpringMVC提供的表单组件标签的共同属性
---path :表单字段,对应html元素的name属性,支持级联属性;
---htmlEscape : 是否对表单值的HTML特殊字符进行转换,默认值为true;
---cssClass : 表单组件对应的CSS样式类名;
---cssErrorClass : 表单组件的数据存在错误时,采取的css样式。
2、SpringMVC使用表单标签设置
首先在jsp中添加form标签的tld:
<%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %>
再为form标签的modelAttribute属性赋值:
<form:form action="testForm" method="POST" modelAttribute="command">
modelAttribute属性指定该form绑定的是哪个Model,当指定了对应的Model后就可以在form标签内部其它表单标签上通过为path指定Model属性的名称来绑定Model中的数据了,method属性指定form的提交方式如GET、POST等。
3、form标签下的表单标签详解
---form:input
示例:
<form:input path="username"/>
会生成一个type为text的Html input标签,通过path属性来指定要绑定的Model中的值。
---form:password
示例:
<form:password path="password"/>
会生成一个type为password的Html input标签,通过path属性来指定要绑定的Model中的值。
---form:hidden
示例:
<form:hidden path="id"/>
会生成一个type为hidden的Html input标签,通过path属性来指定要绑定的Model中的值。
---form:textarea
示例:
<form:textarea path="remark"/>
会生成一个Html textarea标签,通过path属性来指定要绑定的Model中的值。
---form:raidobutton
示例:
<form:radiobutton path="ifno" />
单选框组件标签,当表单bean对应的属性值和value值相等时,单选框被选中。
---form:raidobuttons
delimiter为分隔符
示例:
<form:radiobuttons path="gender" items="${genders}" delimiter=" " />
会根据绑定的items数据生成一组对应的type为radio的Html input标签; 绑定的items数据可以是数组、集合或Map,其中radiobuttons的path属性也必指定; 当path的值和items中的某条数据值相同的时候对应的radio为选定状态,反之为不选定状态,用法和checkboxs很相似; 但要注意的是:checkboxs的path绑定的是集合而radiobuttons的path绑定的是单个值。
---form:checkbox
示例:
<form:checkbox path="names"/>
会生成一个type为checkbox的Html input标签,支持绑定boolean、数组、List或Set类型的数据。
绑定boolean数据会生成一个复选框,当boolean为true该复选框为选定状态,false为不选定状态。
绑定数组、List或Set类型的数据时,如果绑定的数据中有对应checkbox指定的value时则为选定状态,反之为不选定状态。
---form:checkboxs
<form:checkboxes path="selectArray" items="${contentModel.testArray}"/>
会根据绑定的items数据生成一组对应的type为checkbox的Html input标签,绑定的数据可以是数组、集合或Map,其中checkboxs的path属性也必指定,当path中的数据有和items中的数据值同的时候对应的checkbox为选定状态,反之为不选定状态。这里需要注意的是当使用EL表达式绑定时需要连Model的名称一起指定如${contentModel.testArray}而不能像path一样只指定Model对应的属性名称。但通常情况下我们需要的是checkbox显示的是名称,但选择后提交的是对应名称的值,比如id,我们就可以通过绑定Map来实现这个功能:
<form:checkboxes path="selectIds" items="${contentModel.testMap}"/>
---form:select
path :属性;
items:数据;
itemLabel:每一项的名字;
itemValue:选项的值,可为bean的属性
示例:
<form:select path="department.id" items="${departments}" itemLabel="departmentName" itemValue="id"></form:select>
会生成一个Html select标签,绑定的items数据可以是数组、集合或Map会根据items的内容生成select里面的option选项,当path的值和items中的某条数据值相同的时候对应的option为选定状态,反之为不选定状态,用法与radiobuttons很相似。
三、实例演示
假设已经做好了SpringMVC的相关配置
新建一个POJO类
package com.demo.web.models; import java.util.List; import java.util.Map; public class TagsModel { private String username; private String password; private boolean testBoolean; private String[] selectArray; private String[] testArray; private Integer radiobuttonId; private Integer selectId; private List<Integer> selectIds; private Map<Integer, String> testMap; private String remark; public void setUsername(String username) { this.username = username; } public void setPassword(String password) { this.password = password; } public void setTestBoolean(boolean testBoolean) { this.testBoolean = testBoolean; } public void setSelectArray(String[] selectArray) { this.selectArray = selectArray; } public void setTestArray(String[] testArray) { this.testArray = testArray; } public void setRadiobuttonId(Integer radiobuttonId) { this.radiobuttonId = radiobuttonId; } public void setSelectId(Integer selectId) { this.selectId = selectId; } public void setSelectIds(List<Integer> selectIds) { this.selectIds = selectIds; } public void setTestMap(Map<Integer, String> testMap) { this.testMap = testMap; } public void setRemark(String remark) { this.remark = remark; } public String getUsername() { return this.username; } public String getPassword() { return this.password; } public boolean getTestBoolean() { return this.testBoolean; } public String[] getSelectArray() { return this.selectArray; } public String[] getTestArray() { return this.testArray; } public Integer getRadiobuttonId() { return this.radiobuttonId; } public Integer getSelectId() { return this.selectId; } public List<Integer> getSelectIds() { return this.selectIds; } public Map<Integer, String> getTestMap() { return this.testMap; } public String getRemark() { return this.remark; } }
创建一个处理类
package com.demo.web.controllers; import java.util.Arrays; import java.util.HashMap; import java.util.Map; import org.springframework.stereotype.Controller; import org.springframework.ui.Model; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMethod; import com.demo.web.models.TagsModel; @Controller @RequestMapping(value = "/tags") public class TagsController { @RequestMapping(value = "/test", method = { RequestMethod.GET }) public String test(Model model) { if (!model.containsAttribute("contentModel")) { TagsModel tagsModel = new TagsModel(); tagsModel.setUsername("aaa"); tagsModel.setPassword("bbb"); tagsModel.setTestBoolean(true); tagsModel.setSelectArray(new String[] { "arrayItem 路人甲" }); tagsModel.setTestArray(new String[] { "arrayItem 路人甲", "arrayItem 路人乙", "arrayItem 路人丙" }); tagsModel.setRadiobuttonId(1); tagsModel.setSelectId(2); tagsModel.setSelectIds(Arrays.asList(1, 2)); Map<Integer, String> map = new HashMap<Integer, String>(); map.put(1, "mapItem 路人甲"); map.put(2, "mapItem 路人乙"); map.put(3, "mapItem 路人丙"); tagsModel.setTestMap(map); tagsModel.setRemark("备注..."); model.addAttribute("contentModel", tagsModel); } return "tagstest"; } }
编写一个结果页面tagstest.jsp
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <%@ taglib prefix="form" uri="http://www.springframework.org/tags/form"%> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> </head> <body> <form:form modelAttribute="contentModel" method="post"> input 标签:<form:input path="username" /> <br /> password 标签:<form:password path="password" /> <br /> 绑定boolean的checkbox 标签:<br /> <form:checkbox path="testBoolean" /> <br /> 绑定Array的checkbox 标签:<br /> <form:checkbox path="testArray" value="arrayItem 路人甲" />arrayItem 路人甲 <form:checkbox path="testArray" value="arrayItem 路人乙" />arrayItem 路人乙 <form:checkbox path="testArray" value="arrayItem 路人丙" />arrayItem 路人丙 <form:checkbox path="testArray" value="arrayItem 路人丁" />arrayItem 路人丁<br /> 绑定Array的checkboxs 标签:<br /> <form:checkboxes path="selectArray" items="${contentModel.testArray}" /> <br /> 绑定Map的checkboxs 标签:<br /> <form:checkboxes path="selectIds" items="${contentModel.testMap}" /> <br /> 绑定Integer的radiobutton 标签:<br /> <form:radiobutton path="radiobuttonId" value="0" />0 <form:radiobutton path="radiobuttonId" value="1" />1 <form:radiobutton path="radiobuttonId" value="2" />2<br /> 绑定Map的radiobuttons 标签:<br /> <form:radiobuttons path="selectId" items="${contentModel.testMap}" /> <br /> 绑定Map的select 标签:<br /> <form:select path="selectId" items="${contentModel.testMap}" /> <br /> 不绑定items数据直接在form:option添加的select 标签:<br /> <form:select path="selectId"> <option>请选择人员</option> <form:option value="1">路人甲</form:option> <form:option value="2">路人乙</form:option> <form:option value="3">路人丙</form:option> </form:select> <br /> 不绑定items数据直接在html的option添加的select 标签:<br /> <form:select path="selectId"> <option>请选择人员</option> <option value="1">路人甲</option> <option value="2">路人乙</option> <option value="3">路人丙</option> </form:select> <br /> 用form:option绑定items的select 标签:<br /> <form:select path="selectId"> <option />请选择人员 <form:options items="${contentModel.testMap}" /> </form:select> <br /> textarea 标签: <form:textarea path="remark" /> <br /> <input type="submit" value="Submit" /> </form:form> </body> </html>
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> </head> <body> <a href="tags/test">Test tags</a> </body> </html>
部署到Tomcat上,点击超链接,结果如下: