数据绑定是将用户输入绑定到领域模型的一种特性。Spring MVC 会根据请求方法不同,将请求消息绑定到处理方法的参数中。
给个简单的例子:
环境
- JDK1.7
- Tomcat 7
- Spring 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
:
填写注册信息后点击注册按钮:
跳转至成功页面,显示用户的基本信息: