在了解了 Spring MVC 的一些基本概念后,通过查阅资料动手搭建了 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),命名为 SpringMVCTest
,并自动生成 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>SpringMVCTest</display-name>
<!-- 配置 Spring MVC DispatchcerServlet 前端控制器 -->
<servlet>
<servlet-name>springmvc</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<!-- contextConfigLocation 是参数名称,该参数的值包含 Spring MVC 的配置文件路径 -->
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/springmvc-config.xml</param-value>
</init-param>
<!-- 在 Web 应用启动时立即加载 Servlet -->
<load-on-startup>1</load-on-startup>
</servlet>
<!-- Servlet 映射声明 -->
<servlet-mapping>
<servlet-name>springmvc</servlet-name>
<!-- 监听当前域的所有请求 -->
<url-pattern>/</url-pattern>
</servlet-mapping>
<!-- 添加 register.jsp 为首页 -->
<welcome-file-list>
<welcome-file>register.jsp</welcome-file>
</welcome-file-list>
</web-app>
在 web.xml 中配置了 DispatchcerServlet
,DispatchcerServlet 加载时需要一个 Spring MVC 的配置文件,默认会去 WEB-INF
下查找对应的 [servlet-name]-servlet.xml
文件,如本例中默认查找的是 springmvc-servlet.xml
。
Spring MVC 的配置文件可以放在任何地方,用 servlet 的子元素 init-param
描述即可,见上述示例代码,这时 DispatchcerServlet 就会去查找 /WEB-INF/springmvc-config.xml
。
3 springmvc-config.xml 文件
在 WebContent/WEB-INF/
目录下新建 Spring MVC 配置文件 springmvc-config.xml
,配置 Spring MVC 的 Controller,添加如下代码:
<?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:context="http://www.springframework.org/schema/context"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-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/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.2.xsd">
<context:annotation-config />
<!-- 配置自动扫描的包,完成 Bean 的创建和自动依赖注入的功能 -->
<context:component-scan base-package="gler.springmvc.controller" />
<!-- 这两个类用来配置 annotation 类型的处理器映射器和处理器适配器 -->
<bean class="org.springframework.web.servlet.mvc.annotation.DefaultAnnotationHandlerMapping" />
<bean class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter" />
<!-- 配置视图解析器 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/views/"></property>
<property name="suffix" value=".jsp"></property>
</bean>
</beans>
上述配置文件中, Spring 使用了扫描机制查找应用程序所有基于注解的控制器类,在本例中,扫描的是 gler.springmvc.controller
包及其子包下的所有 Java 文件。
同时配置了 annatation 类型的处理器映射器 DefaultAnnotationHandlerMapping 和处理器适配器 AnnotationMethodHandlerAdapter,DefaultAnnotationHandlerMapping 根据请求查找映射,AnnotationMethodHandlerAdapter 完成对控制器类的 @RequestMapping 标注方法(下面会介绍)的调用。
最后配置的视图解析器 InternalResourceViewResolver 用来解析视图,将 View 呈现给用户。视图解析器中配置的 prefix
表示视图的前缀, suffix
表示视图的后缀。
注:在 Spring4.0 之后,如果不配置处理映射器、处理器适配器和视图解析器,会使用默认的。
4 实体类 User
在项目目录 Java Resources/src
的包 gler.springmvc.entity
下新建类 User.java
,包含 id、username、password 和 age 属性,代码如下:
package gler.springmvc.entity;
import java.io.Serializable;
public class User implements Serializable {
private static final long serialVersionUID = 1L;
private Integer id;
private String username;
private String password;
private Integer age;
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
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;
}
}
5 Controller 类的实现
在包 gler.springmvc.controller
下新建 Controller 类 UserController.java
,具体解释注释已经给出,代码如下:
package gler.springmvc.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.springmvc.entity.User;
/**
* UserController 是一个基于注解的控制器
* 可以同时处理多个请求动作
*/
@Controller
public class UserController {
/**
* RequestMapping 用来映射一个请求和请求的方法
* value="/register" 表示请求由 register 方法进行处理
*/
@RequestMapping(value="/register")
public String Register(@ModelAttribute("form") User user, Model model) { // user:视图层传给控制层的表单对象;model:控制层返回给视图层的对象
// 在 model 中添加一个名为 "user" 的 user 对象
model.addAttribute("user", user);
// 返回一个字符串 " success" 作为视图名称
return "success";
}
}
6 JSP 页面
(1)register.jsp
在 WebContent
目录下新建一个 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">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>用户注册</title>
</head>
<body>
<form action="register" method="post">
<h5>用户注册</h5>
<p>
<label>用户名</label> <input type="text" id="username" name="username"
tabindex="1">
</p>
<p>
<label>密 码</label> <input type="text" id="password" name="password"
tabindex="2">
</p>
<p>
<label>年 龄</label> <input type="text" id="age" name="age"
tabindex="3">
</p>
<p id="buttons">
<input id="submit" type="submit" tabindex="4" value="注册">
<input id="reset" type="reset" tabindex="5" value="取消">
</p>
</form>
</body>
</html>
(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>成功页面</title>
</head>
<body>
<h5>注册成功</h5>
<p>
用户名:${requestScope.user.username}<br /> 密码:${requestScope.user.password}<br /> 年龄:${requestScope.user.age}<br />
</p>
</body>
</html>
7 运行测试
在 Tomcat 上运行 SpringMVCTest:
输入注册信息,点击注册按钮,结果如下:
参考链接
- Spring MVC原理及配置详解
- 《Spring+MyBatis 企业应用实战》