Spring MVC 表单标签库
声明表单标签库
在使用 SpringMVC 的时候我们可以使用 Spring 封装的一系列表单标签,这些标签都可以访问到 ModelMap
中的内容。我们需要先在 JSP 中声明使用的标签,具体做法是在 JSP 文件的顶部加入以下指令:
<%@ taglib prefix="form" uri="http://www.springframework.org/tags/form"%>
表单标签
<form:form />
使用 Spring MVC 的 form
标签主要有两个作用,第一是它会自动的绑定来自 Model 中的一个属性值到当前 form
对应的实体对象,默认是 command
属性,这样我们就可以在 form
表单体里面方便的使用该对象的属性了。第二是它支持我们在提交表单的时候使用除 GET 和 POST 之外的其他方法进行提交,包括 DELETE 和 PUT 等。
<form:form action="formTag/form.do" method="post">
<table>
<tr>
<td>Name:</td><td><form:input path="name"/></td>
</tr>
<tr>
<td>Age:</td><td><form:input path="age"/></td>
</tr>
<tr>
<td colspan="2"><input type="submit" value="提交"/></td>
</tr>
</table>
</form:form>
文本框
<form:input />
使用 <form:input path="name" />
标签来渲染一个 HTML 文本框,等同于:
<input id="name" name="name" type="text" value=""/>
密码框
<form:password />
使用 <form:password path="password" />
标签来渲染一个 HTML 密码框,等同于:
<input id="password" name="password" type="password" value=""/>
文本域
<form:textarea />
使用 <form:textarea path="address" rows="5" cols="30" />
标签来渲染一个 HTML 文本域,等同于:
<textarea id="address" name="address" rows="5" cols="30">
复选框
<form:checkbox />
使用 <form:checkbox path="receivePaper" />
标签来渲染一个 HTML 复选框,等同于:
<input id="receivePaper1" name="receivePaper" type="checkbox" value="true"/>
<input type="hidden" name="_receivePaper" value="on"/>
复选框(多选)
<form:checkboxes />
使用 <form:checkboxes items="${webFrameworkList}" path="favoriteFrameworks" />
标签来渲染一个 HTML 多选复选框,等同于:
<span>
<input id="favoriteFrameworks1" name="favoriteFrameworks" type="checkbox" value="Spring MVC" checked="checked"/>
<label for="favoriteFrameworks1">Spring MVC</label>
</span>
<span>
<input id="favoriteFrameworks2" name="favoriteFrameworks" type="checkbox" value="Struts 1"/>
<label for="favoriteFrameworks2">Struts 1</label>
</span>
<span>
<input id="favoriteFrameworks3" name="favoriteFrameworks" type="checkbox" value="Struts 2" checked="checked"/>
<label for="favoriteFrameworks3">Struts 2</label>
</span>
<span>
<input id="favoriteFrameworks4" name="favoriteFrameworks" type="checkbox" value="Apache Wicket"/>
<label for="favoriteFrameworks4">Apache Wicket</label>
</span>
<input type="hidden" name="_favoriteFrameworks" value="on"/>
单选按钮
<form:radiobutton />
使用 <form:radiobutton />
标签来渲染一个 HTML 单选按钮,等同于:
<form:radiobutton path="gender" value="M" label="男" />
<form:radiobutton path="gender" value="F" label="女" />
<input id="gender1" name="gender" type="radio" value="M" checked="checked"/><label for="gender1">男</label>
<input id="gender2" name="gender" type="radio" value="F"/><label for="gender2">女</label>
单选按钮(多选)
<form:radiobuttons />
使用 <form:radiobuttons path="favoriteNumber" items="${numbersList}" />
标签来渲染一个 HTML 多项单选按钮,等同于:
<span>
<input id="favoriteNumber1" name="favoriteNumber" type="radio" value="1"/>
<label for="favoriteNumber1">1</label>
</span>
<span>
<input id="favoriteNumber2" name="favoriteNumber" type="radio" value="2"/>
<label for="favoriteNumber2">2</label>
</span>
<span>
<input id="favoriteNumber3" name="favoriteNumber" type="radio" value="3"/>
<label for="favoriteNumber3">3</label>
</span>
<span>
<input id="favoriteNumber4" name="favoriteNumber" type="radio" value="4"/>
<label for="favoriteNumber4">4</label>
</span>
下拉列表
使用 <form:select />
, <form:option />
,<form:options />
标签来渲染一个 HTML 下拉列表,等同于:
<form:select path="country">
<form:option value="NONE" label="Select"/>
<form:options items="${countryList}" />
</form:select>
<select id="country" name="country">
<option value="NONE">请选择...</option>
<option value="US">United States</option>
<option value="CH">China</option>
<option value="MY">Malaysia</option>
<option value="SG">Singapore</option>
</select>
下拉列表(多选)
使用 <form:select />
标签及其属性 multiple=true
来渲染一个 HTML 多选下拉列表,等同于:
<form:select path="skills" items="${skillsList}" multiple="true" />
<select id="skills" name="skills" multiple="multiple">
<option value="Struts">Struts</option>
<option value="Hibernate">Hibernate</option>
<option value="Apache Wicket">Apache Hadoop</option>
<option value="Spring">Spring</option>
</select>
<input type="hidden" name="_skills" value="1"/>
隐藏字段域
<form:hidden />
使用 <form:hidden path="id" value="1000"/>
标签来渲染一个 HTML 隐藏字段域,等同于:
<input id="id" name="id" type="hidden" value="1000"/>
Spring MVC @ModelAttribute
简介
@ModelAttribute
具有如下三个作用:
- 绑定请求参数到命令对象:放在功能处理方法的入参上时,用于将多个请求参数绑定到一个命令对象,从而简化绑定流程,而且自动暴露为模型数据用于视图页面展示时使用
- 暴露
@RequestMapping
方法返回值为模型数据:放在功能处理方法的返回值上时,是暴露功能处理方法的返回值为模型数据,用于视图页面展示时使用 - 暴露表单引用对象为模型数据:放在处理器的一般方法(非功能处理方法)上时,是为表单准备要展示的表单引用对象,如注册时需要选择的所在城市等,而且在执行功能处理方法(
@RequestMapping
注解的方法)之前,自动添加到模型对象中,用于视图页面展示时使用
例子
暴露表单引用对象为模型数据的例子
@ModelAttribute
public User get(@RequestParam(required = false) String id) {
User entity = null;
if (StringUtils.isNotBlank(id)) {
entity = userService.get(id);
}
if (entity == null) {
entity = new User();
}
return entity;
}
实现表单内容提交错误后返回表单时原先内容还在
如图:
思路:
其实就是在提交之后,判断格式不是不正确嘛,要回到这个提交的页面时,把封装的tbUser放入model里边带回来,在表单里写上对应的value就好了。
表单:
<form:form action="/saveUser" method="post" modelAttribute="tbUser">
<form:hidden path="id" />
<form:input path="email" placeholder="邮箱"/>
<form:password path="password" placeholder="密码"/>
<form:input path="username" placeholder="用户名"/>
<form:input path="phone" placeholder="手机号"/>
<button type="submit" class="btn btn-default">取消</button>
<button type="submit" class="btn btn-info pull-right">保存</button>
</form:form>
其实,也没什么高级的,就是 使用modelAttribute绑定了model中的tbUser,然后每个标签里的path就相当于指定了tbUser里的某个属性;等价于:
<form action="/saveUser" method="post" >
<input type="password" id="password" class="form-control" placeholder="密码" value="${tbUser.password}">
</form:form>
在对应的controller里边:
@ModelAttribute
public TbUser get(){
TbUser tbUser=new TbUser();
return tbUser;
}
这个函数在所有的@RequestMapping注解的函数之前都会执行一次,在这里把tbUser放入model,减少代码量。