Spring MVC 入门

在了解了 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 是一个基于注解的控制器 * 可以同时处理多个请求动作 */@Controllerpublic 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 企业应用实战》