Spring MVC 表单标签库

在进行 Spring MVC 项目开发时，一般会使用 EL 表达式和 JSTL 标签来完成页面视图的开发。其实 Spring 也有自己的一套表单标签库，通过 Spring 表单标签，可以很容易地将模型数据中的命令对象绑定到 HTML 表单元素中。下面我们就通过一个示例来演示该标签库的用法。

首先和 JSTL 标签的使用方法相同，在使用 Spring 表单标签之前，必须在 JSP 页面开头处声明 taglib 指令，指令代码如下。

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

常用的 Spring 表单标签如下表所示。

名称	作用
form	渲染表单元素
input	输入框组件标签，渲染 <input type="text"/> 元素
password	密码框组件标签，渲染 <input type="password"/> 元素
hidden	隐藏框组件标签，渲染 <input type="hidden"/> 元素
textarea	多行输入框组件标签，渲染 textarea 元素
checkbox	复选框组件标签，渲染一个 <input type="checkbox"/> 元素
checkboxes	渲染多个 <input type="checkbox"/> 元素
radiobutton	单选框组件标签，渲染一个 <input type="radio"/> 元素
radiobuttons	渲染多个 <input type="radio"/> 元素
select	下拉列表组件标签，渲染一个选择元素
option	渲染一个选项元素
options	渲染多个选项元素
errors	显示表单数据校验所对应的错误信息

以上标签基本都拥有以下属性。

path：属性路径，表示表单对象属性，如 userName、userCode 等。
cssClass：表单组件对应的 CSS 样式类名。
cssErrorClass：当提交表单后报错（服务端错误），采用的 CSS 样式类。
cssStyle：表单组件对应的 CSS 样式。
htmlEscape：绑定的表单属性值是否要对 HTML 特殊字符进行转换，默认为 true。

示例

下面以 <fm:form> 表单标签为例，模仿添加用户信息。

1. 创建实体类

创建实体类 user，代码如下。

package net.biancheng.po;

public class User {
    private String name;
    private Integer age;
    private Double height;
    
    /** 省略setter和getter方法*/
}

2. 创建页面

创建 addUser.jsp，代码如下。

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<%@ taglib prefix="fm" uri="http://www.springframework.org/tags/form"%>
<!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>添加用户</title>
</head>
<body>
    <fm:form method="post" modelAttribute="user" action="${pageContext.request.contextPath }/showuser">
        用户名：<fm:input path="name"/>
        <br />
        年龄：<fm:input path="age"/>
        <br />
        身高：<fm:input path="height"/>
        <br />
        <input type="submit" value="保存" />
    </fm:form>
</body>
</html>

<fm:form> 标签的 modelAttribute 属性用于指定绑定的模型属性。默认从模型中尝试取名为“command”的表单对象，若不存在此表单对象，将会报错。所以一般情况下会指定 modelAttribute 属性。

此外，表单组件标签页拥有 HTML 标签的各种属性，如 id、onclick 等，都可以根据需要灵活使用。

创建显示页面 showUser.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">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>用户信息</title>
</head>
<body>
    您创建的用户信息如下：
    <br />
    <!-- 使用EL表达式取出model中的user信息 -->
    用户名：${user.name }
    <br /> 年龄：${user.age }
    <br /> 身高：${user.height }
</body>
</html>

3. 创建控制器类

创建 UserController，代码如下。

package net.biancheng.controller;


import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpSession;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

import net.biancheng.po.User;

@Controller
public class UserController {

    @RequestMapping(value = "/addUser", method = RequestMethod.GET)
    public String add(@ModelAttribute("user") User user) {

        return "addUser";
    }

    @RequestMapping(value = "/showuser", method = RequestMethod.POST)
    public String showuser(User user, HttpSession session, HttpServletRequest request) {

        return "showUser";
    }
}