mybatis+spring的TODO小项目记录（七）上手spring mvc

早在本科期间十分流行的java web框架是SSH，即struts2、spring和hibernate。struts2是一个MVC框架，在web开发中作为控制器来帮助我们建立模型与视图的数据交互，而对于MVC框架来说，如今更加流行的是本篇的主角SpringMVC。看到这个名字也会知道它和spring是有关系的，其实springMVC是依赖于spring的。spring的两大核心是IOC（控制反转，也叫依赖注入DI）和AOP（面向切面编程）。hibernate是一个ORM（对象关系映射）框架，它将POJO与数据表建立映射关系，可以自动生成SQL语句并执行。在这个项目中使用的mybatis是另一个ORM框架，它主要着力于SQL与POJO之间的映射关系，因此可以进行更为细致的SQL优化。

本文介绍的是上述中的Spring MVC的配置过程。Spring MVC是一个基于DispatcherServlet的MVC框架，每一个request请求都是由DispatcherServlet负责转发给相应的Handler，然后再由Handler处理并返回相应的视图(View)和模型(Model)。

首先看一下目前的项目结构，如下图所示：

• src目录下有以下几个文件夹：
  
  • src/main/java
  • src/main/resources
  • src/test/java
• web目录是java web项目的文件夹，下面有：
  
  • WEB-INF，存放jsp页面和其他静态文件，该目录下的文件无法通过web直接访问到
  • index.jsp，可以直接通过web url访问到

pom.xml

现在我们需要使用spring mvc，因此首先需要导入所需的jar包。只需要在pom.xml文件中加入spring mvc的依赖，maven就可以将所需的以下包导入项目中：

• commons-logging
• spring-aop
• spring-beans
• spring-context
• spring-core
• spring-express
• spring-web
• spring-webmvc

添加依赖如下：

<!-- https://mvnrepository.com/artifact/org.springframework/spring-webmvc -->        <dependency>            <groupId>org.springframework</groupId>            <artifactId>spring-webmvc</artifactId>            <version>${spring-version}</version>        </dependency>

这里为了以后修改spring mvc版本方便，使用了参数的形式，spring-version可以在dependencies节点之前定义：

<properties>        <spring-version>4.3.7.RELEASE</spring-version></properties>

web.xml

由于是web项目，我们首先需要配置web.xml文件，粘贴如下：

<?xml version="1.0" encoding="UTF-8"?><web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"         version="3.1">    <display-name>TODO</display-name>    <servlet>        <!-- servlet-name定义的名称是dispatcher,这样spring会自动在WEB-INF下扫描dispatcher-servlet.xml文件 -->        <servlet-name>dispatcher</servlet-name>        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>        <!-- 此处我们也可以通过参数配置使spring不去扫描默认的dispatcher-servlet.xml，而是去扫描指定的applicationContext.xml -->        <!--<init-param>-->            <!--<param-name>contextConfigLocation</param-name>-->            <!--<param-value>classpath:applicationContext.xml</param-value>-->        <!--</init-param>-->        <load-on-startup>1</load-on-startup>    </servlet>    <servlet-mapping>        <servlet-name>dispatcher</servlet-name>        <url-pattern>/</url-pattern>    </servlet-mapping>    <filter>        <filter-name>encodingFilter</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>encodingFilter</filter-name>        <url-pattern>/*</url-pattern>    </filter-mapping>    <session-config>        <session-timeout>60</session-timeout>    </session-config>    <context-param>        <param-name>contextConfigLocation</param-name>        <param-value>classpath:applicationContext.xml</param-value>    </context-param>    <listener>        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>    </listener></web-app>

在servlet标签中我们定义了DispatcherServlet以及映射URL。该servlet通过servlet-name定义了名字dispatcher，默认情况下spring会自动到WEB-INF下扫描dispatcher-servlet.xml文件，这里我们也可以通过init-param中的contextConfigLocation指定配置文件，如类路径下的applicationContext.xml文件。

servlet标签内的load-on-startup元素是可选的，如果存在，则该servlet会在应用程序启动时装载并调用它的init方法，否则会在该servlet的第一次请求时加载。

contextLoaderListener指定了IOC容器初始化的方法，这里指向了类路径下的applicationContext.xml文件。使用applicationContext.xml文件时，需要在web.xml中添加listener，即org.springframework.web.context.ContextLoaderListener。

