Spring MVC 数据绑定

数据绑定是将用户输入绑定到领域模型的一种特性。Spring MVC 会根据请求方法不同，将请求消息绑定到处理方法的参数中。

给个简单的例子：

环境

JDK1.7Tomcat 7Spring MVC 4.2.0 RELEASE

注：Spring MVC 相关 jar 包我已经上传到 这里 ，包括 Spring 的全部 jar、commons 相关 jar 和 Hibernate-Validator 的相关 jar。

项目结构

1 新建项目工程

（1）首先在 Eclipse 里新建一个动态 Web 工程（Dynamic Web Project），命名为 BindTest ，并自动生成 web.xml。 （2）将前面下载的 jar 包拷贝到工程的 WebContent/WEB-INF/lib/ 目录下。

2 配置 web.xml 文件

修改 web.xml 文件内容如下：

<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" id="WebApp_ID" version="3.0"> <display-name>BindTest</display-name> <!-- 配置 Spring MVC DispatchcerServlet 前端控制器 --> <servlet> <servlet-name>springmvc</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>contextConfigLocation</param-name> <param-value>/WEB-INF/springmvc-config.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <!-- Servlet 映射声明 --> <servlet-mapping> <servlet-name>springmvc</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping> <!-- 避免中文乱码 --> <filter> <filter-name>characterEncodingFilter</filter-name> <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class> <init-param> <param-name>encoding</param-name> <param-value>UTF-8</param-value> </init-param> <init-param> <param-name>forceEncoding</param-name> <param-value>true</param-value> </init-param> </filter> <filter-mapping> <filter-name>characterEncodingFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> </web-app>

3 springmvc-config.xml 文件

在 WebContent/WEB-INF/ 目录下新建 Spring MVC 配置文件 springmvc-config.xml，添加如下代码：

<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p="http://www.springframework.org/schema/p" xmlns:mvc="http://www.springframework.org/schema/mvc" xmlns:context="http://www.springframework.org/schema/context" xmlns:aop="http://www.springframework.org/schema/aop" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.2.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.2.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.2.xsd http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-4.2.xsd"> <context:component-scan base-package="gler.bind.controller" /> <mvc:annotation-driven /> <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="prefix" value="/WEB-INF/views/" /> <property name="suffix" value=".jsp" /> </bean> </beans>

<mvc:annotation-driven /> 标签可以简化 Spring MVC 的相关配置，会自动注册 DefaultAnnotationHandlerMapping 与 AnnotationMethodHandlerAdapter 两个 bean，并提供了：数据绑定支持，@NumberFormatannotation 支持，@DateTimeFormat 支持，@Valid 支持，读写 XML 的支持（JAXB），读写 JSON 的支持（Jackson）。

4 实体类

在项目目录 Java Resources/src 的包 gler.bind.entity 下新建类 User.java，包含 username、password、age、phone 和 email 属性，代码如下：

package gler.bind.entity; public class User { private String username; private String password; private Integer age; private String phone; private String email; public String getUsername() { return username; } public void setUsername(String username) { this.username = username; } public String getPassword() { return password; } public void setPassword(String password) { this.password = password; } public Integer getAge() { return age; } public void setAge(Integer age) { this.age = age; } public String getPhone() { return phone; } public void setPhone(String phone) { this.phone = phone; } public String getEmail() { return email; } public void setEmail(String email) { this.email = email; } }

5 Controller 类的实现

在包 gler.bind.controller 下新建 Controller 类 UserController.java，代码如下：

package gler.bind.controller; import org.springframework.stereotype.Controller; import org.springframework.ui.Model; import org.springframework.web.bind.annotation.ModelAttribute; import org.springframework.web.bind.annotation.RequestMapping; import gler.bind.entity.User; @Controller public class UserController { // 进入注册页面 @RequestMapping(value = "/registerform") public String registerform(Model model) { model.addAttribute("user", new User()); return "register"; } // 注册请求的响应方法 @RequestMapping(value = "/register") public String register(@ModelAttribute("user") User user, Model model) { model.addAttribute("user", user); return "success"; } }

6 JSP 页面

（1）register.jsp

在 WebContent/WEB-INF 目录下新建文件夹 views，并在该路径下新建一个 JSP 页面命名为 register.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>注册页面</title> </head> <body> <div id="global"> <form:form modelAttribute="user" method="post" action="register"> <fieldset> <legend>注册</legend> <p> <label>用户名:</label> <form:input path="username" /> </p> <p> <label>密 码:</label> <form:password path="password" /> </p> <p> <label>年 龄:</label> <form:input path="age" /> </p> <p> <label>电 话:</label> <form:input path="phone" /> </p> <p> <label>邮 箱:</label> <form:input path="email" /> </p> <p id="buttons"> <input id="submit" type="submit" value="注册"> <input id="reset" type="reset" value="重置"> </p> </fieldset> </form:form> </div> </body> </html>

由于使用了 Spring MVC 的表单标签库，所以应该在 JSP 页面开头处加入 <%@ taglib prefix="form" uri="http://www.springframework.org/tags/form"%> 声明一下 taglib 指令。

form 表单中的 modelAttribute="user" 绑定了一个 JavaBean 对象。

（2）success.jsp

在 WebContent/WEB-INF/views 目录下新建一个 JSP 页面命名为 success.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>Insert title here</title> </head> <body> <h5>注册成功，个人信息如下：</h5> 用户名：${user.username} <br />密 码：${user.password} <br />年 龄：${user.age} <br />电 话：${user.phone} <br />邮 箱：${user.email} <br /> </body> </html>

7 运行测试

在 Tomcat 上运行 BindTest，打开浏览器输入 URL http://localhost:8080/BindTest/registerform：

填写注册信息后点击注册按钮：

跳转至成功页面，显示用户的基本信息：