SpringMVC的表单标签

一、SpringMVC对表单标签的支持
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>

编写index页面

<%@ 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上，点击超链接，结果如下：