其实可以看到这里有两个contextConfigLocation，一个是applicationContext.xml，另一个是在servlet节点中的dispatcher-servlet.xml。这两个文件都可以进行spring的配置，至于两者的区别，我们查看spring的官方文档的说明：

    Spring lets you define multiple contexts in a parent-child hierarchy.    The applicationContext.xml defines the beans for the "root webapp context", i.e. the context associated with the webapp.    The spring-servlet.xml (or whatever else you call it) defines the beans for one servlet's app context. There can be many of these in a webapp, one per Spring servlet (e.g. spring1-servlet.xml for servlet spring1, spring2-servlet.xml for servlet spring2).    Beans in spring-servlet.xml can reference beans in applicationContext.xml, but not vice versa.    All Spring MVC controllers must go in the spring-servlet.xml context.    In most simple cases, the applicationContext.xml context is unnecessary. It is generally used to contain beans that are shared between all servlets in a webapp. If you only have one servlet, then there's not really much point, unless you have a specific use for it. 

可以看到applicationContext.xml不是必需的，它定义的是整个web应用的上下文，与其他xxx-servlet.xml是父子层级关系。xxx-servlet.xml定义了每个对应的servlet的上下文，所有的MVC控制器必需定义在xxx-servlet.xml中。

dispatcher-servlet.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: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-3.0.xsd       http://www.springframework.org/schema/context       http://www.springframework.org/schema/context/spring-context-3.0.xsd       http://www.springframework.org/schema/mvc       http://www.springframework.org/schema/mvc/spring-mvc.xsd"       default-lazy-init="true">    <!--启用注解驱动-->    <mvc:annotation-driven></mvc:annotation-driven>    <!-- 设置组件自动扫描，并指定包路径 -->    <context:component-scan base-package="com.loveqh.todo.controller"/>    <!-- 不采用上面的自动组件扫描的话，也可以手动设置bean -->    <!--<bean class="com.loveqh.todo.controller.LoginController"></bean>-->    <!-- 静态资源映射，所有的页面引用到/styles/**的资源都将从/static/css里面进行查找 -->    <mvc:resources mapping="/js/**" location="/WEB-INF/static/js/"/>    <mvc:resources mapping="/styles/**" location="/WEB-INF/static/css/"/>    <mvc:resources mapping="/images/**" location="/WEB-INF/static/img/"/>    <mvc:resources location="/WEB-INF/pages/" mapping="/pages/**"/>    <!-- 视图解析器,spring会自动在pages目录下寻找jsp文件 -->    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">        <property name="prefix" value="/WEB-INF/pages/"/>        <property name="suffix" value=".jsp"/>    </bean></beans>

applicationContext.xml

目前没有什么bean，因此是空的。

<?xml version="1.0" encoding="UTF-8"?><beans xmlns="http://www.springframework.org/schema/beans"       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"       xsi:schemaLocation="http://www.springframework.org/schema/beans       http://www.springframework.org/schema/beans/spring-beans-3.0.xsd"></beans>

Controller

接下来我们就可以定义第一个Controller，代码如下：

package com.loveqh.todo.controller;import org.springframework.stereotype.Controller;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.RequestMethod;/** * Created by WL on 2017-04-27. */@Controller@RequestMapping(value = "/user")public class LoginController {    @RequestMapping(value = "/login", method = RequestMethod.GET)    public String index() {        System.out.println("用户登录");        return "index";    }}

这样启动tomcat之后，访问http://localhost:8080/user/login时，DispatcherServlet会将请求转发到LoginController的index方法进行处理。index方法返回一个字符串“index”，根据上面的dispatcher-servlet.xml中的视图解析器定义的前缀和后缀，spring会返回/WEB-INF/pages/index.jsp页面。

在第一次尝试运行时，出现了报错，提示找不到jar包，错误如下：

org.apache.catalina.core.StandardContext listenerStart  严重: Error configuring application listener of class org.springframework.web.context.ContextLoaderListener  java.lang.ClassNotFoundException: org.springframework.web.context.ContextLoaderListener    at org.apache.catalina.loader.WebappClassLoaderBase.loadClass(WebappClassLoaderBase.java:1892)         

但是通过仔细检查，spring-context包已经通过maven成功导入了，仍然报错。后经查阅资料，需要将web部署所需的包都拷贝至out目录下的WEB-INF/lib中，将jar包复制过去之后，错误果然消失。

至此，SpringMVC配置大功告成！下一步，我们将使用SpringMVC完成项目的用户注册和登录功能。